curl --request POST \
--url https://api.tryhuntr.com/person-search-count \
--header 'x-api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
"semantic_query": "VPs of Sales at cybersecurity companies",
"filters": {
"locality": {
"include": [
"US"
]
}
},
"has_email": true
}'{
"success": true,
"request_id": "req_1746123456_psc1x2",
"total": 42000,
"price": 0,
"credits_remaining": 5
}{
"error": "<string>"
}{
"error": "<string>"
}{
"error": "<string>",
"field": "<string>",
"invalid_values": [
"<string>"
],
"accepted_values": [
"<string>"
]
}{
"error": "<string>"
}Person Search Count
Count people matching the same structured, natural-language, and availability-filter inputs accepted by /person-search. Count endpoints do not accept pagination and do not return rows.
curl --request POST \
--url https://api.tryhuntr.com/person-search-count \
--header 'x-api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
"semantic_query": "VPs of Sales at cybersecurity companies",
"filters": {
"locality": {
"include": [
"US"
]
}
},
"has_email": true
}'{
"success": true,
"request_id": "req_1746123456_psc1x2",
"total": 42000,
"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
Choose one people 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.
Optional: add has_email and/or has_phone to count only contacts with available email or phone data.
Do not send query and semantic_query together. Count endpoints do not accept pagination.
Natural-language description of people to count. Mutually exclusive with query.
Hard filters for semantic_query. Same supported fields as query.
Show child attributes
Show child attributes
At least one supported filter required unless has_email or has_phone is true. Use non-empty include and/or exclude arrays.
Show child attributes
Show child attributes
When true, only count contacts with email data available.
When true, only count contacts with phone data available.