Search people by title, seniority, company or location
apollo.people.searchSearch Apollo's 200M+ contacts by title, seniority, company, location or tech (free)
- 价格
- free按供应商原价
- 成功率
- 100%近 30 天 · 442,025 次
- 延迟 p50
- 220 毫秒p95 535 毫秒
- 最后验证
- 2026年8月29日实测可用
POSThttps://toolswitch.dev/v1/tools/apollo.people.search?bodyType=json预览- 可用平台额度调用
- 同步返回
- 读取公开数据
参数
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
| 参数 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| 查询参数 | ||||
page | 整数 | 可选 | 1-based; max 500 pages | 1 |
per_page | 整数 | 可选 | max 100 | 1 |
person_titles[] | array[string] | 可选 | job titles, matched loosely (OR across the list) | ["head of marketing"] |
person_locations[] | array[string] | 可选 | where the PERSON lives | ["California, US"] |
revenue_range[max] | 整数 | 可选 | annual revenue ceiling | |
revenue_range[min] | 整数 | 可选 | annual revenue floor, integer with no symbols | |
person_seniorities[] | array[string] | 可选 | owner, founder, c_suite, partner, vp, head, director, manager, senior, entry, intern | |
contact_email_status[] | array[string] | 可选 | verified, unverified, likely to engage, unavailable | |
organization_locations[] | array[string] | 可选 | where their COMPANY's HQ is | |
q_organization_domains_list[] | array[string] | 可选 | restrict to employees of these company domains; max 1,000 | ["apollo.io"] |
organization_num_employees_ranges[] | array[string] | 可选 | employee-count bands as 'min,max' strings | ["1,10"] |
currently_using_any_of_technology_uids[] | array[string] | 可选 | tech-stack filter, e.g. salesforce | |
- 查询参数
page整数可选1-based; max 500 pages
示例：
1per_page整数可选max 100
示例：
1person_titles[]array[string]可选job titles, matched loosely (OR across the list)
示例：
["head of marketing"]person_locations[]array[string]可选where the PERSON lives
示例：
["California, US"]revenue_range[max]整数可选annual revenue ceiling
revenue_range[min]整数可选annual revenue floor, integer with no symbols
person_seniorities[]array[string]可选owner, founder, c_suite, partner, vp, head, director, manager, senior, entry, intern
contact_email_status[]array[string]可选verified, unverified, likely to engage, unavailable
organization_locations[]array[string]可选where their COMPANY's HQ is
q_organization_domains_list[]array[string]可选restrict to employees of these company domains; max 1,000
示例：
["apollo.io"]organization_num_employees_ranges[]array[string]可选employee-count bands as 'min,max' strings
示例：
["1,10"]currently_using_any_of_technology_uids[]array[string]可选tech-stack filter, e.g. salesforce
代码示例
将 $TOOLSWITCH_KEY 替换为你在控制台创建的密钥。
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());网关接口为预览版，地址与鉴权方式可能调整。 示例参数仅为样例数据。 调用按 free 计费，已含服务费。