{"uid":"cap_UgzmZbOF3LKsu8E8Y_C9B","slug":"stablepeopledata-dev-487f48ef","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://stablepeopledata.dev/api/pdl/person/search","method":"POST","headers":{},"bodySchema":{"type":"object","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"}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.28","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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_VlXqoAyBh857NPk5ZLPL1","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.28","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","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 up to 10 software engineers in New York City who currently work at companies with more than 500 employees — use an Elasticsearch query filtering on job_title_role 'engineering', location_metro 'new york', and company_size '>500'.","exampleUseCases":[{"title":"Find decision makers at Fortune 500s","prompt":"Search the PDL person database for VP-level and above decision makers at Fortune 500 companies in the healthcare industry — filter on job_title_levels 'vp' or 'c_suite', industry 'health care', and company_size '>10000', and return up to 25 profiles with their work emails and LinkedIn URLs."},{"title":"Source senior engineers with ML skills","prompt":"Look through the PDL person database for senior or staff machine learning engineers currently based in the San Francisco Bay Area who have Python or TensorFlow in their skills — use an Elasticsearch query filtering on job_title_role 'engineering', job_title_levels 'senior', location_metro 'san francisco', and skills containing 'machine learning', and give me the first 20 results."},{"title":"Find recent graduates entering finance","prompt":"Query the PDL person database for people who graduated from an Ivy League university in the last three years and currently hold an entry-level role at a financial services company — filter on education_school_name for Ivy League schools, graduation year 2022 or later, industry 'financial services', and job_title_levels 'entry', returning up to 15 profiles with contact details."}],"resultDescription":"An array of person records matching the query, each containing demographics, current and past work history, education, social profiles, and contact details, plus a scroll_token for fetching the next page of results.","failureModes":["Invalid Elasticsearch DSL or SQL syntax returns a 400 error","Requested size exceeds allowed limit returns an error","Insufficient PDL credits for the requested size returns a payment/quota error","scroll_token expiration causes pagination to fail","No matching records returns an empty results array","Rate limiting or quota exhaustion returns a 429 error"],"whenToPreferThis":"Use this endpoint when you need to search across a large corpus of 3B+ person records with flexible, expressive query logic (Elasticsearch DSL or SQL). Prefer this over enrichment endpoints when you don't have an identifier for a specific person and need to discover matching profiles based on attributes. Best for sales prospecting, lead generation, talent sourcing, and market research use cases requiring bulk or filtered person lookups.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:35:41.798Z","isFirstParty":false}