Hunter — Discover (POST)
hunter_post_v2_discoverFind companies matching a structured filter set. This operation is free. Uses the caller's OpenAny gateway credentials. Charges and authorization are determined by the gateway.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Number of companies to return. Every plan can request up to 100 companies. | |
| query | No | Search query, in your natural language. For example, "Companies in Europe in the Tech Industry". | |
| offset | No | Number of companies to skip. Only plans with Discover paging can set an offset above 0. | |
| funding | No | You can provide a list of funding series in the series field to narrow down your selection of companies. The possible values are pre_seed, seed, pre_series_a, series_a, pre_series_b, series_b, pre_series_c, series_c+ or other You can also specify a range of funding amounts in the amount field, you can specify a from and/or to value Finally you can also specify a range of funding dates in the date field, here you can also specify a from and/or to value in YYYY-MM-DD format. Both dates are inclusive; omitting a bound leaves that side of the range open. Applied dates, including those resolved from a natural-language query, are returned in meta.filters.funding.date and can be reused for pagination. This filter is only available on a Premium plan. | |
| industry | No | Industry names to include or exclude. | |
| keywords | No | Keywords to narrow down your selection of companies. You can specify a list of keywords in the include field to select on and/or a list in the exclude field to exclude from the results. You can specify to match on any or all keywords in the match field (the default value is all). | |
| headcount | No | The company sizes you want to include in the results. The possible values are 1-10, 11-50, 51-200, 201-500, 501-1000, 1001-5000, 5001-10000 or 10001+. The company size is the range the company reports publicly. We raise it when our data clearly shows a larger company. The emails_count in the results counts the email addresses we found for the domain. It is not the number of employees. | |
| similar_to | No | You can either specify a domain or a name of a company to find similar companies for. If you specify both then the domain will be used. This filter is only available on a Premium plan. | |
| technology | No | Technology slugs to include or exclude. | |
| company_type | No | Hunter company types to include or exclude. | |
| job_openings | No | Filter companies by LinkedIn job openings. Department values come from the jobs-index vocabulary (not a frozen enum). Unknown departments return 400. | |
| organization | No | You can specify a list of domains in the domain field to select on and/or a list of company names in the name field to select on. When you supply both, the API will combine the results into a set of domain names. | |
| year_founded | No | The years in which the companies were founded, for example "2010". You can specify either multiple years to include and/or exclude or you can specify a range by giving a value for from and/or to. This filter is only available on a Premium plan. | |
| headquarters_location | No | Locations of the headquarters of the companies you want to find. You can specify lists of locations in the include field to select on and/or in the exclude field to exclude. Each location can have either a continent or business_region or country, state and/or city. continent can be one of the following: Europe, Asia, North America, Africa, Antarctica, South America or Oceania business_region can be one of the following: AMER, EMEA, APAC or LATAM country must contain a valid ISO 3166-1 alpha-2 country code, for example "US" for the United States. state must contain a valid US state code, for example "CA" for California. You can only use this field when the country is set to "US". city must contain a city name, for example "San Francisco". Please note that when a city is provided, a country must also be specified: { "headquarters_location": { "include": [ { "city": "Paris", "country": "FR" } ] } } |