> ## 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.

# Company-First Search in The Hog

> The Hog's company-first approach lets you find target accounts by firmographics and signals first, then drill into contacts — improving ICP match quality.

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.

| Field                           | Description                   | Example             |
| ------------------------------- | ----------------------------- | ------------------- |
| `query`                         | Text search on name or domain | `"Acme"`            |
| `filters.industries`            | Industry verticals            | `["Software"]`      |
| `filters.employeeCount.min/max` | Headcount range               | `10` / `500`        |
| `filters.locations`             | Country or city filters       | `["United States"]` |
| `filters.company.domains`       | Exact domain filters          | `["acme.com"]`      |

### Technographics

Technographic filters let you target companies based on the tools they use.

| Field   | Description                                       | Example                        |
| ------- | ------------------------------------------------- | ------------------------------ |
| `query` | Mention tools or technologies in natural language | `"companies using Salesforce"` |

### Signals

Signal filters surface companies showing intent or momentum right now.

| Field             | Description                 | Values                  |
| ----------------- | --------------------------- | ----------------------- |
| `filters.signals` | Signal 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

<Steps>
  <Step title="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.
  </Step>

  <Step title="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.

    ```bash theme={null} theme={"theme":{"light":"github-light","dark":"github-dark"}}
    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
      }'
    ```
  </Step>

  <Step title="Review company results">
    Each result includes firmographic data and signal indicators. Note the domains or names for the companies you want to pursue.
  </Step>

  <Step title="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.

    ```bash theme={null} theme={"theme":{"light":"github-light","dark":"github-dark"}}
    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
      }'
    ```
  </Step>

  <Step title="Enrich and engage">
    Use `POST /api/enrichments` to retrieve verified email addresses and phone numbers for the contacts you want to reach.
  </Step>
</Steps>

<Tip>
  Combine tool mentions in `query` with `filters.signals` such as `"hiring"` to find companies actively expanding in areas where your product fits.
</Tip>

<Note>
  The `limit` parameter defaults to 25 and caps at 100 per request.
</Note>