Count people
curl --request POST \
--url https://api.airscale.io/v1/find-people/count \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"query": {
"jobTitle": {
"include": [
"Revenue Operations Manager"
]
},
"location": {
"include": [
"Example Country"
]
}
}
}
'const url = 'https://api.airscale.io/v1/find-people/count';
const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
query: {
jobTitle: {include: ['Revenue Operations Manager']},
location: {include: ['Example Country']}
}
})
};
fetch(url, options)
.then(res => res.json())
.then(json => console.log(json))
.catch(err => console.error(err));import requests
url = "https://api.airscale.io/v1/find-people/count"
payload = { "query": {
"jobTitle": { "include": ["Revenue Operations Manager"] },
"location": { "include": ["Example Country"] }
} }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"total": 124
}{
"error": "<string>",
"message": "<string>"
}{
"error": "<string>",
"message": "<string>"
}{
"error": "<string>",
"message": "<string>"
}{
"error": "<string>",
"message": "<string>"
}{
"error": "<string>",
"message": "<string>"
}{
"error": "<string>",
"message": "<string>"
}{
"error": "<string>",
"message": "<string>"
}{
"error": "<string>",
"message": "<string>"
}Count people
Count people matching person, role, and company filters. Rate limit: 6 requests per second per workspace.
POST
/
v1
/
find-people
/
count
Count people
curl --request POST \
--url https://api.airscale.io/v1/find-people/count \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"query": {
"jobTitle": {
"include": [
"Revenue Operations Manager"
]
},
"location": {
"include": [
"Example Country"
]
}
}
}
'const url = 'https://api.airscale.io/v1/find-people/count';
const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
query: {
jobTitle: {include: ['Revenue Operations Manager']},
location: {include: ['Example Country']}
}
})
};
fetch(url, options)
.then(res => res.json())
.then(json => console.log(json))
.catch(err => console.error(err));import requests
url = "https://api.airscale.io/v1/find-people/count"
payload = { "query": {
"jobTitle": { "include": ["Revenue Operations Manager"] },
"location": { "include": ["Example Country"] }
} }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"total": 124
}{
"error": "<string>",
"message": "<string>"
}{
"error": "<string>",
"message": "<string>"
}{
"error": "<string>",
"message": "<string>"
}{
"error": "<string>",
"message": "<string>"
}{
"error": "<string>",
"message": "<string>"
}{
"error": "<string>",
"message": "<string>"
}{
"error": "<string>",
"message": "<string>"
}{
"error": "<string>",
"message": "<string>"
}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 samequery 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 ofpastJobTitle and pastCompany*. Count uses the same matching rules as Find people.
Next step
Use Find people with the samequery when you are ready to retrieve the matching records.Authorizations
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.
Show child attributes
Show child attributes
Response
The number of people matching the query.