Skip to main content
The Hog is built around a simple principle: find the right companies before you find the right people. Rather than searching a sea of contacts and reverse-engineering which accounts they belong to, you start by narrowing down a list of target accounts that fit your ICP, then pivot to the contacts who work there. This keeps your outreach focused and dramatically reduces noise at every stage of your pipeline.

​
What you can search on

Company search accepts filters across three dimensions: firmographics, technographics, and signals. You can combine any of these in a single request to POST /api/v1/companies/search.

​
Firmographics

Firmographic filters describe who a company is as a business entity.
FieldDescriptionExample
queryText search on name or domain"Acme"
filters.industriesIndustry verticals["Software"]
filters.employeeCount.min/maxHeadcount range10 / 500
filters.locationsCountry or city filters["United States"]
filters.company.domainsExact domain filters["acme.com"]

​
Technographics

Technographic filters let you target companies based on the tools they use.
FieldDescriptionExample
queryMention tools or technologies in natural language"companies using Salesforce"

​
Signals

Signal filters surface companies showing intent or momentum right now.
FieldDescriptionValues
filters.signalsSignal labels to prioritize["hiring", "funding"]

​
How results look

Each company in the response includes a signal_summary array that summarises the most relevant signals (e.g. ["recent funding", "hiring in sales"]), a match_score between 0 and 1, and the full set of firmographic and technographic fields that matched your query.

​
Pivoting to people

Once you have a list of target companies, you pass company constraints such as domains or names in filters.company to POST /api/v1/people/search. This two-step flow keeps your people search tightly scoped to accounts that already meet your ICP criteria.

​
Typical workflow

1

Define your ICP filters

Decide which firmographic, technographic, and signal filters describe your ideal account. For example: software companies with 50–500 employees, using Salesforce, and actively hiring.
2

Search for matching companies

Send a POST /api/v1/companies/search request with your query and filters. Poll the returned operation, then review the company list and signal fields to validate the match quality.
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": "Software companies using Salesforce and hiring engineers",
    "filters": {
      "employeeCount": { "min": 50, "max": 500 },
      "signals": ["hiring"]
    },
    "limit": 25
  }'
3

Review company results

Each result includes firmographic data and signal indicators. Note the domains or names for the companies you want to pursue.
4

Search for people at those companies

Pass company filters to POST /api/v1/people/search to find contacts. You can further filter by title, location, industry, or signals.
curl -X POST https://developer.thehog.ai/api/v1/people/search \
  -H "X-Access-Key: ak_xxxxxxxxxxxxxxxx" \
  -H "X-Secret-Key: sk_xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "VP of Sales",
    "filters": {
      "company": { "domains": ["acme.com"] }
    },
    "limit": 10
  }'
5

Enrich and engage

Use POST /api/enrichments to retrieve verified email addresses and phone numbers for the contacts you want to reach.
Combine tool mentions in query with filters.signals such as "hiring" to find companies actively expanding in areas where your product fits.
The limit parameter defaults to 25 and caps at 100 per request.