{"uid":"cap_fTK1pd_4T-wVboAGM0sBz","slug":"pdl-people-enrichment-api-5e90555a","name":"PDL People Enrichment API","description":"PDL Person Enrich — career history, emails, phone. Requires one of: `email`, `profile` (LinkedIn URL), or `first_name` + `last_name` + (`company_name` OR `company_domain`). `{ first_name, last_name }` alone returns 400. Prefer `email` when known, then `profile`. No match: HTTP 200, status 404, data null — not billed. Match: $0.28.","url":"https://stable-enrich-git-shafu-pdl-people-enrich-25cca0-merit-systems.vercel.app/api/pdl/people-enrich","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"email":{"type":"string","description":"Email address — highest-reliability input; prefer over profile/name when known."},"profile":{"type":"string","description":"LinkedIn or other social profile URL. Similar coverage to name+domain — not a fallback when person is absent (data: null)."},"last_name":{"type":"string","description":"Last name."},"first_name":{"type":"string","description":"First name."},"company_name":{"type":"string","description":"Company name (with first_name + last_name). Fallback; similar coverage to profile."},"company_domain":{"type":"string","description":"Company domain (with first_name + last_name). Fallback; similar coverage to profile."}},"additionalProperties":false},"type":{"type":"string","const":"http"},"method":{"enum":["POST","PUT","PATCH"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.28","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.28/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.28","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.28","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_M4Wjq_enTxVhcc59jtc68","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.28","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Enriches a person's profile with career history, email addresses, and phone numbers using People Data Labs data, given an email, LinkedIn URL, or name plus company.","exampleAgentPrompt":"Can you enrich the profile for jane.doe@acme.com using People Data Labs — I need her career history, phone number, and any other emails on file?","exampleUseCases":[{"title":"CRM lead enrichment before outreach","prompt":"I have a new lead — Sarah Chen at Stripe. Her email is sarah.chen@stripe.com. Can you pull her full career history and contact details from PDL so I can personalize my outreach?"},{"title":"Recruiting candidate background lookup","prompt":"I'm considering reaching out to a candidate named Marcus Rivera who works at Salesforce. His company domain is salesforce.com — can you enrich his profile to get his work history and contact info?"},{"title":"Sales prospecting by LinkedIn URL","prompt":"I found this LinkedIn profile for a prospect: https://linkedin.com/in/alexjohnson-product. Can you run it through PDL to get their career history, email, and phone number?"}],"resultDescription":"Returns a structured person profile including full career history (employer names, titles, date ranges), known email addresses, phone numbers, education, and social profiles. If no match is found, returns HTTP 200 with a 404 status and null data — no charge applies. A successful match costs $0.28 per call.","failureModes":["Insufficient input (e.g. first_name + last_name alone without company) returns HTTP 400","No match found returns HTTP 200 with status 404 and data: null (not billed)","Invalid LinkedIn URL or malformed email may return no match","Rate limiting or authentication errors may return 4xx/5xx responses","Person exists in PDL database but with limited data fields populated"],"whenToPreferThis":"Use this endpoint when you need to enrich a known person's professional profile — especially when you have their email address (highest match rate) or LinkedIn URL. It is the right choice for CRM enrichment, sales prospecting, recruiting research, or any workflow requiring structured career history and contact data. Prefer email input when available; fall back to LinkedIn profile URL or name plus company domain. Do not use for company/org lookups or bulk batch enrichment — this endpoint is optimized for single-person resolution.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:32:35.266Z","isFirstParty":false}