Skip to main content
A Company Discovery Watcher re-runs a Company Search on a schedule and delivers new matches to your channel. 
POST https://api.crustdata.com/watch/company/search
Pricing: first run is a free baseline (up to 5 matches), then 2 credits per new company delivered.

​
Request body

The body is identical in shape to the person watcher — filters, config, and notifications — but filters use Company Search fields.
FieldRequiredDescription
filtersYesA filter tree, identical to Company Search.
config.triggerYes{ "type": "interval", "every_hours": N }.
config.max_results_per_runNoMax records per run. Default 25; baseline capped at 5.
config.expires_atNoISO date; the watch auto-stops after it.
notificationsYesOne or more delivery channels — webhook, Slack, or email.
All examples require authorization: Bearer YOUR_API_KEY, content-type: application/json, and x-api-version: 2025-11-01.

​
Recipes

​
Segment + headcount growth

New Brazilian software companies (50–500 employees) that grew headcount 30%+: 
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: 
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: 
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: 
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 (list runs, run detail, cancel).

​
Pricing

Credits
First run (baseline, up to 5 matches)Free
Each new company delivered on later runs2
You’re charged only for companies actually delivered — never for a run that finds nothing new.