Skip to main content
POST
/
company-search-count
Count companies matching a query — free
curl --request POST \
  --url https://api.tryhuntr.com/company-search-count \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "query": {
    "industry": {
      "include": [
        "Software Development"
      ]
    },
    "headcount": {
      ">": 50
    },
    "location": {
      "include": [
        "US"
      ]
    }
  }
}
'
{
  "success": true,
  "request_id": "req_1746123456_cc2x3y",
  "total": 142,
  "price": 0,
  "credits_remaining": 5
}

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.

Response

Count result.

success
boolean
request_id
string
total
integer

Number of companies matching the query.

price
number

Always 0 — this endpoint is free.

credits_remaining
number