curl --request POST \
--url https://api.tryhuntr.com/company-search-count \
--header 'x-api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
"query": {
"industry": {
"include": [
"Software Development"
]
},
"country_code": {
"include": [
"US"
]
}
}
}'{
"success": true,
"request_id": "req_1746123456_csc1x2",
"total": 842,
"price": 0,
"credits_remaining": 5
}{
"error": "<string>"
}{
"error": "<string>"
}{
"error": "<string>",
"field": "<string>",
"invalid_values": [
"<string>"
],
"accepted_values": [
"<string>"
]
}{
"error": "<string>"
}Company APIs
Company Search Count
Count companies matching the same structured or natural-language inputs accepted by /company-search. Count endpoints do not accept pagination and do not return rows.
POST
/
company-search-count
curl --request POST \
--url https://api.tryhuntr.com/company-search-count \
--header 'x-api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
"query": {
"industry": {
"include": [
"Software Development"
]
},
"country_code": {
"include": [
"US"
]
}
}
}'{
"success": true,
"request_id": "req_1746123456_csc1x2",
"total": 842,
"price": 0,
"credits_remaining": 5
}{
"error": "<string>"
}{
"error": "<string>"
}{
"error": "<string>",
"field": "<string>",
"invalid_values": [
"<string>"
],
"accepted_values": [
"<string>"
]
}{
"error": "<string>"
}Authorizations
Your Huntr API key. Get one at tryhuntr.com. Pass as x-api-key header on all authenticated requests.
Body
application/json
Choose one company count input:
- Natural-language mode: send semantic_query. Add filters only with semantic_query when you need hard constraints.
- Structured-filter mode: send query when you already have exact filters.
Do not send query and semantic_query together. Count endpoints do not accept pagination.