{"uid":"cap_MslDtCRwNuQTNNEiGNxPJ","slug":"pdl-person-search-7bd58a07","name":"PDL Person Search","description":"PDL Person Search - Search across 3B+ person records using Elasticsearch DSL or SQL queries. Returns matching person records with pagination via scroll_token. Price scales with the requested `size` (1 PDL credit per result).","url":"https://stable-people-data-git-shafu-pdl-api-settl-95fdf9-merit-systems.vercel.app/api/pdl/person/search","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":{"sql":{"type":"string","description":"SQL query: SELECT * FROM person WHERE ... Do not include LIMIT — use size for result count."},"size":{"type":"integer","maximum":100,"minimum":1,"description":"Batch size (1-100, default 1)"},"query":{"type":"object","description":"Elasticsearch v7.7 DSL query object","propertyNames":{"type":"string"},"additionalProperties":{}},"dataset":{"type":"string","description":"Datasets to include: resume, email, phone, mobile_phone, street_address, consumer_social, developer, all"},"titlecase":{"type":"boolean","description":"Titlecase text in response"},"scroll_token":{"type":"string","description":"Pagination token from previous response"}},"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_xZqnYcL8vWjx0Op-JPiAB","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":"Search across 3B+ person records using Elasticsearch DSL or SQL queries with pagination support, powered by People Data Labs.","exampleAgentPrompt":"Search PDL's 3 billion person records for software engineers currently working in Austin, Texas at companies with more than 500 employees — give me 10 results using an Elasticsearch DSL query.","exampleUseCases":[{"title":"B2B prospecting list for sales team","prompt":"Find me 25 VP-level marketing professionals working at SaaS companies in New York using a SQL query like SELECT * FROM person WHERE job_title LIKE '%VP%' AND job_company_industry = 'internet software and services' AND location_metro = 'new york'"},{"title":"Recruiting outreach for engineering roles","prompt":"Search People Data Labs for senior software engineers in Seattle who have Python and machine learning skills — I need 15 results and want to include phone and email contact data in the response."},{"title":"Paginating through large person search results","prompt":"I already ran a People Data Labs person search and got a scroll_token back — can you fetch the next batch of 20 results using that pagination token?"}],"resultDescription":"Returns matching person records including name, job title, employer, location, email addresses, phone numbers, education history, social profiles, and other demographic fields depending on the requested dataset. Also returns a scroll_token for fetching subsequent pages and a total count of matching records.","failureModes":["Invalid or malformed Elasticsearch DSL query returns a 400 error","SQL syntax errors cause query rejection","Requesting size > 100 fails schema validation","Expired or invalid scroll_token breaks pagination","Insufficient PDL credits causes a 402 or rejection","No matching records returns an empty results array","Dataset parameter with unsupported value causes an error"],"whenToPreferThis":"Use this endpoint when you need to search across a large, broad population of person records using flexible query logic (SQL or Elasticsearch DSL). Prefer this over person enrichment when you don't have a known identifier but want to discover people matching demographic, professional, or geographic criteria. Ideal for building prospect lists, recruiting pipelines, or audience segments at scale with pagination support.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:35:41.796Z","isFirstParty":false}