Skip to main content
POST
Discover companies

Authorizations

Authorization
string
header
required

API key in the format: Bearer {api_token}

Headers

Idempotency-Key
string

Makes this write safe to retry: a repeat with the same key replays the first response instead of creating a second resource. Scoped to the account, remembered for 24 hours; reusing a key with a different payload is an error.

Maximum string length: 255

Body

application/json
query
string | null
required

Natural-language description of the companies to find.

domain
string | null

Restrict to a specific domain.

headcount
string | null

Employee count range (e.g. 1-10, 11-50, 51-200).

company_type
string | null
department
string | null
seniority
string | null
limit
integer | null

Max companies to return.

Required range: 1 <= x <= 100
technology
string[]
industry
string[]
location
string[]

Response

Matching companies

object
enum<string>
Available options:
lead_discovery_result
total
integer | null
companies
object[]