curl --request POST \
--url https://api.tryhuntr.com/company-search \
--header 'x-api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
"semantic_query": "Companies helping hospitals reduce nurse burnout through workflow automation",
"filters": {
"country_code": {
"include": [
"US"
]
}
},
"pagination": {
"size": 10
}
}'{
"success": true,
"request_id": "req_1746123456_cs1x2y",
"result": {
"companies": [
{
"company_name": "Acme Cloud Solutions",
"company_url": "acme.com",
"email_domain": "acme.com",
"final_email_domain": "acme.com",
"phone": "+1-555-0100",
"linkedin_url": "https://linkedin.com/company/acme",
"city": "Austin",
"region_code": "TX",
"country_code": "US",
"industry": "Software Development",
"employee_count": "100 - 249",
"revenue": "10 - 20 Million",
"services": [
"Web Development"
],
"service_count": 1,
"home_page_text": "We help enterprises modernize with cloud migration and DevOps.",
"home_page_text_snippet": "We help enterprises modernize with cloud migration...",
"bio_li_snippet": "Leading cloud solutions provider..."
}
]
},
"pagination": {
"size": 1,
"token": "opaque-next-page-token",
"has_more": true
},
"total": 842,
"price": 0.0003,
"credits_remaining": 4.9997
}{
"error": "Unknown query filter(s): domain",
"field": "query",
"invalid_values": [
"domain"
],
"accepted_values": [
"home_page_text",
"bio_li",
"services",
"industry",
"number_of_employees",
"revenue",
"country_code",
"city",
"company_name",
"company_url"
]
}{
"error": "<string>"
}{
"error": "<string>"
}{
"error": "industry contains value(s) outside the allowed lookup list",
"field": "query.industry",
"invalid_values": [
"SaaS"
],
"accepted_values": [
"Software Development"
]
}{
"error": "<string>"
}{
"error": "<string>"
}Company Search
Search companies with structured filters or a natural-language semantic query. Returns one paginated page of company rows.
curl --request POST \
--url https://api.tryhuntr.com/company-search \
--header 'x-api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
"semantic_query": "Companies helping hospitals reduce nurse burnout through workflow automation",
"filters": {
"country_code": {
"include": [
"US"
]
}
},
"pagination": {
"size": 10
}
}'{
"success": true,
"request_id": "req_1746123456_cs1x2y",
"result": {
"companies": [
{
"company_name": "Acme Cloud Solutions",
"company_url": "acme.com",
"email_domain": "acme.com",
"final_email_domain": "acme.com",
"phone": "+1-555-0100",
"linkedin_url": "https://linkedin.com/company/acme",
"city": "Austin",
"region_code": "TX",
"country_code": "US",
"industry": "Software Development",
"employee_count": "100 - 249",
"revenue": "10 - 20 Million",
"services": [
"Web Development"
],
"service_count": 1,
"home_page_text": "We help enterprises modernize with cloud migration and DevOps.",
"home_page_text_snippet": "We help enterprises modernize with cloud migration...",
"bio_li_snippet": "Leading cloud solutions provider..."
}
]
},
"pagination": {
"size": 1,
"token": "opaque-next-page-token",
"has_more": true
},
"total": 842,
"price": 0.0003,
"credits_remaining": 4.9997
}{
"error": "Unknown query filter(s): domain",
"field": "query",
"invalid_values": [
"domain"
],
"accepted_values": [
"home_page_text",
"bio_li",
"services",
"industry",
"number_of_employees",
"revenue",
"country_code",
"city",
"company_name",
"company_url"
]
}{
"error": "<string>"
}{
"error": "<string>"
}{
"error": "industry contains value(s) outside the allowed lookup list",
"field": "query.industry",
"invalid_values": [
"SaaS"
],
"accepted_values": [
"Software Development"
]
}{
"error": "<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 company search 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, or when paginating with a resolved_query.
Do not send query and semantic_query together.
Natural-language description of the companies to find. Mutually exclusive with query. The response includes resolved_query for deterministic pagination.
8000At least one filter required. Supported filters: home_page_text, bio_li, services, industry, number_of_employees, revenue, country_code, city, company_name, company_url. Exact lookup filters return 422 when values are not accepted.
Show child attributes
Show child attributes
Configurable page size. pagination.size min 1, default 10, max 100. Send pagination.size on the first request and with pagination.token on later pages. Keep the same query between pages.
Show child attributes
Show child attributes
Response
Company search results.
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Total matching records for the submitted query. This can be larger than the number returned in this page.
Plan-specific amount multiplied by companies returned.