API People Search

People Search Peopledatalabs API

Ищет в наборе данных о людях People Data Labs через SQL или запрос Elasticsearch. Результаты содержат профессиональную и фирмографическую запись и признаки наличия контактных данных; саму почту и телефон получайте через Person Enrichment - People Data Labs. Оплата за каждый возвращённый профиль.

168,00 USD/1 тыс. результатов, оплата за запрос, без подписки.

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
Что вернул 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
}
Доступность
100,00%
30d · Вызовов: 23
Запросы
25
30 дн. · по неделям, последние недель: 12
Ответ
2,5s
медиана · 30d

Вызвать

Получите People Search Peopledatalabs одним запросом

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())
Открыть в
Пример ответа

В этом примере показано полей: 97 из 125. Все поля

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

Полный справочник по параметрам и ответу: каждое поле, тип и пример для этого эндпоинта.

Справочник

Один запрос, один формат ответа.

Каждое поле, которое вы отправляете, и каждое поле, которое получаете, с реальным примером.

Проверено 2026-11-21 · доступность и задержка измерены за 30d

Тело запроса

JSON, отправляется на этот эндпоинт.

  • dataIncludestring

    Поля People Data Labs через запятую для включения или список с ведущим - для исключения. Проекция меняет только содержимое ответа; оплата по-прежнему зависит от числа возвращённых профилей.

  • datasetstring

    Набор данных People Data Labs для поиска, если ваш тариф открывает больше одного.

  • limitinteger

    2

    Максимальное число возвращаемых профилей. Каждый возвращённый профиль оплачивается, поэтому начните с 1, чтобы проверить запрос и прочитать total, прежде чем просить больше.

  • queryobject

    Запрос в стиле Elasticsearch к набору данных о людях People Data Labs, например {"bool": {"must": [{"term": {"job_company_website": "posthog.com"}}]}}. Передайте его или sql, но не оба.

  • sqlstring

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

    SQL People Data Labs в форме SELECT * FROM person WHERE ... . Строковые литералы берутся в одинарные кавычки, поддерживается только SELECT *, а имена полей должны быть настоящими полями людей People Data Labs, включая вложенные подполя, например experience.title.name. Не добавляйте предложение LIMIT: People Data Labs его отклоняет. Используйте вместо него limit. Передайте это или query, но не оба.

  • titlecaseboolean

    true

    Возвращать текст с заглавными буквами в заголовках вместо нижнего регистра People Data Labs по умолчанию.

Вы отправляете. Небольшое тело JSON. Показанные значения это примеры, замените их своими.

Ответ

JSON, по одному примеру значения на поле.

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.

Вы получаете. Именованные типизированные поля в одном формате, какой бы источник ни ответил.

Вопросы и ответы

Об API People Search Peopledatalabs

AnyAPI People Search Peopledatalabs API возвращает данные People Search в виде нормализованного JSON одним вызовом POST к /v1/run/people_search.peopledatalabs. Ищет в наборе данных о людях People Data Labs через SQL или запрос Elasticsearch. Результаты содержат профессиональную и фирмографическую запись и признаки наличия контактных данных; саму почту и телефон получайте через Person Enrichment - People Data Labs. Оплата за каждый возвращённый профиль. AnyAPI возвращает одну нормализованную схему, какой бы источник ни ответил. Это стоит 168 USD за 1000 результатов, и никогда не больше 9,91 USD за один запрос, в долларах США, без подписки и без ежемесячного минимума. За последние 30 дней 100,0% вызовов People Search Peopledatalabs через AnyAPI завершились успешно, медианное время ответа 2,5 с, измерено вызовов: 23.

Это стоит 168 USD за 1000 результатов, и никогда не больше 9,91 USD за один запрос, в долларах США, без подписки и без ежемесячного минимума. Вы пополняете один кошелёк в долларах США, и каждый вызов списывает с него. По некоторым неудавшимся запросам, оплаченным из кошелька, возникают расходы на обработку; мы передаём их по себестоимости, без наценки, а сумма списания указана в ответе с ошибкой.

Ищет в наборе данных о людях People Data Labs через SQL или запрос Elasticsearch. Результаты содержат профессиональную и фирмографическую запись и признаки наличия контактных данных; саму почту и телефон получайте через Person Enrichment - People Data Labs. Оплата за каждый возвращённый профиль. Ответ это нормализованный JSON с тем же конвертом, что возвращает каждый эндпоинт AnyAPI, поэтому разбор второго эндпоинта это смена URL и ничего больше.

За последние 30 дней 100,0% вызовов People Search Peopledatalabs через AnyAPI завершились успешно, медианное время ответа 2,5 с, измерено вызовов: 23. Это собственные измерения AnyAPI по трафику через шлюз, пересчитываемые непрерывно, а не опубликованный целевой уровень обслуживания.

Да. Новый аккаунт AnyAPI стартует с бесплатным балансом 0,10 USD, карта не нужна.

Отправьте запрос POST на https://api.getanyapi.com/v1/run/people_search.peopledatalabs с вашим ключом AnyAPI в заголовке "Authorization: Bearer" и входными данными в теле JSON. Один и тот же ключ и один и тот же кошелёк работают на каждом эндпоинте AnyAPI.

Нет. Вы пополняете один предоплаченный баланс AnyAPI в долларах США, и каждый запрос списывает с него. Ежемесячного тарифа и минимума нет, а один и тот же баланс оплачивает каждый эндпоинт AnyAPI.

Да. Установите @getanyapi/sdk из npm для TypeScript или getanyapi из pip для Python. Оба вызывают любой эндпоинт AnyAPI с одним и тем же ключом, а ещё подойдёт любой HTTP-клиент.

Да. Агент может подключиться к MCP-серверу AnyAPI по адресу https://api.getanyapi.com/mcp или создать собственный бесплатный пробный ключ одним POST без аутентификации на https://api.getanyapi.com/agent/signup и вызывать этот эндпоинт по HTTP.