Catalog/Person Enrichment/Peopledatalabs

POST

Person Enrichment Peopledatalabs API

/v1/run/person_enrichment.peopledatalabs

Enrich one person into work email, personal emails, mobile phone, full work history, education and employer firmographics from any identifier People Data Labs can match on.

Category enrichmentRequests / mo -Routing 1 lane · no failover

Get ~100 free requests

Pricing

One price, in dollars

pay per request · no subscription · fallbacks added as the catalog grows

Request

Gateway request

discovered operation

↓

Router

↓

Providers · 1

Dolphin- served- uptime- p50---$240.00/1k reqflat

↳ One lane serves this endpoint today, so a failed call has nowhere to fail over to. Failed attempts are never billed. Uptime, latency and traffic are measured through the gateway, last 30 days.

Call it

Make your first request

POST /v1/run/person_enrichment.peopledatalabs · same shape for every API

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())

Open inPrompt copied

Get a free key

Sample response

{
  "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": [
      {
        "companyFounded": 42,
        "companyId": "Acme Inc",
        "companyIndustry": "Acme Inc",
        "companyLinkedinUrl": "https://example.com/page",
        "companyLocationName": "Acme Inc",
        "companyName": "Acme Inc",
        "companySize": "Acme Inc",
        "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
}

Response interface

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?: {
      companyFounded?: number;
      companyId?: string;
      companyIndustry?: string;
      companyLinkedinUrl?: string;
      companyLocationName?: string;
      companyName?: string;
      companySize?: 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;
}

Full parameter and response reference - every field, type, and example for this endpoint.

Reference

Request, response, and price

Last verified 2026-09-03 · uptime and latency measured over 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"}'

Field	Type	Example value
Request body
birthDate	string	Known birth date, to disambiguate a name match.
company	string	Company name, website or social URL where the person has worked.
country	string	Country to match on.
dataInclude	string	Comma-separated People Data Labs fields to include, or a leading - list to exclude. Projection changes the payload only; it does not reduce what the call costs.
email	string	Any email address the person has used.
emailHash	string	SHA-256 or MD5 hash of an email address, for privacy-preserving matching.
firstName	string	First name. Send with lastName plus company, school or location.
includeIfMatched	boolean	Report which of the sent identifiers actually matched.
lastName	string	Last name. Send with firstName plus company, school or location.
linkedinId	string	LinkedIn numeric member id (PDL calls this lid).
locality	string	City or locality to match on.
location	string	Free-form location string, e.g. brookline, massachusetts, united states.
middleName	string	Middle name.
minLikelihood	integer	Minimum People Data Labs likelihood score a match must reach to count as found. Omitted, this SKU sends 6; the People Data Labs default is 2.
name	string	Full name, as an alternative to firstName plus lastName.
pdlId	string	People Data Labs persistent person id, as returned by this SKU's pdlId output.
phone	string	Phone number in international form, e.g. +16176695906.
postalCode	string	Postal or ZIP code to match on.
profile	string	"https://www.linkedin.com/in/dharmesh"Social profile URL the person has used, e.g. a LinkedIn, Twitter, Facebook or GitHub profile. The strongest single identifier.
region	string	State or region to match on.
required	string	People Data Labs boolean expression over top-level fields that a match must satisfy, e.g. personal_emails or (emails and phone_numbers).
school	string	School the person attended, used to disambiguate a name match.
streetAddress	string	Street address to match on.
titlecase	boolean	Return text in title case instead of People Data Labs' lowercase default.
Response
data	object	The enriched person, or null when nothing matched.
data.activityScore	string	People Data Labs' qualitative score for how recently the profile showed activity.
data.birthDate	string	Date of birth as People Data Labs reports it, YYYY-MM-DD.
data.birthYear	integer	Year of birth.
data.company	object	The person's current employer.
data.company.addressLine2	string	Second line of the headquarters address.
data.company.companyId	string	People Data Labs company id.
data.company.continent	string	Headquarters continent.
data.company.country	string	Headquarters country.
data.company.facebookUrl	string	Company Facebook page URL.
data.company.founded	integer	Year the company was founded.
data.company.geo	string	Headquarters coordinates as "lat,lon".
data.company.industry	string	Company industry.
data.company.industryV2	string	Company industry on People Data Labs' newer taxonomy.
data.company.linkedinId	string	Company LinkedIn numeric id.
data.company.linkedinUrl	string	Company LinkedIn page URL.
data.company.locality	string	Headquarters city.
data.company.locationName	string	Headquarters location as one display string.
data.company.metro	string	Headquarters metro area.
data.company.name	string	Company name.
data.company.postalCode	string	Headquarters postal code.
data.company.region	string	Headquarters state or region.
data.company.size	string	Employee headcount band, e.g. 5001-10000.
data.company.streetAddress	string	Headquarters street address.
data.company.twitterUrl	string	Company X (Twitter) profile URL.
data.company.website	string	Company website domain.
data.countries	string[]	Every country associated with the person.
data.datasetVersion	string	Version of the People Data Labs dataset this record came from.
data.education	object[]	Education history.
data.education[].degrees	string[]	Degrees earned.
data.education[].endDate	string	When study ended.
data.education[].gpa	number	Grade point average, when the person published one.
data.education[].majors	string[]	Majors studied.
data.education[].minors	string[]	Minors studied.
data.education[].schoolId	string	People Data Labs school id.
data.education[].schoolLinkedinUrl	string	School LinkedIn page URL.
data.education[].schoolLocationName	string	School location as one display string.
data.education[].schoolName	string	School name.
data.education[].schoolType	string	School type, e.g. post-secondary institution.
data.education[].schoolWebsite	string	School website domain.
data.education[].startDate	string	When study started: YYYY, YYYY-MM or YYYY-MM-DD.
data.emails	object[]	Every email address held for the person, with its kind.
data.emails[].address	string	Email address.
data.emails[].type	string	Address kind, e.g. professional or personal.
data.experience	object[]	Work history, most relevant first.
data.experience[].companyFounded	integer	Year the employer was founded.
data.experience[].companyId	string	People Data Labs company id for the employer.
data.experience[].companyIndustry	string	Employer industry.
data.experience[].companyLinkedinUrl	string	Employer LinkedIn page URL.
data.experience[].companyLocationName	string	Employer headquarters as one display string.
data.experience[].companyName	string	Employer name.
data.experience[].companySize	string	Employer headcount band.
data.experience[].companyWebsite	string	Employer website domain.
data.experience[].endDate	string	When the role ended, absent while the role is current.
data.experience[].isPrimary	boolean	True for the role People Data Labs treats as current.
data.experience[].locationNames	string[]	Where the role was based.
data.experience[].startDate	string	When the role started: YYYY, YYYY-MM or YYYY-MM-DD.
data.experience[].title	string	Job title held.
data.experience[].titleClass	string	Normalized title class.
data.experience[].titleLevels	string[]	Seniority levels for the title.
data.experience[].titleRole	string	Normalized role for the title.
data.experience[].titleSubRole	string	Normalized sub-role for the title.
data.facebookId	string	Facebook numeric id.
data.facebookUrl	string	Facebook profile URL.
data.facebookUsername	string	Facebook handle.
data.firstName	string	First name.
data.fullName	string	Person's full name.
data.githubUrl	string	GitHub profile URL.
data.githubUsername	string	GitHub handle.
data.industry	string	Industry the person works in.
data.interests	string[]	Interests the person lists.
data.jobChangedUtc	number	UTC epoch timestamp in seconds (Unix time) the person last changed jobs. Multiply by 1000 for a JS Date in milliseconds.
data.jobStartDate	string	When the current role started, as People Data Labs reports it: YYYY, YYYY-MM or YYYY-MM-DD.
data.jobTitle	string	Current job title.
data.jobTitleClass	string	Normalized title class, e.g. research_and_development.
data.jobTitleLevels	string[]	Seniority levels for the current title, e.g. cxo, owner.
data.jobTitleRole	string	Normalized role for the current title, e.g. engineering.
data.jobTitleSubRole	string	Normalized sub-role for the current title.
data.jobVerifiedUtc	number	UTC epoch timestamp in seconds (Unix time) the current role was last verified. Multiply by 1000 for a JS Date in milliseconds.
data.lastInitial	string	Last initial.
data.lastName	string	Last name.
data.linkedinId	string	LinkedIn numeric member id.
data.linkedinUrl	string	LinkedIn profile URL.
data.linkedinUsername	string	LinkedIn vanity handle.
data.location	object	Where the person lives.
data.location.addressLine2	string	Second line of the address.
data.location.continent	string	Continent.
data.location.country	string	Country.
data.location.geo	string	Coordinates as "lat,lon".
data.location.locality	string	City.
data.location.metro	string	Metro area.
data.location.name	string	Location as one display string.
data.location.postalCode	string	Postal code.
data.location.region	string	State or region.
data.location.streetAddress	string	Street address.
data.location.updatedUtc	number	UTC epoch timestamp in seconds (Unix time) the location was last updated. Multiply by 1000 for a JS Date in milliseconds.
data.locationNames	string[]	Every location People Data Labs has associated with the person.
data.middleInitial	string	Middle initial.
data.middleName	string	Middle name.
data.mobilePhone	string	Mobile phone number in international form.
data.pdlId	string	People Data Labs persistent person id. Send it back as this SKU's pdlId input.
data.personalEmails	string[]	Personal email addresses.
data.phoneNumbers	string[]	Every phone number held for the person.
data.profileScore	string	People Data Labs' qualitative score for how complete the profile is.
data.profiles	object[]	Every social profile linked to the person.
data.profiles[].network	string	Network name, e.g. linkedin, github, twitter.
data.profiles[].profileId	string	Network's own id for the profile.
data.profiles[].url	string	Profile URL.
data.profiles[].username	string	Handle on that network.
data.recommendedPersonalEmail	string	The personal address People Data Labs recommends reaching the person at.
data.regions	string[]	Every region associated with the person.
data.sex	string	Sex recorded for the person.
data.skills	string[]	Skills the person lists.
data.streetAddresses	object[]	Every street address associated with the person.
data.streetAddresses[].addressLine2	string	Second line of the address.
data.streetAddresses[].continent	string	Continent.
data.streetAddresses[].country	string	Country.
data.streetAddresses[].geo	string	Coordinates as "lat,lon".
data.streetAddresses[].locality	string	City.
data.streetAddresses[].metro	string	Metro area.
data.streetAddresses[].name	string	Address location as one display string.
data.streetAddresses[].postalCode	string	Postal code.
data.streetAddresses[].region	string	State or region.
data.streetAddresses[].streetAddress	string	Street address.
data.twitterUrl	string	X (Twitter) profile URL.
data.twitterUsername	string	X (Twitter) handle.
data.workEmail	string	Best work email address.
found	boolean	False when People Data Labs matched no person above the likelihood threshold.
Price
Price per request	USD	$0.24
Price /1k req	USD	$240.00

FAQ

About the Person Enrichment Peopledatalabs API

The AnyAPI Person Enrichment Peopledatalabs API returns Person Enrichment peopledatalabs data as normalized JSON from one POST call to /v1/run/person_enrichment.peopledatalabs. Enrich one person into work email, personal emails, mobile phone, full work history, education and employer firmographics from any identifier People Data Labs can match on. AnyAPI returns one normalized schema whichever source serves it. It costs from $240 per 1,000 requests, in US dollars with no subscription and no monthly minimum.

It costs from $240 per 1,000 requests, in US dollars with no subscription and no monthly minimum. You fund one USD wallet, each call draws it down, and a failed request costs $0.

Enrich one person into work email, personal emails, mobile phone, full work history, education and employer firmographics from any identifier People Data Labs can match on. The response is normalized JSON with the same envelope every AnyAPI endpoint returns, so parsing a second endpoint is a change of URL and nothing else.

More to call

Other Person Enrichment endpoints

Aviato · from $84.00 /1k req Bettercontact · from $82.80 /1k req Fullenrich bulk · from $100.80 /1k results Fullenrich reverse email · from $100.80 /1k results Lusha · from $84.00 /1k req Prospeo · from $66.00 /1k req Quickenrich · from $7.20 /1k req

Get started

Two ways to start on AnyAPI

Humans fund a USD wallet and pay per request. Agents point a coding agent at one URL and onboard themselves.