Apollo.ioPersonendatenEnrichment

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: freeZum Anbieterpreis
Success rate: 100 %Last 30 days · 442.025 calls
Latency p50: 220 msp95 535 ms
Last verified: 29.08.2026Verified working

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

Uses platform quota
Synchronous response
Reads public data

Parameter

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	Typ	Erforderlich	Beschreibung	Beispiel
Abfrageparameter
`page`	Ganzzahl	Optional	1-based; max 500 pages	`1`
`per_page`	Ganzzahl	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]`	Ganzzahl	Optional	annual revenue ceiling
`revenue_range[min]`	Ganzzahl	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

Abfrageparameter
pageGanzzahlOptional
1-based; max 500 pages
Beispiel: 1
per_pageGanzzahlOptional
max 100
Beispiel: 1
person_titles[]array[string]Optional
job titles, matched loosely (OR across the list)
Beispiel: ["head of marketing"]
person_locations[]array[string]Optional
where the PERSON lives
Beispiel: ["California, US"]
revenue_range[max]GanzzahlOptional
annual revenue ceiling
revenue_range[min]GanzzahlOptional
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
Beispiel: ["apollo.io"]
organization_num_employees_ranges[]array[string]Optional
employee-count bands as 'min,max' strings
Beispiel: ["1,10"]
currently_using_any_of_technology_uids[]array[string]Optional
tech-stack filter, e.g. salesforce

Codebeispiele

Ersetze $TOOLSWITCH_KEY durch den in der Konsole erstellten Schlüssel.

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());

Diese Gateway-API ist eine Vorschauversion; URL und Authentifizierung können sich ändern. Die Beispielparameter sind Musterdaten. Aufrufe werden mit free einschließlich Servicegebühr abgerechnet.