> ## Documentation Index > Fetch the complete documentation index at: https://getanyapi.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Person Enrichment - People Data Labs > Enrich one person into work email, personal emails, mobile phone, full work history, education and employer firmographics from any identifier People Data Labs can match on. **Price:** \$240.00 per 1,000 requests (flat per request - same cost regardless of results returned). **Routing:** one lane serves this API today, so a failed attempt has nowhere to fail over to. Payment outcome follows the selected rail's settlement policy. **Catalog:** [Person Enrichment - People Data Labs pricing and uptime](https://getanyapi.com/api/person-enrichment/peopledatalabs) - live USD price, lane routing, and measured 30-day uptime. [Every Person_enrichment endpoint](https://getanyapi.com/api/person-enrichment). ## OpenAPI ````yaml /openapi.json post /v1/run/person_enrichment.peopledatalabs openapi: 3.1.0 info: contact: email: support@getanyapi.com description: >- Any API, one wallet, USD, no subscriptions. Each API is a single discovered operation: send the normalized input, get a normalized result. Prices and payment outcomes are reported in USD; each operation documents the settlement policy for its enabled payment rails. title: AnyAPI version: 1.0.0 x-guidance: >- Use each operation's published method and path with its normalized JSON input (see the operation requestBody). Before setting a client or tool timeout, GET /v1/apis/{sku} and inspect its trailing-30-day latency p50/p95/p99 and sample; p99 is an observation, not a maximum. To pay: send your AnyAPI key (Authorization: Bearer, billed from your USD wallet). For operations that advertise an inline rail, pay per call inline with x402 - call with no key, receive HTTP 402 with a PAYMENT-REQUIRED header, then retry with the PAYMENT-SIGNATURE header (base, no account needed); or pay per call inline with MPP (Machine Payments Protocol) - call with no key, receive HTTP 402 with a WWW-Authenticate: Payment challenge, then retry with the Authorization: Payment header (tempo, no account needed). x402 settles after execution; execution failure is reported as released; mpp settles before execution; execution failure is reported as charged_undelivered. servers: - url: https://api.getanyapi.com security: - bearerAuth: [] - apiKeyAuth: [] tags: - name: ahrefs x-group: Ahrefs - name: airbnb x-group: Airbnb - name: alibaba x-group: Alibaba - name: amazon x-group: Amazon - name: apollo x-group: Apollo - name: appstore x-group: Appstore - name: bluesky x-group: Bluesky - name: booking x-group: Booking - name: capterra x-group: Capterra - name: chatgpt x-group: Chatgpt - name: coinmarketcap x-group: Coinmarketcap - name: company x-group: Company - name: company-enrichment x-group: Company_enrichment - name: company-search x-group: Company_search - name: congress x-group: Congress - name: dexscreener x-group: Dexscreener - name: douyin x-group: Douyin - name: ebay x-group: Ebay - name: email x-group: Email - name: email-finding x-group: Email_finding - name: email-verification x-group: Email_verification - name: facebook x-group: Facebook - name: fiverr x-group: Fiverr - name: g2 x-group: G2 - name: gemini x-group: Gemini - name: github x-group: Github - name: glassdoor x-group: Glassdoor - name: google x-group: Google - name: google-ads x-group: Google Ads - name: google-finance x-group: Google Finance - name: google-shopping x-group: Google Shopping - name: hackernews x-group: Hackernews - name: indeed x-group: Indeed - name: instagram x-group: Instagram - name: job-search x-group: Job_search - name: linkedin x-group: Linkedin - name: maps x-group: Maps - name: mobile-phone x-group: Mobile_phone - name: naver x-group: Naver - name: pandaexpress x-group: Pandaexpress - name: people-search x-group: People_search - name: perplexity x-group: Perplexity - name: person x-group: Person - name: person-enrichment x-group: Person_enrichment - name: pinterest x-group: Pinterest - name: playstore x-group: Playstore - name: polymarket x-group: Polymarket - name: realtor x-group: Realtor - name: reddit x-group: Reddit - name: redfin x-group: Redfin - name: rednote x-group: Rednote - name: sec x-group: Sec - name: semrush x-group: Semrush - name: seo x-group: Seo - name: snapchat x-group: Snapchat - name: social x-group: Social - name: spotify x-group: Spotify - name: substack x-group: Substack - name: technographics x-group: Technographics - name: threads x-group: Threads - name: tiktok x-group: TikTok - name: tiktok-shop x-group: TikTok Shop - name: tripadvisor x-group: Tripadvisor - name: trustpilot x-group: Trustpilot - name: truthsocial x-group: Truthsocial - name: twitter x-group: X (Twitter) - name: upwork x-group: Upwork - name: walmart x-group: Walmart - name: web x-group: Web - name: weibo x-group: Weibo - name: yahoo-finance x-group: Yahoo Finance - name: yelp x-group: Yelp - name: youtube x-group: YouTube - name: zhihu x-group: Zhihu - name: zillow x-group: Zillow paths: /v1/run/person_enrichment.peopledatalabs: post: tags: - person-enrichment summary: Person Enrichment - People Data Labs description: >- Enrich one person into work email, personal emails, mobile phone, full work history, education and employer firmographics from any identifier People Data Labs can match on. **Price:** \$240.00 per 1,000 requests (flat per request - same cost regardless of results returned). **Routing:** one lane serves this API today, so a failed attempt has nowhere to fail over to. Payment outcome follows the selected rail's settlement policy. **Catalog:** [Person Enrichment - People Data Labs pricing and uptime](https://getanyapi.com/api/person-enrichment/peopledatalabs) - live USD price, lane routing, and measured 30-day uptime. [Every Person_enrichment endpoint](https://getanyapi.com/api/person-enrichment). operationId: person_enrichment_peopledatalabs parameters: - description: >- Optional. Comma-separated keys (dotted paths like `author.name` descend into nested objects) to keep on each result item. Keys are matched relative to each result item after the `data`/`items` envelope is unwrapped, not against the top-level response envelope, so use `jq` to reshape the whole envelope. Shrinks the response without changing cost. in: query name: fields required: false schema: type: string - description: >- Optional. Cap the number of result rows returned; a `_truncated` note reports how many were withheld so you can page via the API's own `limit`. Does not change cost. in: query name: max_items required: false schema: minimum: 0 type: integer - description: >- Optional. Return only a structural outline (top-level keys, item counts, and per-field byte sizes) instead of the full data. Does not change cost. in: query name: summary required: false schema: type: boolean - description: >- Optional. A jq expression applied to the result envelope; its output replaces `output` (multiple outputs collect into an array). Reshape freely, e.g. `jq=.data | {title, description, md: .markdown[:3500]}`. Runs sandboxed with a 250ms / 2MB budget; on failure the full result is returned with a `jqError`. Does not change cost. in: query name: jq required: false schema: type: string - description: >- Optional. The most you are willing to pay for this one request, in US dollars (for example 0.05). Any route that would charge more than this is not used, so a request only ever runs on something you can afford. If nothing is available at or below your amount, the request is refused before it runs, nothing is charged, and the message tells you the cheapest price per request so you can raise it. Leave it out to accept the normal price. in: query name: max_cost_usd required: false schema: type: string - description: >- Optional wallet idempotency key, scoped to this customer for 24 hours. When the gateway honors the key, this synchronous in-process execution can continue after the caller disconnects, bounded by its execution deadline. A completed replayable result charges normally exactly once and can be replayed without another provider run or charge. A pending duplicate returns 409 idempotency_in_progress; reuse with different request semantics returns 409 idempotency_conflict. in: header name: Idempotency-Key required: false schema: maxLength: 255 minLength: 1 type: string requestBody: content: application/json: example: profile: https://www.linkedin.com/in/dharmesh schema: additionalProperties: false anyOf: - required: - profile - required: - email - required: - phone - required: - emailHash - required: - linkedinId - required: - pdlId - required: - name - required: - firstName - lastName example: profile: https://www.linkedin.com/in/dharmesh properties: birthDate: description: Known birth date, to disambiguate a name match. type: string company: description: >- Company name, website or social URL where the person has worked. type: string country: description: Country to match on. type: string dataInclude: description: >- Comma-separated People Data Labs fields to include, or a leading - list to exclude. Projection changes the payload only; it does not reduce what the call costs. type: string email: description: Any email address the person has used. format: email type: string emailHash: description: >- SHA-256 or MD5 hash of an email address, for privacy-preserving matching. type: string firstName: description: >- First name. Send with lastName plus company, school or location. type: string includeIfMatched: description: Report which of the sent identifiers actually matched. type: boolean lastName: description: >- Last name. Send with firstName plus company, school or location. type: string linkedinId: description: LinkedIn numeric member id (PDL calls this lid). type: string locality: description: City or locality to match on. type: string location: description: >- Free-form location string, e.g. brookline, massachusetts, united states. type: string middleName: description: Middle name. type: string minLikelihood: description: >- Minimum People Data Labs likelihood score a match must reach to count as found. Omitted, this SKU sends 6; the People Data Labs default is 2. maximum: 10 minimum: 1 type: integer name: description: Full name, as an alternative to firstName plus lastName. type: string pdlId: description: >- People Data Labs persistent person id, as returned by this SKU's pdlId output. type: string phone: description: Phone number in international form, e.g. +16176695906. type: string postalCode: description: Postal or ZIP code to match on. type: string preferLatencyUnderMs: description: >- Optional; omit it and routing is unchanged, with the cheapest source serving. Prefer sources whose typical response time (median over the trailing 30 days, as published on this endpoint's lane health) is under this many milliseconds; among those, the cheapest serves. This can raise your price: when the cheapest source misses the target, a faster and dearer one serves, and you are quoted and charged its price. If no source is that fast the request is still served, by whichever source offers the best speed for its price - it is never refused for being slow. Sources we have not timed are tried last. This is a preference, not a guarantee: the median describes past requests and is not a ceiling on this one, and it excludes any wait this request itself asks for. On a paginated walk it applies to the first page only: later pages stay with the source that page chose, at the price it was quoted. minimum: 1 type: integer profile: description: >- Social profile URL the person has used, e.g. a LinkedIn, Twitter, Facebook or GitHub profile. The strongest single identifier. type: string region: description: State or region to match on. type: string required: description: >- People Data Labs boolean expression over top-level fields that a match must satisfy, e.g. personal_emails or (emails and phone_numbers). type: string school: description: >- School the person attended, used to disambiguate a name match. type: string streetAddress: description: Street address to match on. type: string titlecase: description: >- Return text in title case instead of People Data Labs' lowercase default. type: boolean title: Person Enrichment - People Data Labs input type: object required: true responses: '200': content: application/json: schema: properties: costUsd: description: >- USD charged on the original run. On a replay this value is echoed for parity; the replay itself is free. type: number hint: description: >- Optional one-line nudge, absent when there is nothing to say. `large_result:` suggests the fields/max_items/summary/jq controls for a big response. `paging_unavailable:` means this result came from a source that cannot return a `nextCursor`, so it may be INCOMPLETE and cannot be continued - re-run with `requireCursor: true` to be served only by a source that can page, which may cost more per request. type: string items: description: >- Number of result rows returned. For per-result SKUs the per-item cost is charged against this count; for input-priced SKUs the charge is per submitted input, independent of this count. type: integer jqError: description: >- Present only when a `jq` expression failed; `output` then carries the full unshaped result and this explains why the reshape did not apply. type: string output: anyOf: - additionalProperties: false properties: data: description: The enriched person, or null when nothing matched. oneOf: - type: 'null' - properties: activityScore: description: >- People Data Labs' qualitative score for how recently the profile showed activity. type: string birthDate: description: >- Date of birth as People Data Labs reports it, YYYY-MM-DD. type: string birthYear: description: Year of birth. type: integer company: description: The person's current employer. properties: addressLine2: description: Second line of the headquarters address. type: string companyId: description: People Data Labs company id. type: string continent: description: Headquarters continent. type: string country: description: Headquarters country. type: string facebookUrl: description: Company Facebook page URL. format: uri type: string founded: description: Year the company was founded. type: integer geo: description: Headquarters coordinates as "lat,lon". type: string industry: description: Company industry. type: string industryV2: description: >- Company industry on People Data Labs' newer taxonomy. type: string linkedinId: description: Company LinkedIn numeric id. type: string linkedinUrl: description: Company LinkedIn page URL. format: uri type: string locality: description: Headquarters city. type: string locationName: description: >- Headquarters location as one display string. type: string metro: description: Headquarters metro area. type: string name: description: Company name. type: string postalCode: description: Headquarters postal code. type: string region: description: Headquarters state or region. type: string size: description: >- Employee headcount band, e.g. 5001-10000. type: string streetAddress: description: Headquarters street address. type: string twitterUrl: description: Company X (Twitter) profile URL. format: uri type: string website: description: Company website domain. type: string type: object countries: description: Every country associated with the person. items: type: string type: array datasetVersion: description: >- Version of the People Data Labs dataset this record came from. type: string education: description: Education history. items: properties: degrees: description: Degrees earned. items: type: string type: array endDate: description: When study ended. type: string gpa: description: >- Grade point average, when the person published one. type: number majors: description: Majors studied. items: type: string type: array minors: description: Minors studied. items: type: string type: array schoolId: description: People Data Labs school id. type: string schoolLinkedinUrl: description: School LinkedIn page URL. format: uri type: string schoolLocationName: description: School location as one display string. type: string schoolName: description: School name. type: string schoolType: description: >- School type, e.g. post-secondary institution. type: string schoolWebsite: description: School website domain. type: string startDate: description: >- When study started: YYYY, YYYY-MM or YYYY-MM-DD. type: string type: object type: array emails: description: >- Every email address held for the person, with its kind. items: properties: address: description: Email address. type: string type: description: >- Address kind, e.g. professional or personal. type: string required: - address type: object type: array experience: description: Work history, most relevant first. items: properties: companyFounded: description: Year the employer was founded. type: integer companyId: description: >- People Data Labs company id for the employer. type: string companyIndustry: description: Employer industry. type: string companyLinkedinUrl: description: Employer LinkedIn page URL. format: uri type: string companyLocationName: description: >- Employer headquarters as one display string. type: string companyName: description: Employer name. type: string companySize: description: Employer headcount band. type: string companyWebsite: description: Employer website domain. type: string endDate: description: >- When the role ended, absent while the role is current. type: string isPrimary: description: >- True for the role People Data Labs treats as current. type: boolean locationNames: description: Where the role was based. items: type: string type: array startDate: description: >- When the role started: YYYY, YYYY-MM or YYYY-MM-DD. type: string title: description: Job title held. type: string titleClass: description: Normalized title class. type: string titleLevels: description: Seniority levels for the title. items: type: string type: array titleRole: description: Normalized role for the title. type: string titleSubRole: description: Normalized sub-role for the title. type: string type: object type: array facebookId: description: Facebook numeric id. type: string facebookUrl: description: Facebook profile URL. format: uri type: string facebookUsername: description: Facebook handle. type: string firstName: description: First name. type: string fullName: description: Person's full name. type: string githubUrl: description: GitHub profile URL. format: uri type: string githubUsername: description: GitHub handle. type: string industry: description: Industry the person works in. type: string interests: description: Interests the person lists. items: type: string type: array jobChangedUtc: description: >- UTC epoch timestamp in seconds (Unix time) the person last changed jobs. Multiply by 1000 for a JS Date in milliseconds. type: number jobStartDate: description: >- When the current role started, as People Data Labs reports it: YYYY, YYYY-MM or YYYY-MM-DD. type: string jobTitle: description: Current job title. type: string jobTitleClass: description: >- Normalized title class, e.g. research_and_development. type: string jobTitleLevels: description: >- Seniority levels for the current title, e.g. cxo, owner. items: type: string type: array jobTitleRole: description: >- Normalized role for the current title, e.g. engineering. type: string jobTitleSubRole: description: Normalized sub-role for the current title. type: string jobVerifiedUtc: description: >- UTC epoch timestamp in seconds (Unix time) the current role was last verified. Multiply by 1000 for a JS Date in milliseconds. type: number lastInitial: description: Last initial. type: string lastName: description: Last name. type: string linkedinId: description: LinkedIn numeric member id. type: string linkedinUrl: description: LinkedIn profile URL. format: uri type: string linkedinUsername: description: LinkedIn vanity handle. type: string location: description: Where the person lives. properties: addressLine2: description: Second line of the address. type: string continent: description: Continent. type: string country: description: Country. type: string geo: description: Coordinates as "lat,lon". type: string locality: description: City. type: string metro: description: Metro area. type: string name: description: Location as one display string. type: string postalCode: description: Postal code. type: string region: description: State or region. type: string streetAddress: description: Street address. type: string updatedUtc: description: >- UTC epoch timestamp in seconds (Unix time) the location was last updated. Multiply by 1000 for a JS Date in milliseconds. type: number type: object locationNames: description: >- Every location People Data Labs has associated with the person. items: type: string type: array middleInitial: description: Middle initial. type: string middleName: description: Middle name. type: string mobilePhone: description: Mobile phone number in international form. type: string pdlId: description: >- People Data Labs persistent person id. Send it back as this SKU's pdlId input. type: string personalEmails: description: Personal email addresses. items: type: string type: array phoneNumbers: description: Every phone number held for the person. items: type: string type: array profileScore: description: >- People Data Labs' qualitative score for how complete the profile is. type: string profiles: description: Every social profile linked to the person. items: properties: network: description: >- Network name, e.g. linkedin, github, twitter. type: string profileId: description: Network's own id for the profile. type: string url: description: Profile URL. format: uri type: string username: description: Handle on that network. type: string required: - network type: object type: array recommendedPersonalEmail: description: >- The personal address People Data Labs recommends reaching the person at. type: string regions: description: Every region associated with the person. items: type: string type: array sex: description: Sex recorded for the person. type: string skills: description: Skills the person lists. items: type: string type: array streetAddresses: description: >- Every street address associated with the person. items: properties: addressLine2: description: Second line of the address. type: string continent: description: Continent. type: string country: description: Country. type: string geo: description: Coordinates as "lat,lon". type: string locality: description: City. type: string metro: description: Metro area. type: string name: description: Address location as one display string. type: string postalCode: description: Postal code. type: string region: description: State or region. type: string streetAddress: description: Street address. type: string type: object type: array twitterUrl: description: X (Twitter) profile URL. format: uri type: string twitterUsername: description: X (Twitter) handle. type: string workEmail: description: Best work email address. type: string required: - fullName type: object found: description: >- False when People Data Labs matched no person above the likelihood threshold. type: boolean required: - found - data title: Person Enrichment - People Data Labs output type: object - type: 'null' description: >- Normalized output, or null when the replay payload was not retained. provider: description: Always "AnyAPI". type: string replayed: description: >- True when this response replays the durable result of an earlier run without billing or upstream execution. type: boolean resultId: description: >- Opaque handle to the full unshaped result, cached ~15 min. Re-shape it for free (fields/max_items/summary/jq) via GET /v1/results/{id}, no re-billing. Absent when the result was too large to cache. type: string required: - output - provider - costUsd - items - replayed type: object description: Normalized result. headers: Idempotency-Replayed: description: >- Present only when the request carried an Idempotency-Key this gateway honored. "false" means the key was claimed and the run executed freshly; "true" means it replayed a prior identical run and was NOT charged again. Absent means either no key was sent or this gateway does not honor keys, so a retry could be charged twice. schema: enum: - 'false' - 'true' type: string PAYMENT-RESPONSE: description: Inline x402 payment receipt. schema: type: string Payment-Receipt: description: Inline mpp payment receipt. schema: type: string X-PAYMENT-RESPONSE: description: Inline x402 payment receipt. schema: type: string '400': content: application/json: schema: $ref: '#/components/schemas/Error' description: >- Input did not match the schema, or the upstream rejected the request. '401': content: application/json: schema: $ref: '#/components/schemas/Error' description: Missing or invalid API key. '402': content: application/json: schema: oneOf: - $ref: '#/components/schemas/PaymentRequiredError' - $ref: '#/components/schemas/TrialCapReached' application/problem+json: schema: properties: challengeId: minLength: 1 type: string status: const: 402 type: integer required: - status - challengeId type: object description: >- Insufficient wallet balance or spend cap, or an inline-payment challenge. Agent trials receive a trial_cap_reached continuation with a live RFC 8628 device authorization. headers: PAYMENT-REQUIRED: description: Inline x402 payment challenge. schema: type: string WWW-Authenticate: description: Inline mpp payment challenge. schema: type: string '404': content: application/json: schema: $ref: '#/components/schemas/Error' description: Unknown SKU, or the upstream had no matching resource. '409': content: application/json: schema: $ref: '#/components/schemas/Error' description: >- Idempotency collision. Codes: idempotency_in_progress means retry after the Retry-After delay; idempotency_conflict means use a new key for different request semantics; idempotency_needs_review means stop retrying and contact AnyAPI support with X-Anyapi-Request-Id. '422': content: application/json: schema: $ref: '#/components/schemas/Error' description: >- The request was well formed but this API cannot serve the requested target site; the body's `alternatives` array lists the AnyAPI APIs that can. '429': content: application/json: schema: $ref: '#/components/schemas/Error' description: >- The upstream was rate limited; inspect `payment` when present before deciding whether to retry. '500': content: application/json: schema: $ref: '#/components/schemas/Error' description: >- An internal error prevented completion. Inspect payment when present before retrying. '502': content: application/json: schema: $ref: '#/components/schemas/Error' description: >- Every provider failed with a server/transport error, or inline payment settlement could not be confirmed; inspect `payment` when present before retrying. security: - bearerAuth: [] - apiKeyAuth: [] - {} components: schemas: Error: properties: code: description: Stable machine-readable error code when the endpoint defines one. type: string error: description: Customer-safe error message. type: string payment: $ref: '#/components/schemas/Payment' requestId: description: >- This run's AnyAPI request id, the same value as the X-Anyapi-Request-Id response header. Quote it to support. Absent on endpoints that do not execute a run. format: uuid type: string required: - error type: object PaymentRequiredError: allOf: - $ref: '#/components/schemas/Error' - properties: error: not: const: trial_cap_reached type: object TrialCapReached: properties: error: const: trial_cap_reached type: string message: description: >- Human-relayable continuation instructions, including an executable token poll. type: string upgrade: $ref: '#/components/schemas/AgentUpgrade' required: - error - message - upgrade type: object Payment: properties: costUsd: description: Known USD payment amount for this request. minimum: 0 type: number rail: minLength: 1 type: string settlementState: enum: - charged_undelivered - indeterminate type: string required: - rail - settlementState - costUsd type: object AgentUpgrade: properties: authorizationServer: format: uri type: string clientId: type: string device: $ref: '#/components/schemas/DeviceUpgrade' scope: type: string required: - authorizationServer - scope type: object DeviceUpgrade: properties: deviceCode: type: string expiresIn: minimum: 0 type: integer grantType: type: string interval: minimum: 1 type: integer tokenEndpoint: format: uri type: string userCode: type: string verificationUri: format: uri type: string verificationUriComplete: format: uri type: string required: - verificationUriComplete - verificationUri - userCode - deviceCode - tokenEndpoint - grantType - interval - expiresIn type: object securitySchemes: bearerAuth: description: Your AnyAPI key as a Bearer token. scheme: bearer type: http x-default: YOUR_ANYAPI_KEY apiKeyAuth: description: Your AnyAPI key. in: header name: X-API-Key type: apiKey x-default: YOUR_ANYAPI_KEY ````