Search people by title, seniority, company or location
apollo.people.searchSearch Apollo's 200M+ contacts by title, seniority, company, location or tech (free)
- Price
- freeプロバイダー原価
- Success rate
- 100%Last 30 days · 442,025 calls
- Latency p50
- 220 msp95 535 ms
- Last verified
- 2026/08/29Verified working
POSThttps://toolswitch.dev/v1/tools/apollo.people.search?bodyType=jsonPreview- Uses platform quota
- Synchronous response
- Reads public data
パラメータ
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());このゲートウェイ API はプレビュー版です。URL や認証方式は変更される場合があります。 パラメータはサンプルデータです。 呼び出し料金は free です。サービス料を含みます。