Apollo.ioPeople DataEnrichment

Search people by title, seniority, company or location

apollo.people.search

Search Apollo's 200M+ contacts by title, seniority, company, location or tech (free)

Price: freeAt provider cost
Success rate: 100%Last 30 days · 442,025 calls
Latency p50: 220 msp95 535 ms
Last verified: Aug 29, 2026Verified working

POSThttps://toolswitch.dev/v1/tools/apollo.people.search?bodyType=jsonPreview

Uses platform quota
Synchronous response
Reads public data

Parameters

query-string params on a POST, with arrays in field[]=value form. RETURNS NO EMAILS OR PHONE NUMBERS AT ALL — that is why it is free. Pipe the person ids into apollo.people.enrich to get contact data, which is where the credits go. Result set is capped at 50,000 records

Parameter	Type	Required	Description	Example
Query parameters
`page`	integer	Optional	1-based; max 500 pages	`1`
`per_page`	integer	Optional	max 100	`1`
`person_titles[]`	array[string]	Optional	job titles, matched loosely (OR across the list)	`["head of marketing"]`
`person_locations[]`	array[string]	Optional	where the PERSON lives	`["California, US"]`
`revenue_range[max]`	integer	Optional	annual revenue ceiling
`revenue_range[min]`	integer	Optional	annual revenue floor, integer with no symbols
`person_seniorities[]`	array[string]	Optional	owner, founder, c_suite, partner, vp, head, director, manager, senior, entry, intern
`contact_email_status[]`	array[string]	Optional	verified, unverified, likely to engage, unavailable
`organization_locations[]`	array[string]	Optional	where their COMPANY's HQ is
`q_organization_domains_list[]`	array[string]	Optional	restrict to employees of these company domains; max 1,000	`["apollo.io"]`
`organization_num_employees_ranges[]`	array[string]	Optional	employee-count bands as 'min,max' strings	`["1,10"]`
`currently_using_any_of_technology_uids[]`	array[string]	Optional	tech-stack filter, e.g. salesforce

Query parameters
pageintegerOptional
1-based; max 500 pages
Example: 1
per_pageintegerOptional
max 100
Example: 1
person_titles[]array[string]Optional
job titles, matched loosely (OR across the list)
Example: ["head of marketing"]
person_locations[]array[string]Optional
where the PERSON lives
Example: ["California, US"]
revenue_range[max]integerOptional
annual revenue ceiling
revenue_range[min]integerOptional
annual revenue floor, integer with no symbols
person_seniorities[]array[string]Optional
owner, founder, c_suite, partner, vp, head, director, manager, senior, entry, intern
contact_email_status[]array[string]Optional
verified, unverified, likely to engage, unavailable
organization_locations[]array[string]Optional
where their COMPANY's HQ is
q_organization_domains_list[]array[string]Optional
restrict to employees of these company domains; max 1,000
Example: ["apollo.io"]
organization_num_employees_ranges[]array[string]Optional
employee-count bands as 'min,max' strings
Example: ["1,10"]
currently_using_any_of_technology_uids[]array[string]Optional
tech-stack filter, e.g. salesforce

Code samples

Replace $TOOLSWITCH_KEY with the key you created in the console.

Preview

curl -X POST 'https://toolswitch.dev/v1/tools/apollo.people.search?bodyType=json' \
  -H "X-Toolswitch-Key: $TOOLSWITCH_KEY" \
  -H "Content-Type: application/json" \
  --data-raw '{"per_page":3,"person_titles":["head of marketing"],"q_organization_domains_list":["stripe.com"]}'

import os
import json
import requests

response = requests.request(
    "POST",
    "https://toolswitch.dev/v1/tools/apollo.people.search?bodyType=json",
    headers={"X-Toolswitch-Key": os.environ["TOOLSWITCH_KEY"]},
    json=json.loads("{\"per_page\":3,\"person_titles\":[\"head of marketing\"],\"q_organization_domains_list\":[\"stripe.com\"]}"),
)
response.raise_for_status()
print(response.text)

const response = await fetch("https://toolswitch.dev/v1/tools/apollo.people.search?bodyType=json", {
  method: "POST",
  headers: {
    "X-Toolswitch-Key": process.env.TOOLSWITCH_KEY ?? "",
    "Content-Type": "application/json",
  },
  body: JSON.stringify(JSON.parse("{\"per_page\":3,\"person_titles\":[\"head of marketing\"],\"q_organization_domains_list\":[\"stripe.com\"]}")),
});
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
console.log(await response.text());

This gateway API is in preview; its URL and authentication may change. The example parameters are sample data. Calls are billed at free, including the service fee.