Skip to main content
POST
Find professional leads by person and company filters.

Authorizations

X-API-Key
string
header
required

Company API key - scoped to a specific company. Generate from the Integrations page in your dashboard.

Body

application/json

Lead generation criteria

companyId
string
required

Company ID for access and any applicable data-credit charges

filters
object
required

Professional/company filters from lead_field_options(describe=true). Accepts catalog camelCase fields (title, seniority, department, company, companyDomain, industry, employeeRange, country, city, education, numeric min/max fields, exclusions). Country values are two-letter codes. Use lead_field_options to discover supported fields.

limit
integer

Max leads, max 100, default 25.

Response

Matching leads plus the total available

Matching leads plus the total available

leads
object[]

Basic person results: name, company, location and profile identifiers (up to limit).

totalAvailable
integer

Total leads matching the criteria.