Apollo People search API
Search people by title, seniority, name, location, employer domain or id, email status, and employer revenue, technology, hiring, and headcount growth, with normalized profile summaries.
$10.00/1k req, pay per request, no subscription.
{"id": "9c2e4a71fd83600018bb52ae","firstName": "Marisol","lastNameInitial": "T","title": "VP of Engineering","lastRefreshedUtc": 1758931200,"hasEmail": true,"hasCity": true,"hasState": true,... 3 more fields}
Pricing
Apollo People search API pricing
Try it
Get Apollo people search in one request
This sample shows 24 of 25 fields. See every field
{
"found": true,
"data": {
"people": [
{
"id": "9c2e4a71fd83600018bb52ae",
"firstName": "Marisol",
"lastNameInitial": "T",
"title": "VP of Engineering",
"lastRefreshedUtc": 1758931200,
"hasEmail": true,
"hasCity": true,
"hasState": true,
"hasCountry": true,
"hasDirectPhone": false,
"organization": {
"name": "Clearpath Climate",
"hasIndustry": true,
"hasPhone": true,
"hasCity": true,
"hasState": true,
"hasCountry": true,
"hasPostalCode": true,
"hasRevenue": true,
"hasEmployeeCount": true
}
},
{
"id": "4d7b1c92ae6350001299dcf3",
"firstName": "Owen",
"lastNameInitial": "K",
"title": "VP of Engineering",
"lastRefreshedUtc": 1758067200,
"hasEmail": true,
"hasCity": true,
"hasState": false,
"hasCountry": true,
"hasDirectPhone": true,
"organization": {
"name": "Greenfield Carbon",
"hasIndustry": true,
"hasPhone": false,
"hasCity": true,
"hasState": true,
"hasCountry": true,
"hasPostalCode": false,
"hasRevenue": true,
"hasEmployeeCount": true
}
},
{
"id": "2f8a5d63bc7140002cee19af",
"firstName": "Priya",
"lastNameInitial": "N",
"title": "VP of Engineering",
"lastRefreshedUtc": 1757462400,
"hasEmail": false,
"hasCity": true,
"hasState": true,
"hasCountry": true,
"hasDirectPhone": false,
"organization": {
"name": "Ironleaf Energy",
"hasIndustry": true,
"hasPhone": true,
"hasCity": true,
"hasState": false,
"hasCountry": true,
"hasPostalCode": true,
"hasRevenue": false,
"hasEmployeeCount": true
}
}
],
"total": 612
}
}Full parameter and response reference - every field, type, and example for this endpoint.
Reference
One request, one response shape.
Every field you send and every field you get back, each with a real example.
Last verified 2026-10-31 · uptime and latency measured over 30d
Request body
JSON, posted to this endpoint.
- emailStatusesarray
Email statuses to match.
- employeeRangesarray
["51,200"]
Organization employee-count ranges in Apollo notation, such as 51,200.
- excludeOrganizationDomainsarray
Exclude people whose current employer matches any of these domains. Every domain Apollo holds for that employer is excluded.
- headcountGrowthMonthsenum
Trailing window in months for the headcount growth filter. Takes effect only together with minHeadcountGrowthPercent or maxHeadcountGrowthPercent.
- includeSimilarTitlesboolean
Whether titles similar to the ones in titles also match. Set false for strict title matches only.
- jobPostedAtGtestring
Only organizations with a job posted on or after this date. Format: YYYY-MM-DD.
- jobPostedAtLtestring
Only organizations with a job posted on or before this date. Format: YYYY-MM-DD.
- jobPostingLocationsarray
Locations of the organization's active job postings, such as japan.
- jobPostingTitlesarray
Job titles listed in the organization's active job postings, such as sales manager.
- keywordsstring
Keywords to match across people records.
- limitinteger
3
Maximum people returned on this page.
- lookalikeOrganizationIdsarray
Apollo organization identifiers to use as lookalike seeds, at most five. Results are narrowed to organizations similar to the seeds, and the seeds themselves are excluded. A seed Apollo holds no lookalike data for returns no results.
- maxHeadcountGrowthPercentinteger
Maximum organization headcount growth over headcountGrowthMonths, as a whole percentage such as 100 for 100%.
- maxJobsinteger
Maximum number of active job postings at the organization.
- maxRevenueUsdinteger
Maximum organization annual revenue, in whole USD with no symbols.
- minHeadcountGrowthPercentinteger
Minimum organization headcount growth over headcountGrowthMonths, as a whole percentage such as 10 for 10%. Negative values are accepted.
- minJobsinteger
Minimum number of active job postings at the organization.
- minRevenueUsdinteger
Minimum organization annual revenue, in whole USD with no symbols.
- organizationDomainsarray
Domains of the person's current or previous employer, without www, at most 1000.
- organizationIdsarray
Apollo identifiers of the person's current employer.
- organizationLocationsarray
["San Francisco, CA"]
Organization headquarters locations to match.
- pageinteger
1
One-based result page.
- personLocationsarray
Person locations to match.
- personNamestring
Person name to match; results include people whose name contains every word.
- senioritiesarray
["vp"]
Seniority levels to match.
- technologySlugAndarray
Only people whose current employer uses ALL of these technologies. Apollo technology identifiers, such as salesforce or google_analytics (spaces and periods become underscores). The technologies output of the Apollo organization SKUs returns them as id.
- technologySlugNotarray
Exclude people whose current employer uses any of these technologies. Apollo technology identifiers, such as salesforce or google_analytics (spaces and periods become underscores). The technologies output of the Apollo organization SKUs returns them as id.
- technologySlugOrarray
Only people whose current employer uses ANY of these technologies. Apollo technology identifiers, such as salesforce or google_analytics (spaces and periods become underscores). The technologies output of the Apollo organization SKUs returns them as id.
- titlesarray
["VP of Engineering"]
Job titles to match.
Response
JSON, one example value per field.
People on this result page.
- firstNamestring
Marisol
Person first name.
- hasCityboolean
true
Whether city data is available through enrichment.
- hasCountryboolean
true
Whether country data is available through enrichment.
- hasDirectPhoneboolean
false
Whether direct phone data is available through asynchronous enrichment.
- hasEmailboolean
true
Whether an email is available through enrichment.
- hasStateboolean
true
Whether state or region data is available through enrichment.
- idstring
9c2e4a71fd83600018bb52ae
Stable person identifier.
- lastNameInitialstring
T
Obfuscated last-name initial.
- lastRefreshedUtcnumber
1758931200
UTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds.
- titlestring
VP of Engineering
Current job title.
Availability summary for the current organization.
- hasCityboolean
true
Whether organization city data is available.
- hasCountryboolean
true
Whether organization country data is available.
- hasEmployeeCountboolean
true
Whether organization employee-count data is available.
- hasIndustryboolean
true
Whether industry data is available.
- hasPhoneboolean
true
Whether an organization phone is available.
- hasPostalCodeboolean
true
Whether organization postal-code data is available.
- hasRevenueboolean
true
Whether organization revenue data is available.
- hasStateboolean
true
Whether organization state data is available.
- namestring
Clearpath Climate
Current organization name.
- totalinteger
612
Total matching people.
- foundboolean
true
Whether any matching people were found.
- reason"not_found"
Present only when `found` is false, and says why there is no result. `not_found`: the source states the target does not exist, or returned nothing for it. A `found: false` answer is a successful call, not an error, and `costUsd` is what it actually cost.
FAQ
About the Apollo People search API
The AnyAPI Apollo People search API returns Apollo people search data as normalized JSON from one POST call to /v1/run/apollo.people_search. Search people by title, seniority, name, location, employer domain or id, email status, and employer revenue, technology, hiring, and headcount growth, with normalized profile summaries. AnyAPI returns one normalized schema whichever source serves it. It costs from $10 per 1,000 requests, in US dollars with no subscription and no monthly minimum. Over the last 30 days, 100.0% of Apollo people search calls through AnyAPI succeeded, with a median response time of 1.2 seconds across 2,375 measured calls.