Skip to main content
POST
Count people
Estimate an audience before retrieving any lead records. Count accepts the same person, role, current-company, and past-experience filters as Find people.
Count is free. It neither reserves nor debits Airscale credits, and its response contains only the matching total.

Reuse a search audience

Send the same query object you plan to use for Find people. Count has no pagination fields because it returns no lead page; keep size and cursor on the search request instead. The Count and Find people operations share a limit of 6 requests per second per workspace. After a 429 Too Many Requests response, wait for the next second and retry with bounded exponential backoff.
This page renders non-executing examples. It does not send a request or ask for an API key.

Combining past-experience filters

All past-experience filters must match the same prior role, including combinations of pastJobTitle and pastCompany*. Count uses the same matching rules as Find people.

Next step

Use Find people with the same query when you are ready to retrieve the matching records.

Authorizations

Authorization
string
header
required

Use an Airscale workspace API key. Never expose the key in client-side code.

Body

application/json

Provide at least one supported query filter. Count has no size or cursor fields.

query
object
required

Response

The number of people matching the query.

total
number
required