Search people by title, company, skills or location
pdl.people.searchSearch PDL people by title, company, seniority, skills or location — pays per record
- 价格
- $0.28/result按供应商原价
- 成功率
- 92.7%近 30 天 · 78 次
- 延迟 p50
- 223 毫秒p95 5.3 秒
- 最后验证
- 2026年7月31日实测可用
GEThttps://toolswitch.dev/v1/tools/pdl.people.search?sql=SELECT+*+FROM+person+WHERE+location_country%3D%27united+states%27&size=1预览- 可用平台额度调用
- 同步返回
- 读取公开数据
参数
exactly one of sql | query. GET caps `size` at 100, POST at 1000 — the only real difference between the two methods. Always set an explicit small size while iterating: you pay per record, so a size=100 call is a 100-credit call. Rate limit 10 req/min
| 参数 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| 查询参数 | ||||
sql | 字符串 | 可选 | SQL WHERE clause over the Person schema, e.g. "SELECT * FROM person WHERE job_title_role='engineering' AND location_country='united states'" | SELECT * FROM person WHERE location_country='united states' |
size | 整数 | 可选 | records to return, 1-100, default 1 — THIS IS THE PRICE DIAL: you pay 1 credit per record | 1 |
query | 字符串 | 可选 | Elasticsearch JSON query — the alternative to sql, more expressive | |
pretty | 布尔 | 可选 | ||
dataset | 字符串 | 可选 | restrict to a licensed dataset, e.g. resume, email, phone | |
titlecase | 布尔 | 可选 | ||
scroll_token | 字符串 | 可选 | cursor from the previous response, for paging past 100 | |
- 查询参数
sql字符串可选SQL WHERE clause over the Person schema, e.g. "SELECT * FROM person WHERE job_title_role='engineering' AND location_country='united states'"
示例：
SELECT * FROM person WHERE location_country='united states'size整数可选records to return, 1-100, default 1 — THIS IS THE PRICE DIAL: you pay 1 credit per record
示例：
1query字符串可选Elasticsearch JSON query — the alternative to sql, more expressive
pretty布尔可选dataset字符串可选restrict to a licensed dataset, e.g. resume, email, phone
titlecase布尔可选scroll_token字符串可选cursor from the previous response, for paging past 100
代码示例
将 $TOOLSWITCH_KEY 替换为你在控制台创建的密钥。
curl -X GET 'https://toolswitch.dev/v1/tools/pdl.people.search?sql=SELECT+*+FROM+person+WHERE+location_country%3D%27united+states%27&size=1' \
-H "X-Toolswitch-Key: $TOOLSWITCH_KEY"import os
import requests
response = requests.request(
"GET",
"https://toolswitch.dev/v1/tools/pdl.people.search?sql=SELECT+*+FROM+person+WHERE+location_country%3D%27united+states%27&size=1",
headers={"X-Toolswitch-Key": os.environ["TOOLSWITCH_KEY"]},
)
response.raise_for_status()
print(response.text)const response = await fetch("https://toolswitch.dev/v1/tools/pdl.people.search?sql=SELECT+*+FROM+person+WHERE+location_country%3D%27united+states%27&size=1", {
method: "GET",
headers: {
"X-Toolswitch-Key": process.env.TOOLSWITCH_KEY ?? "",
},
});
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
console.log(await response.text());网关接口为预览版，地址与鉴权方式可能调整。 示例参数仅为样例数据。 调用按 $0.28/result 计费，已含服务费。