Skip to main content
POST
Set updates_since to include recent activity. Choose a date a few weeks or months back for eligible activity from that period plus ongoing updates. If omitted, the cutoff is the radar’s creation time, with source dates compared at the precision available for each radar type. Your first check may return no results, and updates may take time to arrive.
countries: For industry_job_openings it filters by the job’s location; for industry_funding_rounds, by the company’s headquarters country. Send two-letter codes or country names, in any case (e.g. us, UK, Canada). We save and return the country name, e.g. United States. An unsupported or repeated country returns 400. See Supported Countries.
rounds: For industry_funding_rounds only. Send round labels exactly as listed in Round Types, e.g. Seed or Series A, each once. Omitted or empty means all rounds. A Seed filter does not include rounds labeled Unknown; add Unknown to receive them. An unknown or repeated label returns 400.With both countries and rounds, a funding round must match one listed country and one listed round. Sending countries or rounds on an industry radar type that doesn’t use them returns 400.
Example dates are illustrative. Calculate updates_since from your chosen lookback.

Authorizations

x-api-key
string
header
required

Body

application/json
radar_type
enum<string>
required

The type of industry activity to track

Available options:
industry_mentions,
industry_funding_rounds,
industry_new_companies,
industry_job_openings
webhook_url
string<uri>

Webhook URL to receive radar updates and notifications. Optional — if omitted, the radar is poll-only and updates are available via GET /v1/updates.

Example:

"https://webhook.site/your-webhook-id"

updates_since
string<date-time>

Optional RFC 3339 timestamp with a UTC offset. Recommended for recent activity: choose a date weeks or months back. If omitted, most radars start at their exact creation time, not the start of today; even a post published one minute earlier is excluded. Initial checks may return no results; immediate updates are not guaranteed. New hires and promotions compare UTC calendar months, starting with the cutoff month (creation month if omitted). Contact job changes monitor detected changes, not historical job moves. TAMradar stores the timestamp in UTC. It must be now or in the past, at most five calendar years old. The five-second clock-skew tolerance does not allow future scheduling.

include_historical
boolean
deprecated

Deprecated compatibility field. It is accepted and stored but has no effect. Use updates_since to request historical eligibility.

keyword
string

Required for 'industry_mentions' and 'industry_job_openings'. The keyword or phrase to track across all domains or in job postings. Must be at least 3 characters long. Not used for 'industry_funding_rounds' or 'industry_new_companies'.

Minimum string length: 3
Example:

"artificial intelligence"

countries
string[]

Optional for 'industry_job_openings' (filters by the job's location) and 'industry_funding_rounds' (filters by the company's headquarters country). Returns 400 on other industry radar types. Up to 5 entries. Each entry is a two-letter country code, a country name or another accepted name, in any case (for example 'us', 'UK', 'Turkey'). Saved and returned as the country name (for example 'United States', 'United Kingdom', 'Türkiye'). An unsupported or repeated country returns 400. See Supported Countries for the full list.

Maximum array length: 5
Example:
rounds
enum<string>[]

Optional for 'industry_funding_rounds' only. Returns 400 on other industry radar types. Each entry must be a round label spelled exactly as listed (case-sensitive), each at most once; see Round Types. Omitted or empty means all rounds. A 'Seed' filter does not include rounds labeled 'Unknown'; add 'Unknown' to receive them. With both 'countries' and 'rounds', a round must match one listed country and one listed round.

Maximum array length: 18
Available options:
Pre-seed,
Seed,
Series A,
Series B,
Series C,
Series D,
Series E,
Series F,
Series G,
Bridge,
Bridge Financing,
Debt Financing,
Growth Financing,
Unknown,
Crowdfunding,
Initial Public Offering,
Private Equity,
Initial Coin Offering
Example:
custom_fields
object

Optional metadata to attach to this radar. Values must be strings only. Use for internal tracking like account_id, customer_id, or campaign_id. Returned with every webhook.

Example:

Response

Radar created successfully

status
enum<string>
Available options:
success
code
enum<integer>
Available options:
201
message
string
data
object
timestamp
string<date-time>