curl --request POST \
  --url https://api.tryhuntr.com/company-search \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "query": {
    "industry": {
      "include": [
        "Software Development"
      ]
    },
    "headcount": {
      ">": 50
    },
    "location": {
      "include": [
        "US"
      ]
    }
  },
  "pagination": {
    "size": 10
  }
}
'

{
  "success": true,
  "request_id": "req_1746123456_cs1x2y",
  "companies": [
    {
      "name": "Stripe",
      "linkedin_slug": "stripe",
      "linkedin_url": "https://www.linkedin.com/company/stripe/",
      "website": "https://stripe.com",
      "description": "Financial infrastructure for the internet.",
      "headquarters": "San Francisco, California, United States",
      "employee_count": 8000,
      "industry": "Software Development",
      "organization_type": "Privately Held",
      "specialities": [
        "Payments",
        "API"
      ]
    }
  ],
  "total": 845,
  "pagination": {
    "token": "eyJ...",
    "size": 1
  },
  "price": 0.0003,
  "credits_remaining": 4.9997
}

List building

Search 65M companies by industry, location, headcount, and more

Requires x-api-key header.

Rate limit: 5 requests/second per API key.

Search 65M+ companies using structured filters. Each query field documents how values are matched — expand the schema below.

One page per request: Each call returns at most pagination.size companies (default 100, max 200). Huntr does not auto-fetch additional pages. To walk a large result set, loop: call → read pagination.token → call again with the same query and pagination: { size, token }.

Response fields: total = matches for the whole query (e.g. 1,019,864). companies = rows in this page only. pagination = upstream cursor when more pages exist.

Filter logic: include values within a field are OR’d; different fields are AND’d. industry / type must be exact labels (400 + accepted_values if not).

Use POST /company-search-count to preview total for free.

Price: $0.0003 per company returned. Free when companies is empty.

POST

company-search

curl --request POST \
  --url https://api.tryhuntr.com/company-search \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "query": {
    "industry": {
      "include": [
        "Software Development"
      ]
    },
    "headcount": {
      ">": 50
    },
    "location": {
      "include": [
        "US"
      ]
    }
  },
  "pagination": {
    "size": 10
  }
}
'

{
  "success": true,
  "request_id": "req_1746123456_cs1x2y",
  "companies": [
    {
      "name": "Stripe",
      "linkedin_slug": "stripe",
      "linkedin_url": "https://www.linkedin.com/company/stripe/",
      "website": "https://stripe.com",
      "description": "Financial infrastructure for the internet.",
      "headquarters": "San Francisco, California, United States",
      "employee_count": 8000,
      "industry": "Software Development",
      "organization_type": "Privately Held",
      "specialities": [
        "Payments",
        "API"
      ]
    }
  ],
  "total": 845,
  "pagination": {
    "token": "eyJ...",
    "size": 1
  },
  "price": 0.0003,
  "credits_remaining": 4.9997
}

Authorizations

x-api-key

string

header

required

Your Huntr API key. Get one at tryhuntr.com. Pass as x-api-key header on all authenticated requests.

Body

application/json

query

object

required

At least one filter required. Combine multiple filters — all must match (AND). See each field for match rules. Invalid industry or type values return HTTP 400 with accepted_values. Use POST /company-search-count to preview total for free.

Show child attributes

pagination

object

One page per request (no auto-fetch). size: companies/people returned this call (default 100, max 200). token: copy from the previous response pagination.token to get the next page — keep the same query. Tokens expire; do not change the query between pages.

Show child attributes

Response

Company search results.

success

boolean

request_id

string

companies

object[]

Matching companies.

Show child attributes

total

integer

Total companies matching the query in the database (not the length of companies).

pagination

object

Upstream pagination cursor when more pages exist. Pass pagination.token back on the next request with the same query.

Show child attributes

price

number

Cost in USD. $0.0003 × number of companies returned.

credits_remaining

number

Poll research status Count companies matching a query — free

⌘I