search_companies

{
  "name": "search_companies",
  "title": "Search companies",
  "annotations": {
    "title": "Search companies",
    "readOnlyHint": true,
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": false
  },
  "inputSchema": {
    "type": "object",
    "properties": {
      "websiteId": {
        "type": "string",
        "description": "Website ID from list_websites. The search runs under this website."
      },
      "query": {
        "type": "object",
        "description": "Search filters as one flat object. Every field is optional; combine them to narrow the search.",
        "properties": {
          "keywords": {
            "type": "string",
            "description": "Company name or domain keyword, e.g. \"acme\" or \"acme.example\"."
          },
          "industries": {
            "type": "array",
            "items": {
              "type": "string",
              "enum": [
                "Accounting",
                "Airlines/Aviation",
                "Alternative Dispute Resolution",
                "Alternative Medicine",
                "Animation",
                "Apparel & Fashion",
                "Architecture & Planning",
                "Artists and Writers",
                "Arts and Crafts",
                "Automotive",
                "Aviation & Aerospace",
                "Banking",
                "Biotechnology",
                "Broadcast Media",
                "Building Materials",
                "Business Consulting and Services",
                "Business Supplies and Equipment",
                "Capital Markets",
                "Chemicals",
                "Civic & Social Organization",
                "Civil Engineering",
                "Commercial Real Estate",
                "Computer & Network Security",
                "Computer Games",
                "Computer Hardware",
                "Computer Networking",
                "Computer Software",
                "Construction",
                "Consumer Electronics",
                "Consumer Goods",
                "Consumer Services",
                "Cosmetics",
                "Dairy",
                "Defense & Space",
                "Design",
                "Education Management",
                "eCommerce",
                "E-Learning",
                "Electrical/Electronic Manufacturing",
                "Entertainment",
                "Environmental Services",
                "Events Services",
                "Executive Office",
                "Facilities Services",
                "Farming",
                "Financial Services",
                "Fine Art",
                "Fishery",
                "Food & Beverages",
                "Food Production",
                "Fund-Raising",
                "Furniture",
                "Gambling & Casinos",
                "Glass, Ceramics & Concrete",
                "Government Administration",
                "Government Relations",
                "Graphic Design",
                "Health, Wellness and Fitness",
                "Higher Education",
                "Hospital & Health Care",
                "Hospitality",
                "Human Resources",
                "Import and Export",
                "Individual & Family Services",
                "Industrial Automation",
                "Information Services",
                "Information Technology and Services",
                "Insurance",
                "International Affairs",
                "International Trade and Development",
                "Internet",
                "Internet Marketplace Platforms",
                "Investment Banking",
                "Investment Management",
                "Judiciary",
                "Law Enforcement",
                "Law Practice",
                "Legal Services",
                "Legislative Office",
                "Leisure, Travel & Tourism",
                "Libraries",
                "Logistics and Supply Chain",
                "Luxury Goods & Jewelry",
                "Machinery",
                "Management Consulting",
                "Maritime",
                "Marketing and Advertising",
                "Market Research",
                "Mechanical or Industrial Engineering",
                "Media Production",
                "Medical Devices",
                "Medical Practice",
                "Mental Health Care",
                "Military",
                "Mining & Metals",
                "Mobile Games",
                "Motion Pictures and Film",
                "Museums and Institutions",
                "Music",
                "Nanotechnology",
                "Newspapers",
                "Nonprofit Organization Management",
                "Oil & Energy",
                "Online Media",
                "Other",
                "Outsourcing/Offshoring",
                "Package/Freight Delivery",
                "Packaging and Containers",
                "Paper & Forest Products",
                "Performing Arts",
                "Pharmaceuticals",
                "Philanthropy",
                "Photography",
                "Plastics",
                "Political Organization",
                "Primary/Secondary Education",
                "Printing",
                "Professional Training & Coaching",
                "Program Development",
                "Public Policy",
                "Public Relations and Communications",
                "Public Safety",
                "Publishing",
                "Railroad Manufacture",
                "Ranching",
                "Real Estate",
                "Recreational Facilities and Services",
                "Religious Institutions",
                "Renewables & Environment",
                "Research",
                "Restaurants",
                "Retail",
                "SaaS",
                "Security and Investigations",
                "Semiconductors",
                "Shipbuilding",
                "Sporting Goods",
                "Sports",
                "Staffing and Recruiting",
                "Supermarkets",
                "Telecommunications",
                "Textiles",
                "Think Tanks",
                "Tobacco",
                "Translation and Localization",
                "Transportation/Trucking/Railroad",
                "Utilities",
                "Venture Capital & Private Equity",
                "Veterinary",
                "Warehousing",
                "Wholesale",
                "Wine and Spirits",
                "Wireless",
                "Writing and Editing"
              ]
            },
            "description": "Industries to match (any of them). Only the values in the accepted list work; anything else is refused."
          },
          "locations": {
            "type": "array",
            "items": {
              "type": "string",
              "enum": [
                "Afghanistan",
                "Åland Islands",
                "Albania",
                "Algeria",
                "American Samoa",
                "Andorra",
                "Angola",
                "Anguilla",
                "Antarctica",
                "Antigua and Barbuda",
                "Argentina",
                "Armenia",
                "Aruba",
                "Australia",
                "Austria",
                "Azerbaijan",
                "The Bahamas",
                "Bahrain",
                "Bangladesh",
                "Barbados",
                "Belarus",
                "Belgium",
                "Belize",
                "Benin",
                "Bermuda",
                "Bhutan",
                "Bolivia",
                "Bosnia and Herzegovina",
                "Botswana",
                "Bouvet Island",
                "Brazil",
                "British Indian Ocean Territory",
                "Brunei",
                "Bulgaria",
                "Burkina Faso",
                "Burundi",
                "Cambodia",
                "Cameroon",
                "Canada",
                "Cape Verde",
                "Cayman Islands",
                "Central African Republic",
                "Chad",
                "Chile",
                "China",
                "Christmas Island",
                "Cocos (Keeling) Islands",
                "Colombia",
                "Comoros",
                "Republic of the Congo",
                "Cook Islands",
                "Costa Rica",
                "Cote d'Ivoire",
                "Croatia",
                "Cuba",
                "Cyprus",
                "Czechia",
                "Denmark",
                "Djibouti",
                "Dominica",
                "Dominican Republic",
                "Ecuador",
                "Egypt",
                "El Salvador",
                "Equatorial Guinea",
                "Eritrea",
                "Estonia",
                "Ethiopia",
                "Falkland Islands (Islas Malvinas)",
                "Faroe Islands",
                "Fiji",
                "Finland",
                "France",
                "French Guiana",
                "French Polynesia",
                "French Southern and Antarctic Lands",
                "Gabon",
                "The Gambia",
                "Georgia",
                "Germany",
                "Ghana",
                "Gibraltar",
                "Greece",
                "Greenland",
                "Grenada",
                "Guadeloupe",
                "Guam",
                "Guatemala",
                "Guernsey",
                "Guinea",
                "Guinea-Bissau",
                "Guyana",
                "Haiti",
                "Heard Island and McDonald Islands",
                "Holy See (Vatican City)",
                "Honduras",
                "Hong Kong",
                "Hungary",
                "Iceland",
                "India",
                "Indonesia",
                "Iran",
                "Iraq",
                "Ireland",
                "Isle of Man",
                "Israel",
                "Italy",
                "Jamaica",
                "Japan",
                "Jersey",
                "Jordan",
                "Kazakhstan",
                "Kenya",
                "Kiribati",
                "North Korea",
                "South Korea",
                "Kuwait",
                "Kyrgyzstan",
                "Laos",
                "Latvia",
                "Lebanon",
                "Lesotho",
                "Liberia",
                "Libya",
                "Liechtenstein",
                "Lithuania",
                "Luxembourg",
                "Macau",
                "North Macedonia",
                "Madagascar",
                "Malawi",
                "Malaysia",
                "Maldives",
                "Mali",
                "Malta",
                "Marshall Islands",
                "Martinique",
                "Mauritania",
                "Mauritius",
                "Mayotte",
                "Mexico",
                "Federated States of Micronesia",
                "Moldova",
                "Monaco",
                "Mongolia",
                "Montserrat",
                "Morocco",
                "Mozambique",
                "Myanmar (Burma)",
                "Namibia",
                "Nauru",
                "Nepal",
                "Netherlands",
                "Netherlands Antilles",
                "New Caledonia",
                "New Zealand",
                "Nicaragua",
                "Niger",
                "Nigeria",
                "Niue",
                "Norfolk Island",
                "Northern Mariana Islands",
                "Norway",
                "Oman",
                "Pakistan",
                "Palau",
                "Palestinian Territory",
                "Panama",
                "Papua New Guinea",
                "Paraguay",
                "Peru",
                "Philippines",
                "Pitcairn Islands",
                "Poland",
                "Portugal",
                "Puerto Rico",
                "Qatar",
                "Reunion",
                "Romania",
                "Russia",
                "Rwanda",
                "Saint Helena",
                "Saint Kitts and Nevis",
                "Saint Lucia",
                "Saint Pierre and Miquelon",
                "Saint Vincent and the Grenadines",
                "Western Samoa",
                "San Marino",
                "Sao Tome and Principe",
                "Saudi Arabia",
                "Senegal",
                "Montenegro",
                "Serbia",
                "Seychelles",
                "Sierra Leone",
                "Singapore",
                "Slovakia",
                "Slovenia",
                "Solomon Islands",
                "Somalia",
                "South Africa",
                "South Georgia and the South Sandwich Islands",
                "Spain",
                "Sri Lanka",
                "Sudan",
                "Suriname",
                "Svalbard",
                "Eswatini",
                "Sweden",
                "Switzerland",
                "Syria",
                "Taiwan",
                "Tajikistan",
                "Tanzania",
                "Thailand",
                "Timor-Leste",
                "Togo",
                "Tokelau",
                "Tonga",
                "Trinidad and Tobago",
                "Tunisia",
                "Turkey",
                "Turkmenistan",
                "Turks and Caicos Islands",
                "Tuvalu",
                "Uganda",
                "Ukraine",
                "United Arab Emirates",
                "United Kingdom",
                "United States",
                "United States Minor Outlying Islands",
                "Uruguay",
                "Uzbekistan",
                "Vanuatu",
                "Venezuela",
                "Vietnam",
                "British Virgin Islands",
                "Virgin Islands",
                "Wallis and Futuna",
                "Western Sahara",
                "Yemen",
                "Zambia",
                "Zimbabwe",
                "Africa",
                "Asia",
                "Europe",
                "North America",
                "Oceania",
                "South America"
              ]
            },
            "description": "Company HQ countries by full English name, or a continent (Africa, Asia, Europe, North America, Oceania, South America) for all its countries. Only the values in the accepted list work, spelled exactly (\"Germany\", not \"germany\" or \"DE\")."
          },
          "employeesMin": {
            "type": "integer",
            "minimum": 1,
            "description": "Minimum headcount (whole number, at least 1). Applied to the real employee count."
          },
          "employeesMax": {
            "type": "integer",
            "minimum": 1,
            "description": "Maximum headcount (whole number, at least 1). Applied to the real employee count."
          },
          "revenueMin": {
            "type": "number",
            "minimum": 0,
            "description": "Minimum annual revenue in US dollars (0 or more). Defaults to 0."
          },
          "revenueMax": {
            "type": "number",
            "minimum": 0,
            "description": "Maximum annual revenue in US dollars (0 or more)."
          },
          "technologies": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Technologies the company uses, by product name. Case-sensitive: \"Hubspot\" and \"Shopify\" match, \"hubspot\" returns nothing. With this filter, total is the unfiltered count."
          },
          "page": {
            "type": "integer",
            "minimum": 1,
            "default": 1,
            "description": "Page number, whole number from 1. Default 1."
          },
          "count": {
            "type": "integer",
            "minimum": 1,
            "default": 25,
            "description": "Results per page, whole number from 1. Default 25."
          }
        }
      }
    },
    "required": [
      "websiteId",
      "query"
    ]
  }
}