{"uid":"cap_i-AcrapNj1cwda2II5OML","slug":"pdl-person-enrichment-api-b35d1922","name":"PDL Person 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. May include personal PII.","url":"https://stable-enrich-git-shafu-stabledomains-pork-25b57c-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.2","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.2/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.2","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.2","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_eAGxiwZJCC3MXhYpDEF5w","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.2","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, emails, and phone numbers using People Data Labs (PDL) data, identified by email, LinkedIn URL, or name+company.","exampleAgentPrompt":"Can you pull up the career history, email addresses, and phone numbers for Jane Smith who works at Stripe? Her LinkedIn is linkedin.com/in/janesmith.","exampleUseCases":[{"title":"Sales lead enrichment before outreach","prompt":"I have a prospect named Michael Chen at Salesforce — can you get me his work email, phone number, and job title history so I can personalize my outreach?"},{"title":"Verify contact details by email","prompt":"I have the email address m.johnson@hubspot.com — can you enrich it to get the full career history, current role, and any other contact info associated with that person?"},{"title":"Recruit candidate background lookup","prompt":"We're considering reaching out to a candidate named Sarah Patel who used to be at Google — her LinkedIn is linkedin.com/in/sarahpatel. Can you pull her full employment history and contact details?"}],"resultDescription":"Returns a structured person profile including full name, current and past job titles, employers, career timeline, known email addresses, phone numbers, location, and social profiles. If no match is found, returns HTTP 200 with status 404 and data as null. May include personal PII.","failureModes":["Insufficient identifiers (first+last name alone without company) returns HTTP 400","No matching person found returns HTTP 200 with status=404 and data=null","Invalid LinkedIn URL format causes lookup failure","Rate limiting or quota exceeded returns an error response","Stale or incomplete PDL data may return partial profile with missing fields"],"whenToPreferThis":"Use this endpoint when you have a specific individual to look up and need comprehensive contact and career data — especially when you have their email (most reliable), LinkedIn profile URL, or at minimum their full name plus company name or domain. Prefer over general people-search endpoints when you know who you're looking for rather than searching by criteria. Best for lead enrichment, candidate research, or contact verification workflows where PII is acceptable.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:32:37.305Z","isFirstParty":false}