API de People Search

API de People Search: Peopledatalabs

Busca en el conjunto de datos de personas de People Data Labs con SQL o una consulta de Elasticsearch. Los resultados incluyen el registro profesional y firmográfico, además de indicadores de disponibilidad de datos de contacto; obtén el correo electrónico y el teléfono reales con Person Enrichment - People Data Labs. Se cobra por cada perfil devuelto.

US$168.00/1k resultados, pagas por solicitud, sin suscripción.

PPerson Search Playground | PDL
dashboard.peopledatalabs.com/playground/person-search
PPDL
PlaygroundSearchBulkBillingDocs
Person SearchPerson EnrichmentCompany SearchRun Query

SELECT * FROM person WHERE

job_title_role='engineering' AND job_company_website='vercel.com'

47 people matchedlimit 2 · titlecase
Full nameJob titleCompanyLocation
Marcus RidgewayStaff Software EngineerVercelOakland, California, United States
Lo que devolvió la APIpeople[0]
{
"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 campos más
}
Disponibilidad
100.00%
30d · 19 llamadas
Solicitudes
19
30d · semanal, últimas 12 sem.
Respuesta
2.3s
mediana · 30d

Llámalo

Obtén Peopledatalabs de People Search en una sola solicitud

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())
Abrir en
Respuesta de ejemplo

Este ejemplo muestra 97 de 125 campos. Ver todos los campos

{
  "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"
  }
}

Referencia completa de parámetros y respuesta: cada campo, tipo y ejemplo de este endpoint.

Referencia

Una solicitud, un formato de respuesta.

Cada campo que envías y cada campo que recibes, cada uno con un ejemplo real.

Verificado por última vez el 2026-11-14 · disponibilidad y latencia medidas en 30d

Cuerpo de la solicitud

JSON, enviado por POST a este endpoint.

  • dataIncludestring

    Campos de People Data Labs a incluir, separados por comas, o una lista precedida de - para excluirlos. La proyección solo cambia el contenido de la respuesta; el cobro sigue dependiendo de los perfiles devueltos.

  • datasetstring

    Conjunto de datos de People Data Labs en el que buscar, cuando tu plan expone más de uno.

  • limitinteger

    2

    Número máximo de perfiles a devolver. Se cobra cada perfil devuelto, así que empieza con 1 para comprobar una consulta y lee total antes de pedir más.

  • queryobject

    Consulta al estilo Elasticsearch sobre el conjunto de datos de personas de People Data Labs, p. ej., {"bool": {"must": [{"term": {"job_company_website": "posthog.com"}}]}}. Envía esto o sql, nunca ambos.

  • sqlstring

    SELECT * FROM person WHERE job_title_role='engineering' AND job_company_website='vercel.com'

    SQL de People Data Labs, con la forma SELECT * FROM person WHERE ... . Los literales de texto van entre comillas simples, solo se admite SELECT * y los nombres de campo deben ser campos reales de persona de People Data Labs, incluidos subcampos anidados como experience.title.name. No incluyas una cláusula LIMIT; People Data Labs la rechaza. Usa limit en su lugar. Envía esto o query, nunca ambos.

  • titlecaseboolean

    true

    Devuelve el texto con mayúscula inicial en cada palabra en lugar del texto en minúsculas que People Data Labs usa por defecto.

Envías. Un cuerpo JSON pequeño. Los valores que se muestran son ejemplos para reemplazar por los tuyos.

Respuesta

JSON, un valor de ejemplo por campo.

datadata

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.

each peopledata.people[]

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.

availabledata.people[].available

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.

each educationdata.people[].education[]

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.

each emaildata.people[].emails[]

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.

each experiencedata.people[].experience[]

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.

each profiledata.people[].profiles[]

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.

top level
  • 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.

Recibes. Campos con nombre y tipo, con el mismo formato sin importar qué fuente responda.

Preguntas frecuentes

Acerca del endpoint Peopledatalabs de la API de People Search

El endpoint Peopledatalabs de AnyAPI para People Search devuelve datos de People Search como JSON normalizado con una sola llamada POST a /v1/run/people_search.peopledatalabs. Busca en el conjunto de datos de personas de People Data Labs con SQL o una consulta de Elasticsearch. Los resultados incluyen el registro profesional y firmográfico, además de indicadores de disponibilidad de datos de contacto; obtén el correo electrónico y el teléfono reales con Person Enrichment - People Data Labs. Se cobra por cada perfil devuelto. AnyAPI devuelve un único esquema normalizado sin importar qué fuente atienda la solicitud. Cuesta US$168 por cada 1,000 resultados, y nunca más de US$9.91 por una sola solicitud, en dólares estadounidenses, sin suscripción y sin mínimo mensual. En los últimos 30 días, el 100.0% de las llamadas al endpoint Peopledatalabs de la API de People Search a través de AnyAPI tuvo éxito, con un tiempo de respuesta mediano de 2.3 segundos en 19 llamadas medidas.

Cuesta US$168 por cada 1,000 resultados, y nunca más de US$9.91 por una sola solicitud, en dólares estadounidenses, sin suscripción y sin mínimo mensual. Agregas fondos a una billetera en dólares y cada llamada descuenta de ella. Algunas solicitudes fallidas pagadas con la billetera generan cargos de procesamiento que trasladamos al costo, sin margen; la respuesta de error muestra el monto cobrado.

Busca en el conjunto de datos de personas de People Data Labs con SQL o una consulta de Elasticsearch. Los resultados incluyen el registro profesional y firmográfico, además de indicadores de disponibilidad de datos de contacto; obtén el correo electrónico y el teléfono reales con Person Enrichment - People Data Labs. Se cobra por cada perfil devuelto. La respuesta es JSON normalizado con el mismo envoltorio que devuelve cada endpoint de AnyAPI, así que procesar un segundo endpoint es solo cambiar la URL.

En los últimos 30 días, el 100.0% de las llamadas al endpoint Peopledatalabs de la API de People Search a través de AnyAPI tuvo éxito, con un tiempo de respuesta mediano de 2.3 segundos en 19 llamadas medidas. Estas son mediciones propias de AnyAPI sobre el tráfico que pasa por el gateway, recalculadas continuamente, no un objetivo de nivel de servicio publicado.

Sí. Una cuenta nueva de AnyAPI empieza con US$0.10 de saldo gratis, sin tarjeta.

Envía una solicitud POST a https://api.getanyapi.com/v1/run/people_search.peopledatalabs con tu clave de AnyAPI en un encabezado "Authorization: Bearer" y la entrada como cuerpo JSON. La misma clave y la misma billetera sirven para todos los endpoints de AnyAPI.

No. Agregas dólares a un solo saldo prepagado de AnyAPI y cada solicitud descuenta de él. No hay plan mensual ni mínimo, y el mismo saldo paga todos los endpoints de AnyAPI.

Sí. Instala @getanyapi/sdk desde npm para TypeScript o getanyapi desde pip para Python. Ambos llaman a todos los endpoints de AnyAPI con la misma clave, y también sirve cualquier cliente HTTP.

Sí. Un agente puede conectarse al servidor MCP de AnyAPI en https://api.getanyapi.com/mcp, o crear su propia clave de prueba gratis con un solo POST sin autenticar a https://api.getanyapi.com/agent/signup y llamar a este endpoint por HTTP.