People Search Peopledatalabs API
用 SQL 或 Elasticsearch 查询搜索 People Data Labs 的人员数据集。结果包含职业和企业画像记录，以及联系数据的可用性标记；如需获取实际的邮箱和电话，请使用 Person Enrichment - People Data Labs。按返回的档案数扣费。
US$168.00/千条结果，按请求付费，无需订阅。
SELECT * FROM person WHERE
job_title_role='engineering' AND job_company_website='vercel.com'
{"fullName": "Marcus Ridgeway","pdlId": "pdl_p_9c1f2a7e","firstName": "Marcus","lastName": "Ridgeway","middleInitial": "T","lastInitial": "R","sex": "male","linkedinUrl": "https://www.linkedin.com/in/marcusridgeway",... 还有 54 个字段}
价格
People Search Peopledatalabs API 价格
调用方式
一个请求获取 People Search Peopledatalabs
import os, requests res = requests.post( "https://api.getanyapi.com/v1/run/people_search.peopledatalabs", headers={"Authorization": f"Bearer {os.environ['ANYAPI_KEY']}"}, json={ "limit": 1, "sql": "SELECT * FROM person WHERE job_company_website = 'posthog.com'" }, ) print(res.json())
这个示例展示了 125 个字段中的 97 个。查看全部字段
{
"found": true,
"data": {
"people": [
{
"fullName": "Marcus Ridgeway",
"pdlId": "pdl_p_9c1f2a7e",
"firstName": "Marcus",
"lastName": "Ridgeway",
"middleInitial": "T",
"lastInitial": "R",
"sex": "male",
"linkedinUrl": "https://www.linkedin.com/in/marcusridgeway",
"linkedinUsername": "marcusridgeway",
"linkedinId": "558812093",
"emails": [
{
"type": "professional"
},
{
"type": "personal"
}
],
"industry": "computer software",
"jobTitle": "Staff Software Engineer",
"jobTitleRole": "engineering",
"jobTitleSubRole": "backend",
"jobTitleClass": "individual_contributor",
"jobTitleLevels": [
"senior",
"staff"
],
"jobStartDate": "2022-03",
"jobChangedUtc": 1646092800,
"jobVerifiedUtc": 1737936000,
"companyId": "pdl_co_4471",
"companyName": "Vercel",
"companyWebsite": "vercel.com",
"companySize": "251-500",
"companyFounded": 2015,
"companyIndustry": "internet",
"companyIndustryV2": "software development",
"companyLinkedinUrl": "https://www.linkedin.com/company/vercel",
"companyLinkedinId": "3020450",
"companyLocationName": "San Francisco, California, United States",
"companyLocationCountry": "united states",
"companyLocality": "San Francisco",
"companyMetro": "san francisco",
"companyRegion": "California",
"companyContinent": "north america",
"locationName": "Oakland, California, United States",
"locality": "Oakland",
"metro": "san francisco",
"region": "California",
"country": "united states",
"continent": "north america",
"postalCode": "94612",
"geo": "37.80,-122.27",
"interests": [
"distributed systems",
"rock climbing"
],
"skills": [
"Go",
"Kubernetes",
"PostgreSQL"
],
"experience": [
{
"title": "Staff Software Engineer",
"titleRole": "engineering",
"titleLevels": [
"senior",
"staff"
],
"startDate": "2022-03",
"isPrimary": true,
"companyName": "Vercel",
"companyId": "pdl_co_4471",
"companySize": "251-500",
"companyIndustry": "internet",
"companyWebsite": "vercel.com"
},
{
"title": "Senior Software Engineer",
"titleRole": "engineering",
"startDate": "2019-06",
"endDate": "2022-02",
"isPrimary": false,
"companyName": "Cloudflare",
"companyId": "pdl_co_2290",
"companySize": "1001-5000",
"companyIndustry": "computer software",
"companyWebsite": "cloudflare.com"
}
],
"education": [
{
"schoolName": "University of Washington",
"schoolType": "post-secondary institution",
"schoolWebsite": "washington.edu",
"degrees": [
"Bachelor of Science"
],
"majors": [
"Computer Science"
],
"startDate": "2011",
"endDate": "2015"
}
],
"profiles": [
{
"network": "linkedin"
},
{
"network": "github"
}
],
"profileScore": "high",
"activityScore": "high",
"locationUpdatedUtc": 1735689600,
"available": {
"workEmail": true,
"personalEmails": true,
"recommendedPersonalEmail": false,
"mobilePhone": true,
"phoneNumbers": true,
"birthYear": false,
"birthDate": false,
"facebookUrl": false,
"facebookUsername": false,
"facebookId": false,
"twitterUrl": true,
"twitterUsername": true,
"githubUrl": true,
"githubUsername": true,
"streetAddresses": false,
"locationStreetAddress": false,
"locationAddressLine2": false
},
"locationNames": [
"Oakland, California, United States",
"Seattle, Washington, United States"
],
"regions": [
"California",
"Washington"
],
"countries": [
"united states"
]
},
{
"fullName": "Priya Anand",
"pdlId": "pdl_p_71ac930d",
"firstName": "Priya",
"lastName": "Anand",
"linkedinUrl": "https://www.linkedin.com/in/priyaanand",
"linkedinUsername": "priyaanand",
"emails": [
{
"type": "professional"
}
],
"jobTitle": "Software Engineer II",
"jobTitleRole": "engineering",
"jobTitleLevels": [
"mid"
],
"jobStartDate": "2023-09",
"companyId": "pdl_co_4471",
"companyName": "Vercel",
"companyWebsite": "vercel.com",
"companySize": "251-500",
"locationName": "New York, New York, United States",
"locality": "New York",
"region": "New York",
"country": "united states",
"profiles": [
{
"network": "linkedin"
}
],
"profileScore": "medium",
"available": {
"workEmail": true,
"personalEmails": false,
"mobilePhone": false,
"phoneNumbers": false,
"twitterUrl": false,
"githubUrl": true,
"githubUsername": true
}
}
],
"total": 47,
"datasetVersion": "23.5"
}
}完整的参数与响应参考：这个接口的每个字段、类型和示例。
参考
一个请求，一种响应结构。
你发送的每个字段和收到的每个字段，都附有真实示例。
最近验证于 2026-11-14 · 可用率和延迟按 30d 统计
请求体
JSON，POST 到这个接口。
- dataIncludestring
要包含的 People Data Labs 字段，以逗号分隔；或以 - 开头列出要排除的字段。投影只改变返回内容；扣费仍按返回的档案数计算。
- datasetstring
要搜索的 People Data Labs 数据集，适用于你的套餐提供多个数据集的情况。
- limitinteger
2
最多返回的档案数。每个返回的档案都会扣费，因此先设为 1 检查查询，读取 total 后再请求更多。
- queryobject
针对 People Data Labs 人员数据集的 Elasticsearch 风格查询，例如 {"bool": {"must": [{"term": {"job_company_website": "posthog.com"}}]}}。传此字段或 sql，不能同时传。
- sqlstring
SELECT * FROM person WHERE job_title_role='engineering' AND job_company_website='vercel.com'
People Data Labs SQL，格式为 SELECT * FROM person WHERE ... 。字符串字面量使用单引号，仅支持 SELECT *，字段名必须是真实的 People Data Labs 人员字段，包括嵌套子字段，例如 experience.title.name。不要包含 LIMIT 子句；People Data Labs 会拒绝它。请改用 limit。传此字段或 query，不能同时传。
- titlecaseboolean
true
以首字母大写的形式返回文本，而不是 People Data Labs 默认的小写。
响应
JSON，每个字段一个示例值。
The matching profiles plus the total the query matched. People Data Labs paginates with a scroll token that is not exposed here, so a call returns one page and total tells you how much is behind it.
- datasetVersionstring
23.5
Version of the People Data Labs dataset these records came from.
- totalinteger
47
Profiles matching the query across the whole dataset, not just this page.
Matching person profiles, up to limit.
- activityScorestring
high
People Data Labs' qualitative score for how recently the profile showed activity.
- companyAddressLine2string
Second line of the current employer's headquarters address.
- companyContinentstring
north america
Current employer headquarters continent.
- companyFacebookUrlstring
Current employer Facebook page URL.
- companyFoundedinteger
2015
Year the current employer was founded.
- companyGeostring
Current employer headquarters coordinates as "lat,lon".
- companyIdstring
pdl_co_4471
People Data Labs company id for the current employer.
- companyIndustrystring
internet
Current employer industry.
- companyIndustryV2string
software development
Current employer industry on People Data Labs' newer taxonomy.
- companyLinkedinIdstring
3020450
Current employer LinkedIn numeric id.
- companyLinkedinUrlstring
https://www.linkedin.com/company/vercel
Current employer LinkedIn page URL.
- companyLocalitystring
San Francisco
Current employer headquarters city.
- companyLocationCountrystring
united states
Current employer headquarters country.
- companyLocationNamestring
San Francisco, California, United States
Current employer headquarters as one display string.
- companyMetrostring
san francisco
Current employer headquarters metro area.
- companyNamestring
Vercel
Current employer name.
- companyPostalCodestring
Current employer headquarters postal code.
- companyRegionstring
California
Current employer headquarters state or region.
- companySizestring
251-500
Current employer headcount band.
- companyStreetAddressstring
Current employer headquarters street address.
- companyTwitterUrlstring
Current employer X (Twitter) profile URL.
- companyWebsitestring
vercel.com
Current employer website domain.
- continentstring
north america
Continent.
- countriesstring[]
Every country associated with the person.
- countrystring
united states
Country.
- firstNamestring
Marcus
First name.
- fullNamestring
Marcus Ridgeway
Person's full name.
- geostring
37.80,-122.27
Coordinates as "lat,lon".
- industrystring
computer software
Industry the person works in.
- interestsstring[]
Interests the person lists.
- jobChangedUtcnumber
1646092800
UTC epoch timestamp in seconds (Unix time) the person last changed jobs. Multiply by 1000 for a JS Date in milliseconds.
- jobStartDatestring
2022-03
When the current role started: YYYY, YYYY-MM or YYYY-MM-DD.
- jobTitlestring
Staff Software Engineer
Current job title.
- jobTitleClassstring
individual_contributor
Normalized title class.
- jobTitleLevelsstring[]
Seniority levels for the current title.
- jobTitleRolestring
engineering
Normalized role for the current title.
- jobTitleSubRolestring
backend
Normalized sub-role for the current title.
- jobVerifiedUtcnumber
1737936000
UTC epoch timestamp in seconds (Unix time) the current role was last verified. Multiply by 1000 for a JS Date in milliseconds.
- lastInitialstring
R
Last initial.
- lastNamestring
Ridgeway
Last name.
- linkedinIdstring
558812093
LinkedIn numeric member id.
- linkedinUrlstring
https://www.linkedin.com/in/marcusridgeway
LinkedIn profile URL.
- linkedinUsernamestring
marcusridgeway
LinkedIn vanity handle.
- localitystring
Oakland
City.
- locationNamestring
Oakland, California, United States
Where the person lives, as one display string.
- locationNamesstring[]
Every location People Data Labs has associated with the person.
- locationUpdatedUtcnumber
1735689600
UTC epoch timestamp in seconds (Unix time) the person's location was last updated. Multiply by 1000 for a JS Date in milliseconds.
- metrostring
san francisco
Metro area.
- middleInitialstring
T
Middle initial.
- middleNamestring
Middle name.
- pdlIdstring
pdl_p_9c1f2a7e
People Data Labs persistent person id. Send it to Person Enrichment - People Data Labs to re-pull this record.
- postalCodestring
94612
Postal code.
- profileScorestring
high
People Data Labs' qualitative score for how complete the profile is.
- regionstring
California
State or region.
- regionsstring[]
Every region associated with the person.
- sexstring
male
Sex recorded for the person.
- skillsstring[]
Skills the person lists.
What People Data Labs holds for this person but does not return in search. Each flag is true when Person Enrichment - People Data Labs would return that field for this profile.
- birthDateboolean
false
A birth date is available.
- birthYearboolean
false
A birth year is available.
- facebookIdboolean
false
A Facebook numeric id is available.
- facebookUrlboolean
false
A Facebook profile URL is available.
- facebookUsernameboolean
false
A Facebook handle is available.
- githubUrlboolean
true
A GitHub profile URL is available.
- githubUsernameboolean
true
A GitHub handle is available.
- locationAddressLine2boolean
false
A second address line is available.
- locationStreetAddressboolean
false
The current street address is available.
- mobilePhoneboolean
true
A mobile phone number is available.
- personalEmailsboolean
true
Personal email addresses are available.
- phoneNumbersboolean
true
Phone numbers are available.
- recommendedPersonalEmailboolean
false
A recommended personal email address is available.
- streetAddressesboolean
false
Street addresses are available.
- twitterUrlboolean
true
An X (Twitter) profile URL is available.
- twitterUsernameboolean
true
An X (Twitter) handle is available.
- workEmailboolean
true
A work email address is available.
Education history.
- degreesstring[]
Degrees earned.
- endDatestring
2015
When study ended.
- gpanumber
Grade point average, when published.
- majorsstring[]
Majors studied.
- minorsstring[]
Minors studied.
- schoolIdstring
PeopleDataLabs identifier for the school.
- schoolLinkedinUrlstring
School LinkedIn page URL.
- schoolLocationNamestring
School location as one display string.
- schoolNamestring
University of Washington
School name.
- schoolTypestring
post-secondary institution
School type.
- schoolWebsitestring
washington.edu
School website domain.
- startDatestring
2011
When study started.
One entry per email address People Data Labs holds for the person. Search returns the kind only; the address itself comes from Person Enrichment - People Data Labs.
- typestring
professional
Address kind, e.g. professional or personal.
Work history.
- companyContinentstring
Employer headquarters continent.
- companyFacebookUrlstring
Employer Facebook page URL.
- companyFoundedinteger
Year the employer was founded.
- companyGeostring
Employer headquarters coordinates as "lat,lon".
- companyIdstring
pdl_co_4471
People Data Labs company id for the employer.
- companyIndustrystring
internet
Employer industry.
- companyIndustryV2string
Employer industry on the newer PeopleDataLabs taxonomy.
- companyLinkedinIdstring
Employer LinkedIn numeric id.
- companyLinkedinUrlstring
Employer LinkedIn page URL.
- companyLocalitystring
Employer headquarters locality.
- companyLocationCountrystring
Employer headquarters country.
- companyLocationNamestring
Employer headquarters location as one display string.
- companyMetrostring
Employer headquarters metro area.
- companyNamestring
Vercel
Employer name.
- companyRegionstring
Employer headquarters region or state.
- companySizestring
251-500
Employer headcount band.
- companyTwitterUrlstring
Employer X or Twitter profile URL.
- companyWebsitestring
vercel.com
Employer website domain.
- endDatestring
When the role ended, absent while the role is current.
- isPrimaryboolean
true
True for the role People Data Labs treats as current.
- startDatestring
2022-03
When the role started: YYYY, YYYY-MM or YYYY-MM-DD.
- titlestring
Staff Software Engineer
Job title held.
- titleClassstring
Normalized job class.
- titleLevelsstring[]
Seniority levels for the title.
- titleRolestring
engineering
Normalized role for the title.
- titleSubRolestring
Normalized job sub-role.
Networks People Data Labs has a profile for. Search returns the network name only; profile URLs and handles come from Person Enrichment - People Data Labs.
- networkstring
linkedin
Network name, e.g. linkedin, facebook, twitter.
- foundboolean
true
False when the query matched no profile.
- reason"not_found"
Present only when `found` is false, and says why there is no result. `not_found`: the source states the target does not exist, or returned nothing for it. A `found: false` answer is a successful call, not an error, and `costUsd` is what it actually cost.
常见问题
关于 People Search Peopledatalabs API
AnyAPI 的 People Search Peopledatalabs API 只需一次 POST 请求 /v1/run/people_search.peopledatalabs，就以统一格式的 JSON 返回 People Search 数据。用 SQL 或 Elasticsearch 查询搜索 People Data Labs 的人员数据集。结果包含职业和企业画像记录，以及联系数据的可用性标记；如需获取实际的邮箱和电话，请使用 Person Enrichment - People Data Labs。按返回的档案数扣费。无论哪个数据源提供服务，AnyAPI 都返回同一套统一的 schema。费用：每千条结果 US$168，单次请求最多 US$9.91，以美元计价，无需订阅，也没有每月最低消费。过去 30 天，通过 AnyAPI 发起的 People Search Peopledatalabs API 调用中有 100.0% 成功，响应时间中位数为 2.3 秒，共测量 19 次调用。