API para Person Enrichment

API para Person Enrichment: Peopledatalabs

Enriqueça uma pessoa com e-mail corporativo, e-mails pessoais, celular, histórico profissional completo, formação e firmográficos do empregador a partir de qualquer identificador que a People Data Labs consiga corresponder.

POST/v1/run/person_enrichment.peopledatalabs
Disponibilidade
100,00%
30d · 6 chamadas
Requisições
6
30d
Resposta
1,6s
mediana · 30d

Preços

Um preço, em dólares

Como chamar

Faça sua primeira requisição

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())
Abrir em
Obter chave grátis
Resposta de exemplo
{
  "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 da resposta
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";
}

Referência completa de parâmetros e resposta - todos os campos, tipos e exemplos deste endpoint.

Referência

Requisição, resposta e preço

Última verificação em 2026-09-29 · disponibilidade e latência medidas em 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"}'
CampoTipoValor de exemplo
Corpo da requisição
birthDatestringData de nascimento conhecida, para desambiguar uma correspondência por nome.
companystringNome, site ou URL social de uma empresa onde a pessoa trabalhou.
countrystringPaís usado para encontrar a pessoa.
dataIncludestringCampos da People Data Labs a incluir, separados por vírgula, ou uma lista iniciada por - para excluir. A projeção muda só o payload; ela não reduz o custo da chamada.
emailstringQualquer endereço de e-mail que a pessoa já usou.
emailHashstringHash SHA-256 ou MD5 de um endereço de e-mail, para correspondência que preserva a privacidade.
firstNamestringPrimeiro nome. Envie com lastName mais empresa, escola ou localização.
includeIfMatchedbooleanInforma quais dos identificadores enviados realmente corresponderam.
lastNamestringSobrenome. Envie com firstName mais empresa, escola ou localização.
linkedinIdstringID numérico de membro do LinkedIn (a PDL chama de lid).
localitystringCidade ou localidade usada para encontrar a pessoa.
locationstringLocalização em texto livre, ex.: brookline, massachusetts, united states.
middleNamestringNome do meio.
minLikelihoodintegerPontuação mínima de probabilidade (likelihood) da People Data Labs que uma correspondência precisa atingir para contar como encontrada. Se omitido, este SKU envia 6; o padrão da People Data Labs é 2.
namestringNome completo, como alternativa a firstName mais lastName.
pdlIdstringID persistente de pessoa da People Data Labs, como retornado na saída pdlId deste SKU.
phonestringNúmero de telefone em formato internacional, ex.: +16176695906.
postalCodestringCódigo postal ou ZIP usado para encontrar a pessoa.
profilestring"https://www.linkedin.com/in/dharmesh"URL de um perfil social que a pessoa já usou, ex.: um perfil do LinkedIn, Twitter, Facebook ou GitHub. O identificador individual mais forte.
regionstringEstado ou região usado para encontrar a pessoa.
requiredstringExpressão booleana da People Data Labs sobre campos de nível superior que uma correspondência precisa satisfazer, ex.: personal_emails or (emails and phone_numbers).
schoolstringEscola que a pessoa frequentou, usada para desambiguar uma correspondência por nome.
streetAddressstringEndereço (rua) usado para encontrar a pessoa.
titlecasebooleanRetorna o texto com iniciais maiúsculas em vez do padrão em minúsculas da People Data Labs.
Resposta
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.
Preço
Preço por requisiçãoUSDUS$ 0,24
Preço /mil req.USDUS$ 240,00

Dúvidas frequentes

Sobre o endpoint Peopledatalabs da API para Person Enrichment

O endpoint Peopledatalabs da AnyAPI para Person Enrichment retorna dados de Person Enrichment em JSON normalizado com uma chamada POST para /v1/run/person_enrichment.peopledatalabs. Enriqueça uma pessoa com e-mail corporativo, e-mails pessoais, celular, histórico profissional completo, formação e firmográficos do empregador a partir de qualquer identificador que a People Data Labs consiga corresponder. A AnyAPI retorna um schema normalizado, seja qual for a fonte que atende. Custa a partir de US$ 240 por mil requisições, em dólares, sem assinatura e sem mínimo mensal. Nos últimos 30 dias, 100,0% das chamadas ao endpoint Peopledatalabs da API para Person Enrichment feitas pela AnyAPI tiveram sucesso, com tempo de resposta mediano de 1,6 segundos, em 6 chamadas medidas.

Custa a partir de US$ 240 por mil requisições, em dólares, sem assinatura e sem mínimo mensal. Você recarrega uma carteira em dólares e cada chamada desconta dela. Algumas requisições pagas pela carteira que falham geram cobranças de processamento, que repassamos pelo custo, sem margem; a resposta de erro mostra o valor cobrado.

Enriqueça uma pessoa com e-mail corporativo, e-mails pessoais, celular, histórico profissional completo, formação e firmográficos do empregador a partir de qualquer identificador que a People Data Labs consiga corresponder. A resposta é JSON normalizado, com o mesmo envelope que todo endpoint da AnyAPI retorna, então processar um segundo endpoint é só trocar a URL, e nada mais.

Nos últimos 30 dias, 100,0% das chamadas ao endpoint Peopledatalabs da API para Person Enrichment feitas pela AnyAPI tiveram sucesso, com tempo de resposta mediano de 1,6 segundos, em 6 chamadas medidas. Estas são medições da própria AnyAPI sobre o tráfego que passa pelo gateway, recalculadas continuamente, e não uma meta de nível de serviço publicada.
Mais para chamar

Outros endpoints de Person Enrichment

Bettercontacta partir de US$ 82,80 /mil req.Crustdata v3a partir de US$ 96,00 /mil req.Fullenrich em lotea partir de US$ 100,80 /mil resultadosFullenrich e-mail reversoa partir de US$ 100,80 /mil resultadosLushaa partir de US$ 84,00 /mil req.Prospeoa partir de US$ 66,00 /mil req.Quickenricha partir de US$ 7,20 /mil req.