Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.thehog.ai/llms.txt

Use this file to discover all available pages before exploring further.

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/companies/search.

​
Firmographics

Firmographic filters describe who a company is as a business entity.
FieldDescriptionExample
queryText search on name or domain"Acme"
industryIndustry vertical"Software"
employee_count_min / employee_count_maxHeadcount range10 / 500
revenue_min / revenue_maxAnnual revenue range in USD1000000 / 50000000
locationCountry or city"United States"
founding_year_min / founding_year_maxYear the company was founded2010 / 2020
domainExact or partial domain match"acme.com"

​
Technographics

Technographic filters let you target companies based on the tools they use.
FieldDescriptionExample
tech_stackArray of tools or technologies the company uses["Salesforce", "HubSpot"]
keyword_categoryKeyword advertising category"PPC - CRM"

​
Signals

Signal filters surface companies showing intent or momentum right now.
FieldDescriptionValues
hiringCompany is actively posting jobstrue / false
fundingCompany has had recent funding activitytrue / false
growthGrowth trajectory band"low" / "medium" / "high"

​
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. When you include a projectId in your request, each result also contains a projectContext object with brand voice, matched personas, and competitive intel scoped to your project. See Using Project Context for details.

​
Pivoting to people

Once you have a list of target companies, you pass a company’s id to POST /api/people/search to find contacts who work there. 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/companies/search request with your filters. Review the returned company list and signal_summary fields to validate the match quality.
curl -X POST https://api.thehog.ai/api/companies/search \
  -H "Authorization: Bearer <your-api-key>" \
  -H "Content-Type: application/json" \
  -d '{
    "tech_stack": ["Salesforce"],
    "hiring": true,
    "employee_count_min": 50,
    "employee_count_max": 500,
    "limit": 25
  }'
3

Review company results

Each result includes the company id, firmographic data, signal indicators, and an optional projectContext if you passed a projectId. Note the id values for the companies you want to pursue.
4

Search for people at those companies

Pass the company id to POST /api/people/search to find contacts. You can further filter by title, seniority, or department.
curl -X POST https://api.thehog.ai/api/people/search \
  -H "Authorization: Bearer <your-api-key>" \
  -H "Content-Type: application/json" \
  -d '{
    "companyId": "<company-id-from-step-3>",
    "query": "VP of Sales"
  }'
5

Enrich and engage

Use POST /api/people/enrich to retrieve verified email addresses and phone numbers for the contacts you want to reach. Then pass them to POST /api/generate to produce personalized outreach.
Combine tech_stack and hiring together to find companies actively expanding in areas where your product fits. This pairing consistently produces the highest-intent account lists.
The limit parameter defaults to 20 and caps at 100 per request. Use offset for pagination when your result set is large.