> ## Documentation Index
> Fetch the complete documentation index at: https://docs.crustdata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Company Discovery Watcher

> Create a watcher that alerts you when new companies match your filters. Copy-paste curl recipes for segments, headcount growth, and funding.

A Company Discovery Watcher re-runs a [Company Search](/company-docs/search/introduction) on a schedule and delivers new matches to your channel.

```
POST https://api.crustdata.com/watch/company/search
```

<Callout icon="coins" color="#5345e4">
  <strong>Pricing:</strong> first run is a free baseline (up to 5 matches), then
  <code>2 credits per new company</code> delivered.
</Callout>

## Request body

The body is identical in shape to the [person watcher](/watcher-docs/discovery/person#request-body) — `filters`, `config`, and `notifications` — but `filters` use [Company Search](/company-docs/search/reference) fields.

| Field                        | Required | Description                                                                                                   |
| ---------------------------- | -------- | ------------------------------------------------------------------------------------------------------------- |
| `filters`                    | Yes      | A filter tree, identical to [Company Search](/company-docs/search/reference).                                 |
| `config.trigger`             | Yes      | `{ "type": "interval", "every_hours": N }`.                                                                   |
| `config.max_results_per_run` | No       | Max records per run. Default `25`; baseline capped at 5.                                                      |
| `config.expires_at`          | No       | ISO date; the watch auto-stops after it.                                                                      |
| `notifications`              | Yes      | One or more delivery channels — [webhook, Slack, or email](/watcher-docs/discovery/person#delivery-channels). |

<Note>
  All examples require `authorization: Bearer YOUR_API_KEY`,
  `content-type: application/json`, and `x-api-version: 2025-11-01`.
</Note>

## Recipes

### Segment + headcount growth

New **Brazilian software companies (50–500 employees) that grew headcount 30%+**:

```bash theme={"theme":"vitesse-black"}
curl --request POST \
  --url https://api.crustdata.com/watch/company/search \
  --header 'authorization: Bearer YOUR_API_KEY' \
  --header 'content-type: application/json' \
  --header 'x-api-version: 2025-11-01' \
  --data '{
    "filters": {
      "op": "and",
      "conditions": [
        { "field": "taxonomy.professional_network_industry", "type": "=", "value": "Software Development" },
        { "field": "locations.country", "type": "in", "value": ["Brazil"] },
        { "field": "headcount.total", "type": "=>", "value": 50 },
        { "field": "headcount.total", "type": "=<", "value": 500 },
        { "field": "headcount.growth_percent.6m", "type": "=>", "value": 30 }
      ]
    },
    "config": { "trigger": { "type": "interval", "every_hours": 24 }, "max_results_per_run": 25 },
    "notifications": [ { "type": "webhook", "url": "https://your-app.com/webhooks/crustdata" } ]
  }'
```

### Well-funded companies in a country

New **US companies that have raised more than \$10M**:

```bash theme={"theme":"vitesse-black"}
curl --request POST \
  --url https://api.crustdata.com/watch/company/search \
  --header 'authorization: Bearer YOUR_API_KEY' \
  --header 'content-type: application/json' \
  --header 'x-api-version: 2025-11-01' \
  --data '{
    "filters": {
      "op": "and",
      "conditions": [
        { "field": "locations.country", "type": "in", "value": ["USA"] },
        { "field": "funding.total_investment_usd", "type": ">", "value": 10000000 }
      ]
    },
    "config": { "trigger": { "type": "interval", "every_hours": 24 } },
    "notifications": [ { "type": "slack", "webhook_url": "https://hooks.slack.com/services/T000/B000/XXXX" } ]
  }'
```

### Recently founded companies

New **companies founded after 2020**:

```bash theme={"theme":"vitesse-black"}
curl --request POST \
  --url https://api.crustdata.com/watch/company/search \
  --header 'authorization: Bearer YOUR_API_KEY' \
  --header 'content-type: application/json' \
  --header 'x-api-version: 2025-11-01' \
  --data '{
    "filters": {
      "op": "and",
      "conditions": [
        { "field": "basic_info.year_founded", "type": ">", "value": 2020 },
        { "field": "taxonomy.professional_network_industry", "type": "=", "value": "Software Development" }
      ]
    },
    "config": { "trigger": { "type": "interval", "every_hours": 168 } },
    "notifications": [ { "type": "email", "to": ["gtm@yourcompany.com"] } ]
  }'
```

### High-growth mid-market

Software companies **growing fast in the 200–2,000 range**:

```bash theme={"theme":"vitesse-black"}
curl --request POST \
  --url https://api.crustdata.com/watch/company/search \
  --header 'authorization: Bearer YOUR_API_KEY' \
  --header 'content-type: application/json' \
  --header 'x-api-version: 2025-11-01' \
  --data '{
    "filters": {
      "op": "and",
      "conditions": [
        { "field": "headcount.growth_percent.6m", "type": ">", "value": 15 },
        { "field": "headcount.total", "type": "=>", "value": 200 },
        { "field": "headcount.total", "type": "=<", "value": 2000 }
      ]
    },
    "config": { "trigger": { "type": "interval", "every_hours": 24 } },
    "notifications": [ { "type": "webhook", "url": "https://your-app.com/webhooks/crustdata" } ]
  }'
```

## Manage a watch

Company watches are managed with the same endpoints as person watches — see
[Manage a watch](/watcher-docs/discovery/person#manage-a-watch) (list runs, run
detail, cancel).

## Pricing

|                                          | Credits  |
| ---------------------------------------- | -------- |
| First run (baseline, up to 5 matches)    | **Free** |
| Each new company delivered on later runs | **2**    |

You're charged only for companies actually delivered — never for a run that finds nothing new.