Skip to main content
POST /company-search finds companies from Huntr’s index using structured filters. Combine industry, location, headcount, domain, keywords, and more. Use this when you need many accounts — not a narrative research brief.

​
Preview list size (free)

Before spending credits on results, preview the match count:
price is always 0 on count endpoints.

​
Search companies

Response shape:

​
Pagination

Huntr returns one page per request (default 100, max 200). To walk a large list:
  1. Call with your query and pagination.size
  2. Read pagination.token from the response
  3. Call again with the same query and pagination: { "size": 100, "token": "..." }
Do not change the query between pages. Tokens expire.

​
Filter rules

  • At least one filter is required
  • Fields are AND’d together
  • include values within a field are OR’d
  • industry and type must be exact LinkedIn labels — invalid values return 400 with accepted_values

​
Prefer domain over name

When you know stripe.com, use domain — not name — to avoid fuzzy collisions.

​
Headcount and revenue

Use comparison operators (>, <, >=, <=), not min/max:

​
Typical workflow

  1. Count → search → paginate companies
  2. For each target account, find people with currentCompanyWebsite
  3. Enrich contacts you want to reach

​
Pricing

Charged per company returned in the response. Empty pages cost $0. See GET /pricing for the current per-result rate.

​
Next step