Apollo.ioDados de pessoasEnrichment

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: freePelo preço do provedor
Success rate: 100%Last 30 days · 442.025 calls
Latency p50: 220 msp95 535 ms
Last verified: 29 de ago. de 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	Obrigatório	Descrição	Exemplo
Parâmetros de consulta
`page`	inteiro	Opcional	1-based; max 500 pages	`1`
`per_page`	inteiro	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]`	inteiro	Opcional	annual revenue ceiling
`revenue_range[min]`	inteiro	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
pageinteiroOpcional
1-based; max 500 pages
Exemplo: 1
per_pageinteiroOpcional
max 100
Exemplo: 1
person_titles[]array[string]Opcional
job titles, matched loosely (OR across the list)
Exemplo: ["head of marketing"]
person_locations[]array[string]Opcional
where the PERSON lives
Exemplo: ["California, US"]
revenue_range[max]inteiroOpcional
annual revenue ceiling
revenue_range[min]inteiroOpcional
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
Exemplo: ["apollo.io"]
organization_num_employees_ranges[]array[string]Opcional
employee-count bands as 'min,max' strings
Exemplo: ["1,10"]
currently_using_any_of_technology_uids[]array[string]Opcional
tech-stack filter, e.g. salesforce

Exemplos de código

Substitua $TOOLSWITCH_KEY pela chave criada no 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());

Esta API de gateway está em prévia; a URL e a autenticação podem mudar. Os parâmetros do exemplo são dados de amostra. As chamadas são cobradas a free, incluindo a taxa de serviço.