Apollo.ioDatos de personasEnrichment

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: freeAl precio del proveedor
Success rate: 100 %Last 30 days · 442.025 calls
Latency p50: 220 msp95 535 ms
Last verified: 29 ago 2026Verified working

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

Uses platform quota
Synchronous response
Reads public data

Parámetros

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

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

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

Ejemplos de código

Sustituye $TOOLSWITCH_KEY por la clave que creaste en la consola.

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

La API de la pasarela está en versión preliminar; su URL y autenticación pueden cambiar. Los parámetros del ejemplo son datos de muestra. Las llamadas se facturan a free, incluida la tarifa de servicio.