Person Enrichment API

Person Enrichment Peopledatalabs API

用 People Data Labs 能匹配的任意标识，补全一位人员的工作邮箱、个人邮箱、手机号、完整工作经历、教育经历和雇主企业画像。

POST/v1/run/person_enrichment.peopledatalabs
可用率
100.00%
30d · 6 次调用
请求数
6
30d
响应时间
1.6s
中位数 · 30d

价格

一个价格，以美元计

调用方式

发出你的第一个请求

import os, requests

res = requests.post(
    "https://api.getanyapi.com/v1/run/person_enrichment.peopledatalabs",
    headers={"Authorization": f"Bearer {os.environ['ANYAPI_KEY']}"},
    json={},
)
print(res.json())
打开于
获取免费密钥
示例响应
{
  "data": {
    "activityScore": "example",
    "birthDate": "2024-01-15T09:30:00Z",
    "birthYear": 2024,
    "company": {
      "addressLine2": "123 Main St",
      "companyId": "Acme Inc",
      "continent": "example",
      "country": "US",
      "facebookUrl": "https://example.com/page",
      "founded": 42,
      "geo": "example",
      "industry": "general",
      "industryV2": "general",
      "linkedinId": "https://example.com/page",
      "linkedinUrl": "https://example.com/page",
      "locality": "example",
      "locationName": "Example title",
      "metro": "example",
      "name": "Example title",
      "postalCode": "94107",
      "region": "CA",
      "size": "example",
      "streetAddress": "123 Main St",
      "twitterUrl": "https://example.com/page",
      "website": "https://example.com/page"
    },
    "countries": [
      "example"
    ],
    "datasetVersion": "example",
    "education": [
      {
        "degrees": [
          "example"
        ],
        "endDate": "2024-01-15T09:30:00Z",
        "gpa": 12.5,
        "majors": [
          "example"
        ],
        "minors": [
          "example"
        ],
        "schoolId": "a1b2c3d4",
        "schoolLinkedinUrl": "https://example.com/page",
        "schoolLocationName": "Example title",
        "schoolName": "Example title",
        "schoolType": "general",
        "schoolWebsite": "https://example.com/page",
        "startDate": "2024-01-15T09:30:00Z"
      }
    ],
    "emails": [
      {
        "address": "123 Main St",
        "type": "general"
      }
    ],
    "experience": [
      {
        "companyContinent": "Acme Inc",
        "companyFacebookUrl": "https://example.com/page",
        "companyFounded": 42,
        "companyGeo": "Acme Inc",
        "companyId": "Acme Inc",
        "companyIndustry": "Acme Inc",
        "companyIndustryV2": "Acme Inc",
        "companyLinkedinId": "https://example.com/page",
        "companyLinkedinUrl": "https://example.com/page",
        "companyLocality": "Acme Inc",
        "companyLocationCountry": "Acme Inc",
        "companyLocationName": "Acme Inc",
        "companyMetro": "Acme Inc",
        "companyName": "Acme Inc",
        "companyPostalCode": "Acme Inc",
        "companyRegion": "Acme Inc",
        "companySize": "Acme Inc",
        "companyStreetAddress": "Acme Inc",
        "companyTwitterUrl": "https://example.com/page",
        "companyWebsite": "https://example.com/page",
        "endDate": "2024-01-15T09:30:00Z",
        "isPrimary": true,
        "locationNames": [
          "Example title"
        ],
        "startDate": "2024-01-15T09:30:00Z",
        "title": "Example title",
        "titleClass": "Example title",
        "titleLevels": [
          "Example title"
        ],
        "titleRole": "Example title",
        "titleSubRole": "Example title"
      }
    ],
    "facebookId": "a1b2c3d4",
    "facebookUrl": "https://example.com/page",
    "facebookUsername": "alex_rivera",
    "firstName": "Alex",
    "fullName": "Alex Rivera",
    "githubUrl": "https://example.com/page",
    "githubUsername": "alex_rivera",
    "industry": "general",
    "interests": [
      "example"
    ],
    "jobChangedUtc": 12.5,
    "jobStartDate": "2024-01-15T09:30:00Z",
    "jobTitle": "Example title",
    "jobTitleClass": "Example title",
    "jobTitleLevels": [
      "Example title"
    ],
    "jobTitleRole": "Example title",
    "jobTitleSubRole": "Example title",
    "jobVerifiedUtc": 12.5,
    "lastInitial": "example",
    "lastName": "Rivera",
    "linkedinId": "https://example.com/page",
    "linkedinUrl": "https://example.com/page",
    "linkedinUsername": "https://example.com/page",
    "location": {
      "addressLine2": "123 Main St",
      "continent": "example",
      "country": "US",
      "geo": "example",
      "locality": "example",
      "metro": "example",
      "name": "Example title",
      "postalCode": "94107",
      "region": "CA",
      "streetAddress": "123 Main St",
      "updatedUtc": 12.5
    },
    "locationNames": [
      "Example title"
    ],
    "middleInitial": "a1b2c3d4",
    "middleName": "Example title",
    "mobilePhone": "+1 555-0142",
    "pdlId": "a1b2c3d4",
    "personalEmails": [
      "alex@example.com"
    ],
    "phoneNumbers": [
      "+1 555-0142"
    ],
    "profileScore": "example",
    "profiles": [
      {
        "network": "example",
        "profileId": "a1b2c3d4",
        "url": "https://example.com/page",
        "username": "alex_rivera"
      }
    ],
    "recommendedPersonalEmail": "alex@example.com",
    "regions": [
      "CA"
    ],
    "sex": "example",
    "skills": [
      "example"
    ],
    "streetAddresses": [
      {
        "addressLine2": "123 Main St",
        "continent": "example",
        "country": "US",
        "geo": "example",
        "locality": "example",
        "metro": "example",
        "name": "Example title",
        "postalCode": "94107",
        "region": "CA",
        "streetAddress": "123 Main St"
      }
    ],
    "twitterUrl": "https://example.com/page",
    "twitterUsername": "alex_rivera",
    "workEmail": "alex@example.com"
  },
  "found": true,
  "reason": "not_found"
}
响应类型定义
interface PersonEnrichmentPeopledatalabsResponse {
  data: {
    activityScore?: string;
    birthDate?: string;
    birthYear?: number;
    company?: {
      addressLine2?: string;
      companyId?: string;
      continent?: string;
      country?: string;
      facebookUrl?: string;
      founded?: number;
      geo?: string;
      industry?: string;
      industryV2?: string;
      linkedinId?: string;
      linkedinUrl?: string;
      locality?: string;
      locationName?: string;
      metro?: string;
      name?: string;
      postalCode?: string;
      region?: string;
      size?: string;
      streetAddress?: string;
      twitterUrl?: string;
      website?: string;
    };
    countries?: string[];
    datasetVersion?: string;
    education?: {
      degrees?: string[];
      endDate?: string;
      gpa?: number;
      majors?: string[];
      minors?: string[];
      schoolId?: string;
      schoolLinkedinUrl?: string;
      schoolLocationName?: string;
      schoolName?: string;
      schoolType?: string;
      schoolWebsite?: string;
      startDate?: string;
    }[];
    emails?: {
      address: string;
      type?: string;
    }[];
    experience?: {
      companyContinent?: string;
      companyFacebookUrl?: string;
      companyFounded?: number;
      companyGeo?: string;
      companyId?: string;
      companyIndustry?: string;
      companyIndustryV2?: string;
      companyLinkedinId?: string;
      companyLinkedinUrl?: string;
      companyLocality?: string;
      companyLocationCountry?: string;
      companyLocationName?: string;
      companyMetro?: string;
      companyName?: string;
      companyPostalCode?: string;
      companyRegion?: string;
      companySize?: string;
      companyStreetAddress?: string;
      companyTwitterUrl?: string;
      companyWebsite?: string;
      endDate?: string;
      isPrimary?: boolean;
      locationNames?: string[];
      startDate?: string;
      title?: string;
      titleClass?: string;
      titleLevels?: string[];
      titleRole?: string;
      titleSubRole?: string;
    }[];
    facebookId?: string;
    facebookUrl?: string;
    facebookUsername?: string;
    firstName?: string;
    fullName: string;
    githubUrl?: string;
    githubUsername?: string;
    industry?: string;
    interests?: string[];
    jobChangedUtc?: number;
    jobStartDate?: string;
    jobTitle?: string;
    jobTitleClass?: string;
    jobTitleLevels?: string[];
    jobTitleRole?: string;
    jobTitleSubRole?: string;
    jobVerifiedUtc?: number;
    lastInitial?: string;
    lastName?: string;
    linkedinId?: string;
    linkedinUrl?: string;
    linkedinUsername?: string;
    location?: {
      addressLine2?: string;
      continent?: string;
      country?: string;
      geo?: string;
      locality?: string;
      metro?: string;
      name?: string;
      postalCode?: string;
      region?: string;
      streetAddress?: string;
      updatedUtc?: number;
    };
    locationNames?: string[];
    middleInitial?: string;
    middleName?: string;
    mobilePhone?: string;
    pdlId?: string;
    personalEmails?: string[];
    phoneNumbers?: string[];
    profileScore?: string;
    profiles?: {
      network: string;
      profileId?: string;
      url?: string;
      username?: string;
    }[];
    recommendedPersonalEmail?: string;
    regions?: string[];
    sex?: string;
    skills?: string[];
    streetAddresses?: {
      addressLine2?: string;
      continent?: string;
      country?: string;
      geo?: string;
      locality?: string;
      metro?: string;
      name?: string;
      postalCode?: string;
      region?: string;
      streetAddress?: string;
    }[];
    twitterUrl?: string;
    twitterUsername?: string;
    workEmail?: string;
  } | null;
  found: boolean;
  reason?: "not_found";
}

完整的参数与响应参考：这个接口的每个字段、类型和示例。

参考

请求、响应与价格

最近验证于 2026-09-29 · 可用率和延迟按 30d 统计
POST /v1/run/person_enrichment.peopledatalabs
curl -X POST https://api.getanyapi.com/v1/run/person_enrichment.peopledatalabs \
  -H "Authorization: Bearer $ANYAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"profile":"https://www.linkedin.com/in/dharmesh"}'
字段类型示例值
请求体
birthDatestring已知的出生日期，用于区分同名匹配。
companystring该人员任职过的公司名称、网站或社交媒体 URL。
countrystring用于匹配的国家。
dataIncludestring要包含的 People Data Labs 字段，用逗号分隔；以 - 开头则表示要排除的列表。字段投影只改变返回内容，不会降低这次调用的费用。
emailstring该人员用过的任意邮箱地址。
emailHashstring邮箱地址的 SHA-256 或 MD5 哈希，用于保护隐私的匹配。
firstNamestring名字。与 lastName 以及公司、学校或地点一起发送。
includeIfMatchedboolean报告传入的标识符中哪些实际匹配上了。
lastNamestring姓氏。与 firstName 以及公司、学校或地点一起发送。
linkedinIdstringLinkedIn 数字会员 ID（PDL 称之为 lid）。
localitystring用于匹配的城市或地区。
locationstring自由格式的地点字符串，例如 brookline, massachusetts, united states。
middleNamestring中间名。
minLikelihoodinteger匹配结果要计为找到，必须达到的 People Data Labs 最低可能性分数（likelihood）。省略时，此 SKU 发送 6；People Data Labs 的默认值是 2。
namestring全名，可替代 firstName 加 lastName。
pdlIdstringPeople Data Labs 的持久人员 ID，即此 SKU 的 pdlId 输出所返回的值。
phonestring国际格式的电话号码，例如 +16176695906。
postalCodestring用于匹配的邮政编码或 ZIP 码。
profilestring"https://www.linkedin.com/in/dharmesh"该人员用过的社交主页 URL，例如 LinkedIn、Twitter、Facebook 或 GitHub 主页。这是最强的单一标识。
regionstring用于匹配的州或地区。
requiredstring作用于顶层字段的 People Data Labs 布尔表达式，匹配结果必须满足，例如 personal_emails or (emails and phone_numbers)。
schoolstring该人员就读过的学校，用于区分同名匹配。
streetAddressstring用于匹配的街道地址。
titlecaseboolean以首字母大写的形式返回文本，而不是 People Data Labs 默认的小写。
响应
dataobjectThe enriched person, or null when nothing matched.
data.activityScorestringPeople Data Labs' qualitative score for how recently the profile showed activity.
data.birthDatestringDate of birth as People Data Labs reports it, YYYY-MM-DD.
data.birthYearintegerYear of birth.
data.companyobjectThe person's current employer.
data.company.addressLine2stringSecond line of the headquarters address.
data.company.companyIdstringPeople Data Labs company id.
data.company.continentstringHeadquarters continent.
data.company.countrystringHeadquarters country.
data.company.facebookUrlstringCompany Facebook page URL.
data.company.foundedintegerYear the company was founded.
data.company.geostringHeadquarters coordinates as "lat,lon".
data.company.industrystringCompany industry.
data.company.industryV2stringCompany industry on People Data Labs' newer taxonomy.
data.company.linkedinIdstringCompany LinkedIn numeric id.
data.company.linkedinUrlstringCompany LinkedIn page URL.
data.company.localitystringHeadquarters city.
data.company.locationNamestringHeadquarters location as one display string.
data.company.metrostringHeadquarters metro area.
data.company.namestringCompany name.
data.company.postalCodestringHeadquarters postal code.
data.company.regionstringHeadquarters state or region.
data.company.sizestringEmployee headcount band, e.g. 5001-10000.
data.company.streetAddressstringHeadquarters street address.
data.company.twitterUrlstringCompany X (Twitter) profile URL.
data.company.websitestringCompany website domain.
data.countriesstring[]Every country associated with the person.
data.datasetVersionstringVersion of the People Data Labs dataset this record came from.
data.educationobject[]Education history.
data.education[].degreesstring[]Degrees earned.
data.education[].endDatestringWhen study ended.
data.education[].gpanumberGrade point average, when the person published one.
data.education[].majorsstring[]Majors studied.
data.education[].minorsstring[]Minors studied.
data.education[].schoolIdstringPeople Data Labs school id.
data.education[].schoolLinkedinUrlstringSchool LinkedIn page URL.
data.education[].schoolLocationNamestringSchool location as one display string.
data.education[].schoolNamestringSchool name.
data.education[].schoolTypestringSchool type, e.g. post-secondary institution.
data.education[].schoolWebsitestringSchool website domain.
data.education[].startDatestringWhen study started: YYYY, YYYY-MM or YYYY-MM-DD.
data.emailsobject[]Every email address held for the person, with its kind.
data.emails[].addressstringEmail address.
data.emails[].typestringAddress kind, e.g. professional or personal.
data.experienceobject[]Work history, most relevant first.
data.experience[].companyContinentstringEmployer headquarters continent.
data.experience[].companyFacebookUrlstringEmployer Facebook page URL.
data.experience[].companyFoundedintegerYear the employer was founded.
data.experience[].companyGeostringEmployer headquarters coordinates as "lat,lon".
data.experience[].companyIdstringPeople Data Labs company id for the employer.
data.experience[].companyIndustrystringEmployer industry.
data.experience[].companyIndustryV2stringEmployer industry on the newer PeopleDataLabs taxonomy.
data.experience[].companyLinkedinIdstringEmployer LinkedIn numeric id.
data.experience[].companyLinkedinUrlstringEmployer LinkedIn page URL.
data.experience[].companyLocalitystringEmployer headquarters locality.
data.experience[].companyLocationCountrystringEmployer headquarters country.
data.experience[].companyLocationNamestringEmployer headquarters as one display string.
data.experience[].companyMetrostringEmployer headquarters metro area.
data.experience[].companyNamestringEmployer name.
data.experience[].companyPostalCodestringEmployer headquarters postal code.
data.experience[].companyRegionstringEmployer headquarters region or state.
data.experience[].companySizestringEmployer headcount band.
data.experience[].companyStreetAddressstringEmployer headquarters street address.
data.experience[].companyTwitterUrlstringEmployer X or Twitter profile URL.
data.experience[].companyWebsitestringEmployer website domain.
data.experience[].endDatestringWhen the role ended, absent while the role is current.
data.experience[].isPrimarybooleanTrue for the role People Data Labs treats as current.
data.experience[].locationNamesstring[]Where the role was based.
data.experience[].startDatestringWhen the role started: YYYY, YYYY-MM or YYYY-MM-DD.
data.experience[].titlestringJob title held.
data.experience[].titleClassstringNormalized title class.
data.experience[].titleLevelsstring[]Seniority levels for the title.
data.experience[].titleRolestringNormalized role for the title.
data.experience[].titleSubRolestringNormalized sub-role for the title.
data.facebookIdstringFacebook numeric id.
data.facebookUrlstringFacebook profile URL.
data.facebookUsernamestringFacebook handle.
data.firstNamestringFirst name.
data.fullNamestringPerson's full name.
data.githubUrlstringGitHub profile URL.
data.githubUsernamestringGitHub handle.
data.industrystringIndustry the person works in.
data.interestsstring[]Interests the person lists.
data.jobChangedUtcnumberUTC epoch timestamp in seconds (Unix time) the person last changed jobs. Multiply by 1000 for a JS Date in milliseconds.
data.jobStartDatestringWhen the current role started, as People Data Labs reports it: YYYY, YYYY-MM or YYYY-MM-DD.
data.jobTitlestringCurrent job title.
data.jobTitleClassstringNormalized title class, e.g. research_and_development.
data.jobTitleLevelsstring[]Seniority levels for the current title, e.g. cxo, owner.
data.jobTitleRolestringNormalized role for the current title, e.g. engineering.
data.jobTitleSubRolestringNormalized sub-role for the current title.
data.jobVerifiedUtcnumberUTC epoch timestamp in seconds (Unix time) the current role was last verified. Multiply by 1000 for a JS Date in milliseconds.
data.lastInitialstringLast initial.
data.lastNamestringLast name.
data.linkedinIdstringLinkedIn numeric member id.
data.linkedinUrlstringLinkedIn profile URL.
data.linkedinUsernamestringLinkedIn vanity handle.
data.locationobjectWhere the person lives.
data.location.addressLine2stringSecond line of the address.
data.location.continentstringContinent.
data.location.countrystringCountry.
data.location.geostringCoordinates as "lat,lon".
data.location.localitystringCity.
data.location.metrostringMetro area.
data.location.namestringLocation as one display string.
data.location.postalCodestringPostal code.
data.location.regionstringState or region.
data.location.streetAddressstringStreet address.
data.location.updatedUtcnumberUTC epoch timestamp in seconds (Unix time) the location was last updated. Multiply by 1000 for a JS Date in milliseconds.
data.locationNamesstring[]Every location People Data Labs has associated with the person.
data.middleInitialstringMiddle initial.
data.middleNamestringMiddle name.
data.mobilePhonestringMobile phone number in international form.
data.pdlIdstringPeople Data Labs persistent person id. Send it back as this SKU's pdlId input.
data.personalEmailsstring[]Personal email addresses.
data.phoneNumbersstring[]Every phone number held for the person.
data.profileScorestringPeople Data Labs' qualitative score for how complete the profile is.
data.profilesobject[]Every social profile linked to the person.
data.profiles[].networkstringNetwork name, e.g. linkedin, github, twitter.
data.profiles[].profileIdstringNetwork's own id for the profile.
data.profiles[].urlstringProfile URL.
data.profiles[].usernamestringHandle on that network.
data.recommendedPersonalEmailstringThe personal address People Data Labs recommends reaching the person at.
data.regionsstring[]Every region associated with the person.
data.sexstringSex recorded for the person.
data.skillsstring[]Skills the person lists.
data.streetAddressesobject[]Every street address associated with the person.
data.streetAddresses[].addressLine2stringSecond line of the address.
data.streetAddresses[].continentstringContinent.
data.streetAddresses[].countrystringCountry.
data.streetAddresses[].geostringCoordinates as "lat,lon".
data.streetAddresses[].localitystringCity.
data.streetAddresses[].metrostringMetro area.
data.streetAddresses[].namestringAddress location as one display string.
data.streetAddresses[].postalCodestringPostal code.
data.streetAddresses[].regionstringState or region.
data.streetAddresses[].streetAddressstringStreet address.
data.twitterUrlstringX (Twitter) profile URL.
data.twitterUsernamestringX (Twitter) handle.
data.workEmailstringBest work email address.
foundbooleanFalse when People Data Labs matched no person above the likelihood threshold.
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.
价格
每次请求价格USDUS$0.24
价格（/千次请求）USDUS$240.00

常见问题

关于 Person Enrichment Peopledatalabs API

AnyAPI 的 Person Enrichment Peopledatalabs API 只需一次 POST 请求 /v1/run/person_enrichment.peopledatalabs，就以统一格式的 JSON 返回 Person Enrichment 数据。用 People Data Labs 能匹配的任意标识，补全一位人员的工作邮箱、个人邮箱、手机号、完整工作经历、教育经历和雇主企业画像。无论哪个数据源提供服务，AnyAPI 都返回同一套统一的 schema。费用：每千次请求 US$240 起，以美元计价，无需订阅，也没有每月最低消费。过去 30 天，通过 AnyAPI 发起的 Person Enrichment Peopledatalabs API 调用中有 100.0% 成功，响应时间中位数为 1.6 秒，共测量 6 次调用。

费用：每千次请求 US$240 起，以美元计价，无需订阅，也没有每月最低消费。你只需为一个美元钱包充值，每次调用从中扣费。部分由钱包付费的失败请求会产生处理费用，我们按成本原价转嫁，不加价；错误响应会显示收取的金额。

用 People Data Labs 能匹配的任意标识，补全一位人员的工作邮箱、个人邮箱、手机号、完整工作经历、教育经历和雇主企业画像。响应是统一格式的 JSON，外层结构与每个 AnyAPI 接口相同，所以解析另一个接口只需换一个 URL，别的都不用改。

过去 30 天，通过 AnyAPI 发起的 Person Enrichment Peopledatalabs API 调用中有 100.0% 成功，响应时间中位数为 1.6 秒，共测量 6 次调用。这些是 AnyAPI 对经过网关的流量的自有测量，持续重新计算，并非公开承诺的服务等级目标。
更多接口

Person Enrichment 的其他接口

Bettercontact/千次请求 US$82.80 起Crustdata v3/千次请求 US$96.00 起Fullenrich 批量/千条结果 US$100.80 起Fullenrich 邮箱反查/千条结果 US$100.80 起Lusha/千次请求 US$84.00 起Prospeo/千次请求 US$66.00 起Quickenrich/千次请求 US$7.20 起