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. 8. 29.Verified 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이며 서비스 수수료가 포함되어 있습니다.