People Search-API

People Search-Peopledatalabs-API

Durchsuche den Personendatensatz von People Data Labs mit SQL oder einer Elasticsearch-Abfrage. Die Ergebnisse tragen den beruflichen und firmenbezogenen Datensatz plus Verfügbarkeits-Flags für Kontaktdaten; die tatsächliche E-Mail und Telefonnummer holst du mit Person Enrichment - People Data Labs. Abgerechnet pro zurückgegebenem Profil.

168,00 USD/1k Ergebnisse, Zahlung pro Anfrage, kein Abo.

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
Was die API zurückgegeben hatpeople[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 weitere Felder
}
Verfügbarkeit
100,00%
30d · 23 Aufrufe
Anfragen
25
30 T · wöchentlich, letzte 12 Wochen
Antwort
2,5s
Median · 30d

Aufrufen

People Search Peopledatalabs mit einer Anfrage abrufen

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())
Öffnen in
Beispielantwort

Dieses Beispiel zeigt 97 von 125 Feldern. Alle Felder ansehen

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

Vollständige Parameter- und Antwortreferenz: jedes Feld, jeder Typ und jedes Beispiel für diesen Endpoint.

Referenz

Eine Anfrage, eine Antwortstruktur.

Jedes Feld, das du sendest, und jedes Feld, das du zurückbekommst, jeweils mit einem echten Beispiel.

Zuletzt geprüft 2026-11-21 · Verfügbarkeit und Latenz gemessen über 30d

Request-Body

JSON, per POST an diesen Endpoint gesendet.

  • dataIncludestring

    Kommagetrennte People-Data-Labs-Felder, die enthalten sein sollen, oder eine Liste mit führendem -, um Felder auszuschließen. Die Projektion ändert nur die Nutzlast; die Abrechnung folgt weiterhin den zurückgegebenen Profilen.

  • datasetstring

    People-Data-Labs-Datensatz, der durchsucht wird, wenn dein Tarif mehr als einen bereitstellt.

  • limitinteger

    2

    Maximale Zahl der zurückgegebenen Profile. Jedes zurückgegebene Profil wird berechnet, beginne also bei 1, um eine Suchanfrage zu prüfen und total zu lesen, bevor du mehr anforderst.

  • queryobject

    Elasticsearch-artige Abfrage über den Personendatensatz von People Data Labs, z. B. {"bool": {"must": [{"term": {"job_company_website": "posthog.com"}}]}}. Sende dies oder sql, nie beides.

  • sqlstring

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

    People-Data-Labs-SQL in der Form SELECT * FROM person WHERE ... . Zeichenketten stehen in einfachen Anführungszeichen, nur SELECT * wird unterstützt, und Feldnamen müssen echte People-Data-Labs-Personenfelder sein, einschließlich verschachtelter Unterfelder wie experience.title.name. Füge keine LIMIT-Klausel ein; People Data Labs lehnt sie ab. Nutze stattdessen limit. Sende dies oder query, nie beides.

  • titlecaseboolean

    true

    Gib Text in Title Case zurück, statt in der Kleinschreibung, die People Data Labs standardmäßig liefert.

Du sendest. Ein kleiner JSON-Body. Die gezeigten Werte sind Beispiele, die du durch deine eigenen ersetzt.

Antwort

JSON, ein Beispielwert pro Feld.

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.

Du bekommst zurück. Benannte, typisierte Felder in derselben Struktur, egal welche Quelle antwortet.

FAQ

Über die People Search-Peopledatalabs-API

Die AnyAPI-People Search-Peopledatalabs-API liefert People Search-Daten als normalisiertes JSON aus einem POST-Aufruf an /v1/run/people_search.peopledatalabs. Durchsuche den Personendatensatz von People Data Labs mit SQL oder einer Elasticsearch-Abfrage. Die Ergebnisse tragen den beruflichen und firmenbezogenen Datensatz plus Verfügbarkeits-Flags für Kontaktdaten; die tatsächliche E-Mail und Telefonnummer holst du mit Person Enrichment - People Data Labs. Abgerechnet pro zurückgegebenem Profil. AnyAPI liefert ein normalisiertes Schema, egal welche Quelle antwortet. Sie kostet 168 USD pro 1.000 Ergebnisse, und nie mehr als 9,91 USD für eine einzelne Anfrage, in US-Dollar, ohne Abo und ohne monatliches Minimum. In den letzten 30 Tagen waren 100,0% der People Search Peopledatalabs-Aufrufe über AnyAPI erfolgreich, bei einer mittleren Antwortzeit von 2,5 Sekunden über 23 gemessene Aufrufe.

Sie kostet 168 USD pro 1.000 Ergebnisse, und nie mehr als 9,91 USD für eine einzelne Anfrage, in US-Dollar, ohne Abo und ohne monatliches Minimum. Du lädst ein USD-Guthabenkonto auf, und jeder Aufruf bucht davon ab. Bei manchen fehlgeschlagenen, vom Guthabenkonto bezahlten Anfragen fallen Bearbeitungsgebühren an, die wir zum Selbstkostenpreis ohne Aufschlag weitergeben. Die Fehlerantwort zeigt den berechneten Betrag.

Durchsuche den Personendatensatz von People Data Labs mit SQL oder einer Elasticsearch-Abfrage. Die Ergebnisse tragen den beruflichen und firmenbezogenen Datensatz plus Verfügbarkeits-Flags für Kontaktdaten; die tatsächliche E-Mail und Telefonnummer holst du mit Person Enrichment - People Data Labs. Abgerechnet pro zurückgegebenem Profil. Die Antwort ist normalisiertes JSON mit demselben Envelope, den jeder AnyAPI-Endpoint liefert, sodass das Parsen eines zweiten Endpoints nur eine geänderte URL bedeutet.

In den letzten 30 Tagen waren 100,0% der People Search Peopledatalabs-Aufrufe über AnyAPI erfolgreich, bei einer mittleren Antwortzeit von 2,5 Sekunden über 23 gemessene Aufrufe. Das sind AnyAPIs eigene Messungen des Traffics durch das Gateway, laufend neu berechnet, kein veröffentlichtes Service-Level-Ziel.

Ja. Ein neues AnyAPI-Konto startet mit 0,10 USD Gratis-Guthaben, ohne Karte.

Sende eine POST-Anfrage an https://api.getanyapi.com/v1/run/people_search.peopledatalabs mit deinem AnyAPI-Schlüssel in einem Header „Authorization: Bearer“ und der Eingabe als JSON-Body. Derselbe Schlüssel und dasselbe Guthabenkonto funktionieren bei jedem AnyAPI-Endpoint.

Nein. Du lädst US-Dollar auf ein Prepaid-AnyAPI-Guthaben, und jede Anfrage bucht davon ab. Es gibt keinen Monatstarif und kein Minimum, und dasselbe Guthaben bezahlt jeden AnyAPI-Endpoint.

Ja. Installiere @getanyapi/sdk von npm für TypeScript oder getanyapi von pip für Python. Beide rufen jeden AnyAPI-Endpoint mit demselben Schlüssel auf, und jeder HTTP-Client funktioniert ebenfalls.

Ja. Ein Agent kann sich mit dem AnyAPI-MCP-Server unter https://api.getanyapi.com/mcp verbinden oder mit einem unauthentifizierten POST an https://api.getanyapi.com/agent/signup einen eigenen kostenlosen Test-Schlüssel erstellen und diesen Endpoint über HTTP aufrufen.