{"uid":"cap_rMMDH_-L35uGVvU-EzK7R","slug":"pdl-person-search-ebdccfd4","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.","url":"https://stable-people-data-git-pdl-signoz-usage-alarms-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 ..."},"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":{"request":{"size":10,"query":{"match_all":{}},"dataset":"all","titlecase":false},"response":{"_truncated":true,"_originalSize":188483}},"exampleRequest":{"size":10,"query":{"match_all":{}},"dataset":"all","titlecase":false},"tags":["x402"],"displayCostAmount":"0.04","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":1,"rating":{"score":"1.00","successRate":"0.84","reviews":1,"stars":"5.0","state":"rated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.04/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.04","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.04","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_dqcofsktjorpL5u6xH3YG","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.04","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, returning paginated matching person profiles.","exampleAgentPrompt":"Search the PDL person database for software engineers currently at Google with a senior or above title in the San Francisco Bay Area — use an Elasticsearch DSL query and return the first page of results.","exampleUseCases":null,"resultDescription":"A list of matching person records with fields such as name, job title, employer, location, email, phone, LinkedIn URL, education history, and skills, plus a scroll_token for fetching the next page of results.","failureModes":["Invalid Elasticsearch DSL or SQL syntax returns a query parsing error","Expired or invalid scroll_token results in pagination failure","Rate limiting or quota exhaustion returns a 429 error","Malformed request body returns a 400 validation error","No matching records returns an empty result set","Authentication failure returns a 401 or 403 error"],"whenToPreferThis":"Use this endpoint when you need to search across a large population of person records with flexible query logic (DSL or SQL), especially when filtering on multiple attributes simultaneously or paginating through large result sets. Prefer this over the PDL Person Enrich endpoint when you don't have a specific identifier (email, LinkedIn URL) and need to discover people matching a set of criteria.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":38,"lastUsedAt":"2026-07-15T18:49:24.914Z","lastSuccessfullyRanAt":"2026-07-15T18:49:24.914Z","lastHealthCheckAt":"2026-09-15T18:36:15.693Z","isFirstParty":false}