Skip to main content
The company search endpoint is the starting point for building targeted account lists. You send a POST request with a natural-language query and optional structured filters, then poll the returned operation for ranked company results. The query field is required.

​
Endpoint

POST https://developer.thehog.ai/api/v1/companies/search

​
Request fields

Text & Identity

query — free-text search on company name or domain (up to 256 characters)filters.company.domains — exact domain filters (e.g. ["acme.com"])

Firmographics

filters.industries, filters.locations, filters.employeeCount.min/max

Technographics

Include tools in query, or use filters.signals for known buying-signal categories.

Signals

filters.signals — short signal labels such as ["hiring", "funding"]

​
Pagination

FieldDefaultMaximumNotes
limit25100Results per page

​
Examples

curl -X POST https://developer.thehog.ai/api/v1/companies/search \
  -H "X-Access-Key: ak_xxxxxxxxxxxxxxxx" \
  -H "X-Secret-Key: sk_xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "Acme",
    "limit": 10
  }'

​
Response

A successful submission returns HTTP 202 with an operation ID and poll URL. Poll GET /api/operations/:id until the operation succeeds. 
{
  "id": "op_01hxyz",
  "operationId": "op_01hxyz",
  "status": "queued",
  "pollUrl": "/api/operations/op_01hxyz"
}

​
Response fields

FieldTypeDescription
id / operationIdstringOperation ID for polling
statusstringqueued immediately after submission
pollUrlstringURL to poll for status and final results

​
CompanyCard fields

FieldTypeDescription
idstringUnique company identifier
namestringCompany display name
domainstringPrimary domain
websitestringFull website URL
industrystringIndustry classification
employee_countnumberHeadcount
locationstringHeadquarters location
founding_yearnumberYear the company was founded
revenue_min / revenue_maxnumberAnnual revenue range in USD
tech_stackstring[]Technologies and tools detected
is_hiringbooleanWhether the company is actively hiring
has_recent_fundingbooleanWhether the company has had recent funding activity
growth_bandstring"low", "medium", or "high"
match_scorenumberRelevance score from 0 to 1
signal_summarystring[]Short human-readable signal descriptions

​
Steps to build a target account list

1

Start with a broad query

Run a search with a broad query and a small limit to gauge the universe of matching companies.
2

Layer in technographic filters

Add technologies your product integrates with or competes against directly into the natural-language query.
3

Add buying signals

Add filters.signals values such as "hiring" or "funding" to surface companies in an active growth phase.
4

Paginate through results

Use limit to control the number of results returned by each search operation.
5

Drill into people

Use the returned company domain or name in filters.company on POST /api/v1/people/search to find contacts at that account.