[{"data":1,"prerenderedAt":1031},["ShallowReactive",2],{"docs-navigation":3,"docs-\u002Fuse-cases\u002Fbuild-a-list-of-people":459},[4,12,16,21,27,34,41,47,54,59,65,71,76,81,86,91,96,101,106,111,116,121,127,132,137,142,148,154,159,164,169,174,179,186,192,197,202,208,213,218,223,227,232,237,240,244,249,253,256,260,263,267,270,273,279,282,286,289,292,295,299,303,306,310,313,316,319,322,326,330,334,338,343,347,350,353,356,359,362,365,368,371,374,377,380,383,386,389,393,396,399,401,403,405,407,409,411,413,415,417,419,421,423,425,427,429,431,433,435,440,443,447,450,453,456],{"path":5,"title":6,"category":7,"order":8,"family":9,"subfamily":10,"status":11,"endpointId":10,"badgeLabel":10},"\u002Fagents","Agent brief","mcp",40,"AI agents",null,"new",{"path":13,"title":14,"category":7,"order":15,"family":9,"subfamily":10,"status":11,"endpointId":10,"badgeLabel":10},"\u002Fai-agents","Use Reverse Contact from an AI agent",10,{"path":17,"title":18,"category":19,"order":20,"family":10,"subfamily":10,"status":10,"endpointId":10,"badgeLabel":10},"\u002Fapi-reference","API reference","introduction",30,{"path":22,"title":23,"category":19,"order":24,"family":25,"subfamily":10,"status":26,"endpointId":10,"badgeLabel":10},"\u002Fauthentication","Authentication",20,"Get started","updated",{"path":28,"title":29,"category":30,"order":31,"family":32,"subfamily":10,"status":11,"endpointId":33,"badgeLabel":10},"\u002Fendpoints\u002Fbulk-enrich-persons","Bulk enrichment","endpoints",660,"Bulk","bulk-enrich-persons",{"path":35,"title":36,"category":30,"order":37,"family":38,"subfamily":39,"status":26,"endpointId":40,"badgeLabel":10},"\u002Fendpoints\u002Fcheck-company","Company profile status",220,"Fetch","Company","check-company",{"path":42,"title":43,"category":30,"order":44,"family":38,"subfamily":45,"status":26,"endpointId":46,"badgeLabel":10},"\u002Fendpoints\u002Fcheck-person","Person profile status",120,"Person","check-person",{"path":48,"title":49,"category":30,"order":50,"family":51,"subfamily":52,"status":10,"endpointId":53,"badgeLabel":10},"\u002Fendpoints\u002Fcontact-email","Find Email",600,"Contact","Email","contact-email",{"path":55,"title":56,"category":30,"order":57,"family":51,"subfamily":52,"status":10,"endpointId":58,"badgeLabel":10},"\u002Fendpoints\u002Fcontact-email-verify","Verify Email",605,"contact-email-verify",{"path":60,"title":61,"category":30,"order":62,"family":51,"subfamily":63,"status":10,"endpointId":64,"badgeLabel":10},"\u002Fendpoints\u002Fcontact-phone","Find Phone",610,"Phone","contact-phone",{"path":66,"title":67,"category":30,"order":68,"family":69,"subfamily":39,"status":26,"endpointId":70,"badgeLabel":10},"\u002Fendpoints\u002Fenrich-company","Enrich company",90,"Enrichment","enrich-company",{"path":72,"title":73,"category":30,"order":74,"family":69,"subfamily":45,"status":26,"endpointId":75,"badgeLabel":10},"\u002Fendpoints\u002Fenrich-person","Enrich profile",80,"enrich-person",{"path":77,"title":78,"category":30,"order":79,"family":38,"subfamily":39,"status":26,"endpointId":80,"badgeLabel":10},"\u002Fendpoints\u002Ffetch-company","Company profile",200,"fetch-company",{"path":82,"title":83,"category":30,"order":84,"family":38,"subfamily":39,"status":26,"endpointId":85,"badgeLabel":10},"\u002Fendpoints\u002Ffetch-company-live","Company profile live",210,"fetch-company-live",{"path":87,"title":88,"category":30,"order":89,"family":38,"subfamily":45,"status":26,"endpointId":90,"badgeLabel":10},"\u002Fendpoints\u002Ffetch-profile","Person profile",100,"fetch-profile",{"path":92,"title":93,"category":30,"order":94,"family":38,"subfamily":45,"status":26,"endpointId":95,"badgeLabel":10},"\u002Fendpoints\u002Ffetch-profile-live","Person profile live",110,"fetch-profile-live",{"path":97,"title":98,"category":30,"order":99,"family":32,"subfamily":10,"status":11,"endpointId":100,"badgeLabel":10},"\u002Fendpoints\u002Fjob","Get a job",662,"job",{"path":102,"title":103,"category":30,"order":104,"family":32,"subfamily":10,"status":11,"endpointId":105,"badgeLabel":10},"\u002Fendpoints\u002Fjob-cancel","Cancel a job",664,"job-cancel",{"path":107,"title":108,"category":30,"order":109,"family":32,"subfamily":10,"status":11,"endpointId":110,"badgeLabel":10},"\u002Fendpoints\u002Fjob-results","Download job results",663,"job-results",{"path":112,"title":113,"category":30,"order":114,"family":32,"subfamily":10,"status":11,"endpointId":115,"badgeLabel":10},"\u002Fendpoints\u002Fjob-rows","Read job results by page",663.5,"job-rows",{"path":117,"title":118,"category":30,"order":119,"family":32,"subfamily":10,"status":11,"endpointId":120,"badgeLabel":10},"\u002Fendpoints\u002Fjobs","Job history",661,"jobs",{"path":122,"title":123,"category":30,"order":124,"family":125,"subfamily":125,"status":11,"endpointId":126,"badgeLabel":10},"\u002Fendpoints\u002Flist","Get a List",642,"Lists","list",{"path":128,"title":129,"category":30,"order":130,"family":125,"subfamily":125,"status":11,"endpointId":131,"badgeLabel":10},"\u002Fendpoints\u002Flist-create","Create a List",641,"list-create",{"path":133,"title":134,"category":30,"order":135,"family":125,"subfamily":125,"status":11,"endpointId":136,"badgeLabel":10},"\u002Fendpoints\u002Flist-delete","Delete a List",643,"list-delete",{"path":138,"title":139,"category":30,"order":140,"family":125,"subfamily":125,"status":11,"endpointId":141,"badgeLabel":10},"\u002Fendpoints\u002Flist-export","Export a List",644,"list-export",{"path":143,"title":144,"category":30,"order":145,"family":125,"subfamily":146,"status":11,"endpointId":147,"badgeLabel":10},"\u002Fendpoints\u002Flist-intake-signals","Import members and data",648,"Imports","list-intake-signals",{"path":149,"title":150,"category":30,"order":151,"family":125,"subfamily":152,"status":11,"endpointId":153,"badgeLabel":10},"\u002Fendpoints\u002Flist-members","List members",645,"Members","list-members",{"path":155,"title":156,"category":30,"order":157,"family":125,"subfamily":152,"status":11,"endpointId":158,"badgeLabel":10},"\u002Fendpoints\u002Flist-members-add","Add members",646,"list-members-add",{"path":160,"title":161,"category":30,"order":162,"family":125,"subfamily":152,"status":11,"endpointId":163,"badgeLabel":10},"\u002Fendpoints\u002Flist-members-remove","Remove members",647,"list-members-remove",{"path":165,"title":166,"category":30,"order":167,"family":125,"subfamily":146,"status":11,"endpointId":168,"badgeLabel":10},"\u002Fendpoints\u002Flist-operation","Read a List operation",649,"list-operation",{"path":170,"title":171,"category":30,"order":172,"family":125,"subfamily":146,"status":11,"endpointId":173,"badgeLabel":10},"\u002Fendpoints\u002Flist-operation-cancel","Cancel a List operation",650,"list-operation-cancel",{"path":175,"title":176,"category":30,"order":177,"family":125,"subfamily":125,"status":11,"endpointId":178,"badgeLabel":10},"\u002Fendpoints\u002Flists","All Lists",640,"lists",{"path":180,"title":181,"category":30,"order":182,"family":183,"subfamily":184,"status":11,"endpointId":185,"badgeLabel":10},"\u002Fendpoints\u002Fsearch-companies","Company search",94,"Search","Companies","search-organizations",{"path":187,"title":188,"category":30,"order":189,"family":190,"subfamily":10,"status":11,"endpointId":191,"badgeLabel":10},"\u002Fendpoints\u002Fsearch-companies-available-fields","Company search available fields",720,"Utility","search-organizations-available-fields",{"path":193,"title":194,"category":30,"order":195,"family":183,"subfamily":184,"status":11,"endpointId":196,"badgeLabel":10},"\u002Fendpoints\u002Fsearch-companies-count","Company search count",95,"search-organizations-count",{"path":198,"title":199,"category":30,"order":200,"family":183,"subfamily":184,"status":11,"endpointId":201,"badgeLabel":10},"\u002Fendpoints\u002Fsearch-companies-prompt","Agentic Company Search",97,"search-organizations-prompt",{"path":203,"title":204,"category":30,"order":205,"family":183,"subfamily":206,"status":11,"endpointId":207,"badgeLabel":10},"\u002Fendpoints\u002Fsearch-people","People search",92,"People","search-people",{"path":209,"title":210,"category":30,"order":211,"family":190,"subfamily":10,"status":11,"endpointId":212,"badgeLabel":10},"\u002Fendpoints\u002Fsearch-people-auto-suggestion","People auto-suggestion",730,"search-people-auto-suggestion",{"path":214,"title":215,"category":30,"order":216,"family":190,"subfamily":10,"status":11,"endpointId":217,"badgeLabel":10},"\u002Fendpoints\u002Fsearch-people-available-fields","People search available fields",710,"search-people-available-fields",{"path":219,"title":220,"category":30,"order":221,"family":183,"subfamily":206,"status":11,"endpointId":222,"badgeLabel":10},"\u002Fendpoints\u002Fsearch-people-count","People search count",93,"search-people-count",{"path":224,"title":225,"category":30,"order":195,"family":183,"subfamily":206,"status":11,"endpointId":226,"badgeLabel":10},"\u002Fendpoints\u002Fsearch-people-lookalike","People lookalike","search-people-lookalike",{"path":228,"title":229,"category":30,"order":230,"family":183,"subfamily":206,"status":11,"endpointId":231,"badgeLabel":10},"\u002Fendpoints\u002Fsearch-people-prompt","Agentic Search",96,"search-people-prompt",{"path":233,"title":234,"category":30,"order":235,"family":190,"subfamily":10,"status":26,"endpointId":236,"badgeLabel":10},"\u002Fendpoints\u002Fusage","Usage",700,"usage",{"path":238,"title":239,"category":19,"order":15,"family":25,"subfamily":10,"status":10,"endpointId":10,"badgeLabel":10},"\u002Fgetting-started","Getting started",{"path":241,"title":242,"category":243,"order":20,"family":9,"subfamily":10,"status":11,"endpointId":10,"badgeLabel":10},"\u002Fguides\u002Fagent-skills","Agent skills","cli",{"path":245,"title":246,"category":247,"order":20,"family":248,"subfamily":10,"status":26,"endpointId":10,"badgeLabel":10},"\u002Fguides\u002Fapi-key-management","API key management","guides","Credits & limits",{"path":250,"title":251,"category":247,"order":24,"family":252,"subfamily":10,"status":11,"endpointId":10,"badgeLabel":10},"\u002Fguides\u002Fbuild-a-list","Build your first List","Work in bulk",{"path":254,"title":255,"category":247,"order":20,"family":252,"subfamily":10,"status":11,"endpointId":10,"badgeLabel":10},"\u002Fguides\u002Fbulk-enrichment","Enrich people in bulk",{"path":257,"title":258,"category":243,"order":15,"family":259,"subfamily":10,"status":11,"endpointId":10,"badgeLabel":10},"\u002Fguides\u002Fcli","Command line interface (CLI)","CLI",{"path":261,"title":262,"category":247,"order":15,"family":248,"subfamily":10,"status":26,"endpointId":10,"badgeLabel":10},"\u002Fguides\u002Fcredits","Credits",{"path":264,"title":265,"category":247,"order":8,"family":266,"subfamily":10,"status":11,"endpointId":10,"badgeLabel":10},"\u002Fguides\u002Fcurrent-position-resolution","Current position and work history ordering","Understand the data",{"path":268,"title":269,"category":247,"order":24,"family":266,"subfamily":10,"status":26,"endpointId":10,"badgeLabel":10},"\u002Fguides\u002Fdata-freshness","Data freshness",{"path":271,"title":272,"category":247,"order":15,"family":266,"subfamily":10,"status":11,"endpointId":10,"badgeLabel":10},"\u002Fguides\u002Fdata-quality","Data quality",{"path":274,"title":275,"category":276,"order":277,"family":10,"subfamily":10,"status":11,"endpointId":10,"badgeLabel":278},"\u002Fguides\u002Fendpoint-transition-october-2026","Endpoint transition on October 13, 2026","migrations",1,"Important",{"path":280,"title":281,"category":247,"order":8,"family":252,"subfamily":10,"status":11,"endpointId":10,"badgeLabel":10},"\u002Fguides\u002Fenrich-a-csv-file","Enrich a CSV file",{"path":283,"title":284,"category":247,"order":15,"family":285,"subfamily":10,"status":26,"endpointId":10,"badgeLabel":10},"\u002Fguides\u002Ferrors-retries","Error handling & retries","Go to production",{"path":287,"title":288,"category":247,"order":20,"family":25,"subfamily":10,"status":11,"endpointId":10,"badgeLabel":10},"\u002Fguides\u002Ffirst-api-call","Your first API call",{"path":290,"title":291,"category":247,"order":15,"family":252,"subfamily":10,"status":11,"endpointId":10,"badgeLabel":10},"\u002Fguides\u002Flists","Lists: orchestrate enrichment",{"path":293,"title":294,"category":7,"order":24,"family":9,"subfamily":10,"status":26,"endpointId":10,"badgeLabel":10},"\u002Fguides\u002Fmcp","Connect AI agents (MCP)",{"path":296,"title":297,"category":276,"order":298,"family":10,"subfamily":10,"status":11,"endpointId":10,"badgeLabel":10},"\u002Fguides\u002Fmigrating-search-companies-to-organizations","Migrating company search to the new endpoint",2,{"path":300,"title":301,"category":276,"order":302,"family":10,"subfamily":10,"status":11,"endpointId":10,"badgeLabel":10},"\u002Fguides\u002Fmigrating-search-persons-to-people","Migrating people search from persons to people",51,{"path":304,"title":305,"category":247,"order":20,"family":266,"subfamily":10,"status":11,"endpointId":10,"badgeLabel":10},"\u002Fguides\u002Fmissing-and-empty-fields","Missing and empty profile fields",{"path":307,"title":308,"category":247,"order":15,"family":309,"subfamily":10,"status":26,"endpointId":10,"badgeLabel":10},"\u002Fguides\u002Fpolling","Polling for async results","Async results",{"path":311,"title":312,"category":247,"order":24,"family":285,"subfamily":10,"status":26,"endpointId":10,"badgeLabel":10},"\u002Fguides\u002Fproduction-checklist","Production checklist",{"path":314,"title":315,"category":247,"order":24,"family":248,"subfamily":10,"status":11,"endpointId":10,"badgeLabel":10},"\u002Fguides\u002Frate-limits","Rate limits",{"path":317,"title":318,"category":247,"order":24,"family":309,"subfamily":10,"status":26,"endpointId":10,"badgeLabel":10},"\u002Fguides\u002Fwebhooks","Webhooks",{"path":320,"title":321,"category":247,"order":8,"family":25,"subfamily":10,"status":26,"endpointId":10,"badgeLabel":10},"\u002Fguides\u002Fwhich-endpoint-should-i-use","Which endpoint should I use?",{"path":323,"title":324,"category":325,"order":302,"family":10,"subfamily":10,"status":11,"endpointId":10,"badgeLabel":10},"\u002Freference\u002Fareas","Area values","reference",{"path":327,"title":328,"category":325,"order":329,"family":10,"subfamily":10,"status":11,"endpointId":10,"badgeLabel":10},"\u002Freference\u002Findustries","Industry values",50,{"path":331,"title":332,"category":333,"order":15,"family":25,"subfamily":10,"status":11,"endpointId":10,"badgeLabel":10},"\u002Fsdk\u002Fjavascript","TypeScript and JavaScript SDK","sdk",{"path":335,"title":336,"category":333,"order":15,"family":337,"subfamily":10,"status":10,"endpointId":10,"badgeLabel":10},"\u002Fsdk\u002Fjavascript\u002Fasync-jobs","Async jobs","Guides",{"path":339,"title":340,"category":333,"order":341,"family":342,"subfamily":10,"status":10,"endpointId":10,"badgeLabel":10},"\u002Fsdk\u002Fjavascript\u002Fbulk","client.bulk",60,"Resources",{"path":344,"title":345,"category":333,"order":346,"family":337,"subfamily":10,"status":10,"endpointId":10,"badgeLabel":10},"\u002Fsdk\u002Fjavascript\u002Fclient-options","Client options",70,{"path":348,"title":349,"category":333,"order":8,"family":342,"subfamily":10,"status":10,"endpointId":10,"badgeLabel":10},"\u002Fsdk\u002Fjavascript\u002Fcontact","client.contact",{"path":351,"title":352,"category":333,"order":15,"family":342,"subfamily":10,"status":10,"endpointId":10,"badgeLabel":10},"\u002Fsdk\u002Fjavascript\u002Fenrich","client.enrich",{"path":354,"title":355,"category":333,"order":329,"family":337,"subfamily":10,"status":10,"endpointId":10,"badgeLabel":10},"\u002Fsdk\u002Fjavascript\u002Ferrors-and-retries","Errors and retries",{"path":357,"title":358,"category":333,"order":24,"family":342,"subfamily":10,"status":10,"endpointId":10,"badgeLabel":10},"\u002Fsdk\u002Fjavascript\u002Ffetch","client.fetch",{"path":360,"title":361,"category":333,"order":8,"family":337,"subfamily":10,"status":10,"endpointId":10,"badgeLabel":10},"\u002Fsdk\u002Fjavascript\u002Ffilter-constants","Filter values as constants",{"path":363,"title":364,"category":333,"order":20,"family":25,"subfamily":10,"status":10,"endpointId":10,"badgeLabel":10},"\u002Fsdk\u002Fjavascript\u002Ffirst-call","First call",{"path":366,"title":367,"category":333,"order":24,"family":25,"subfamily":10,"status":10,"endpointId":10,"badgeLabel":10},"\u002Fsdk\u002Fjavascript\u002Finstall","Install and configure",{"path":369,"title":370,"category":333,"order":346,"family":342,"subfamily":10,"status":10,"endpointId":10,"badgeLabel":10},"\u002Fsdk\u002Fjavascript\u002Fjobs","client.jobs",{"path":372,"title":373,"category":333,"order":329,"family":342,"subfamily":10,"status":10,"endpointId":10,"badgeLabel":10},"\u002Fsdk\u002Fjavascript\u002Flists","client.lists",{"path":375,"title":376,"category":333,"order":24,"family":337,"subfamily":10,"status":10,"endpointId":10,"badgeLabel":10},"\u002Fsdk\u002Fjavascript\u002Flists-and-bulk","Lists and Bulk enrichment",{"path":378,"title":379,"category":333,"order":20,"family":342,"subfamily":10,"status":10,"endpointId":10,"badgeLabel":10},"\u002Fsdk\u002Fjavascript\u002Fsearch","client.search",{"path":381,"title":382,"category":333,"order":20,"family":337,"subfamily":10,"status":10,"endpointId":10,"badgeLabel":10},"\u002Fsdk\u002Fjavascript\u002Fsearch-budget","Search within a budget",{"path":384,"title":385,"category":333,"order":341,"family":337,"subfamily":10,"status":10,"endpointId":10,"badgeLabel":10},"\u002Fsdk\u002Fjavascript\u002Ftimeouts","Timeouts and cancellation",{"path":387,"title":388,"category":333,"order":74,"family":342,"subfamily":10,"status":10,"endpointId":10,"badgeLabel":10},"\u002Fsdk\u002Fjavascript\u002Fusage","client.usage",{"path":390,"title":391,"category":333,"order":15,"family":392,"subfamily":10,"status":10,"endpointId":10,"badgeLabel":10},"\u002Fsdk\u002Fjavascript\u002Fwithout-the-sdk","Without the SDK","More",{"path":394,"title":395,"category":333,"order":15,"family":25,"subfamily":10,"status":10,"endpointId":10,"badgeLabel":10},"\u002Fsdk\u002Fpython","Python SDK",{"path":397,"title":398,"category":333,"order":15,"family":337,"subfamily":10,"status":10,"endpointId":10,"badgeLabel":10},"\u002Fsdk\u002Fpython\u002Fasync-client","Async client",{"path":400,"title":336,"category":333,"order":24,"family":337,"subfamily":10,"status":10,"endpointId":10,"badgeLabel":10},"\u002Fsdk\u002Fpython\u002Fasync-jobs",{"path":402,"title":340,"category":333,"order":341,"family":342,"subfamily":10,"status":10,"endpointId":10,"badgeLabel":10},"\u002Fsdk\u002Fpython\u002Fbulk",{"path":404,"title":345,"category":333,"order":74,"family":337,"subfamily":10,"status":10,"endpointId":10,"badgeLabel":10},"\u002Fsdk\u002Fpython\u002Fclient-options",{"path":406,"title":349,"category":333,"order":8,"family":342,"subfamily":10,"status":10,"endpointId":10,"badgeLabel":10},"\u002Fsdk\u002Fpython\u002Fcontact",{"path":408,"title":352,"category":333,"order":15,"family":342,"subfamily":10,"status":10,"endpointId":10,"badgeLabel":10},"\u002Fsdk\u002Fpython\u002Fenrich",{"path":410,"title":355,"category":333,"order":341,"family":337,"subfamily":10,"status":10,"endpointId":10,"badgeLabel":10},"\u002Fsdk\u002Fpython\u002Ferrors-and-retries",{"path":412,"title":358,"category":333,"order":24,"family":342,"subfamily":10,"status":10,"endpointId":10,"badgeLabel":10},"\u002Fsdk\u002Fpython\u002Ffetch",{"path":414,"title":361,"category":333,"order":329,"family":337,"subfamily":10,"status":10,"endpointId":10,"badgeLabel":10},"\u002Fsdk\u002Fpython\u002Ffilter-constants",{"path":416,"title":364,"category":333,"order":20,"family":25,"subfamily":10,"status":10,"endpointId":10,"badgeLabel":10},"\u002Fsdk\u002Fpython\u002Ffirst-call",{"path":418,"title":367,"category":333,"order":24,"family":25,"subfamily":10,"status":10,"endpointId":10,"badgeLabel":10},"\u002Fsdk\u002Fpython\u002Finstall",{"path":420,"title":370,"category":333,"order":346,"family":342,"subfamily":10,"status":10,"endpointId":10,"badgeLabel":10},"\u002Fsdk\u002Fpython\u002Fjobs",{"path":422,"title":373,"category":333,"order":329,"family":342,"subfamily":10,"status":10,"endpointId":10,"badgeLabel":10},"\u002Fsdk\u002Fpython\u002Flists",{"path":424,"title":376,"category":333,"order":20,"family":337,"subfamily":10,"status":10,"endpointId":10,"badgeLabel":10},"\u002Fsdk\u002Fpython\u002Flists-and-bulk",{"path":426,"title":379,"category":333,"order":20,"family":342,"subfamily":10,"status":10,"endpointId":10,"badgeLabel":10},"\u002Fsdk\u002Fpython\u002Fsearch",{"path":428,"title":382,"category":333,"order":8,"family":337,"subfamily":10,"status":10,"endpointId":10,"badgeLabel":10},"\u002Fsdk\u002Fpython\u002Fsearch-budget",{"path":430,"title":385,"category":333,"order":346,"family":337,"subfamily":10,"status":10,"endpointId":10,"badgeLabel":10},"\u002Fsdk\u002Fpython\u002Ftimeouts",{"path":432,"title":388,"category":333,"order":74,"family":342,"subfamily":10,"status":10,"endpointId":10,"badgeLabel":10},"\u002Fsdk\u002Fpython\u002Fusage",{"path":434,"title":391,"category":333,"order":15,"family":392,"subfamily":10,"status":10,"endpointId":10,"badgeLabel":10},"\u002Fsdk\u002Fpython\u002Fwithout-the-sdk",{"path":436,"title":437,"category":438,"order":341,"family":439,"subfamily":10,"status":11,"endpointId":10,"badgeLabel":10},"\u002Fuse-cases\u002Fbuild-a-list-of-companies","Build a list of companies","use-cases","Build lists",{"path":441,"title":442,"category":438,"order":329,"family":439,"subfamily":10,"status":11,"endpointId":10,"badgeLabel":10},"\u002Fuse-cases\u002Fbuild-a-list-of-people","Build a list of people",{"path":444,"title":445,"category":438,"order":24,"family":446,"subfamily":10,"status":11,"endpointId":10,"badgeLabel":10},"\u002Fuse-cases\u002Ffind-a-company","Find a company from a domain or a page URL","Find & enrich",{"path":448,"title":449,"category":438,"order":15,"family":446,"subfamily":10,"status":11,"endpointId":10,"badgeLabel":10},"\u002Fuse-cases\u002Ffind-a-person","Find a person from an email, a name or a profile URL",{"path":451,"title":452,"category":438,"order":8,"family":51,"subfamily":10,"status":11,"endpointId":10,"badgeLabel":10},"\u002Fuse-cases\u002Fget-a-work-email-or-phone","Get a work email or a phone number",{"path":454,"title":455,"category":438,"order":277,"family":10,"subfamily":10,"status":11,"endpointId":10,"badgeLabel":10},"\u002Fuse-cases","Reverse Contact API use cases",{"path":457,"title":458,"category":438,"order":20,"family":446,"subfamily":10,"status":11,"endpointId":10,"badgeLabel":10},"\u002Fuse-cases\u002Fkeep-profiles-fresh","Keep profiles fresh",{"id":460,"title":442,"audience":10,"badgeColor":10,"badgeLabel":10,"body":461,"category":438,"description":1022,"endpointId":10,"extension":1023,"family":439,"lastVerified":1024,"links":10,"meta":1025,"navigation":1026,"order":329,"path":441,"relatedArticles":1027,"requiresFlag":10,"seo":1028,"status":11,"stem":1029,"subfamily":10,"__hash__":1030},"docs\u002Fuse-cases\u002Fbuild-a-list-of-people.md",{"type":462,"value":463,"toc":1003},"minimark",[464,468,473,556,560,586,591,610,641,645,656,682,686,700,720,724,735,755,759,767,785,803,807,820,865,883,896,904,910,921,929,933,937,952,956,964,968,977,981,991,995],[465,466,467],"p",{},"Find people by job title, company and location, describe your audience in a prompt, or find people similar to a known profile. You can count a filtered search for free before retrieving profiles. Search returns full profiles synchronously from the index, within a budget you set.",[469,470,472],"h2",{"id":471},"which-endpoint","Which endpoint",[474,475,476,495],"table",{},[477,478,479],"thead",{},[480,481,482,486,489,492],"tr",{},[483,484,485],"th",{},"Input you have",[483,487,488],{},"Endpoint",[483,490,491],{},"Cost",[483,493,494],{},"Mode",[496,497,498,515,529,543],"tbody",{},[480,499,500,504,509,512],{},[501,502,503],"td",{},"Filters to count matches before buying profiles",[501,505,506],{},[507,508,220],"a",{"href":219},[501,510,511],{},"Free",[501,513,514],{},"Synchronous",[480,516,517,520,524,527],{},[501,518,519],{},"Explicit filters",[501,521,522],{},[507,523,204],{"href":203},[501,525,526],{},"1 credit per profile delivered. An empty page is free",[501,528,514],{},[480,530,531,534,538,541],{},[501,532,533],{},"A description of the people to find",[501,535,536],{},[507,537,229],{"href":228},[501,539,540],{},"1 credit per page plus 1 per profile delivered",[501,542,514],{},[480,544,545,548,552,554],{},[501,546,547],{},"One seed profile URL or person id",[501,549,550],{},[507,551,225],{"href":224},[501,553,526],{},[501,555,514],{},[469,557,559],{"id":558},"how-it-works","How it works",[465,561,562,563,567,568,571,572,575,576,578,579,581,582,585],{},"Set ",[564,565,566],"code",{},"RC_API_KEY"," to your ",[507,569,570],{"href":22},"API key",". Install the ",[507,573,574],{"href":331},"TypeScript SDK",", ",[507,577,395],{"href":394}," or ",[507,580,259],{"href":257}," for your chosen example. Shell examples use ",[564,583,584],{},"jq",". Prompt and lookalike searches are alternatives to filtered search, each with its own charges.",[587,588,590],"h3",{"id":589},"count-your-target-audience-for-free","Count your target audience for free",[465,592,593,594,597,598,601,602,605,606,609],{},"Count people whose current title matches ",[564,595,596],{},"CTO"," and whose location is France. The response contains ",[564,599,600],{},"data.count"," without any profiles. Leave ",[564,603,604],{},"cursor"," and ",[564,607,608],{},"perPage"," out of the count request, then use the same filters for the paid search.",[611,612,614,625,633],"code-group",{"title":613},"Code Examples",[615,616,623],"pre",{"className":617,"code":619,"filename":620,"language":621,"meta":622},[618],"language-bash","curl --fail-with-body -sS -X POST https:\u002F\u002Fapi.reversecontact.com\u002Fv2\u002Fsearch\u002Fpeople\u002Fcount \\\n  -H \"Authorization: Bearer $RC_API_KEY\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\"currentPositionTitle\": \"CTO\", \"location\": {\"country\": \"France\"}}'\n","cURL","bash","",[564,624,619],{"__ignoreMap":622},[615,626,631],{"className":627,"code":629,"filename":574,"language":630,"meta":622},[628],"language-typescript","import ReverseContact from \"@reverse-contact\u002Fsdk\";\n\nconst client = new ReverseContact({ apiKey: process.env.RC_API_KEY });\n\nconst count = await client.search.countPeople({\n  currentPositionTitle: \"CTO\",\n  location: { country: \"France\" }\n});\nconsole.log(\"Matching people:\", count.data.count);\n","typescript",[564,632,629],{"__ignoreMap":622},[615,634,639],{"className":635,"code":637,"filename":395,"language":638,"meta":622},[636],"language-python","import os\n\nfrom reversecontact import ReverseContact\n\nwith ReverseContact(api_key=os.environ[\"RC_API_KEY\"]) as client:\n    count = client.search.count_people(\n        current_position_title=\"CTO\", location={\"country\": \"France\"}\n    )\n    print(\"Matching people:\", count.data.count if count.data else None)\n","python",[564,640,637],{"__ignoreMap":622},[587,642,644],{"id":643},"read-profiles-within-a-credit-budget","Read profiles within a credit budget",[465,646,647,648,651,652,655],{},"Retrieve at most 100 profiles for at most 100 credits. Request 25 at a time and reduce the final request to the remaining budget. The raw API returns profiles in ",[564,649,650],{},"data.data"," and the next cursor in ",[564,653,654],{},"data.metadata.nextCursor",". SDK iterators handle pagination, and the CLI counts for free before searching.",[611,657,658,664,670,676],{"title":613},[615,659,662],{"className":660,"code":661,"filename":620,"language":621,"meta":622},[618],"remaining=100\ncursor=\"\"\nfilters='{\"currentPositionTitle\": \"CTO\", \"location\": {\"country\": \"France\"}}'\nwhile [ \"$remaining\" -gt 0 ]; do\n  size=$((remaining \u003C 25 ? remaining : 25))\n  body=$(printf '%s' \"$filters\" | jq --arg cursor \"$cursor\" --argjson size \"$size\" \\\n    '. + {perPage: $size} + (if $cursor == \"\" then {} else {cursor: $cursor} end)')\n  result=$(curl --fail-with-body -sS -X POST https:\u002F\u002Fapi.reversecontact.com\u002Fv2\u002Fsearch\u002Fpeople \\\n    -H \"Authorization: Bearer $RC_API_KEY\" \\\n    -H \"Content-Type: application\u002Fjson\" -d \"$body\") || break\n  printf '%s' \"$result\" | jq -c '.data.data[]'\n  delivered=$(printf '%s' \"$result\" | jq -er '.data.data | length')\n  remaining=$((remaining - delivered))\n  next_cursor=$(printf '%s' \"$result\" | jq -r '.data.metadata.nextCursor \u002F\u002F empty')\n  [ -z \"$next_cursor\" ] && break\n  [ \"$next_cursor\" = \"$cursor\" ] && { echo \"Repeated cursor\" >&2; break; }\n  cursor=$next_cursor\ndone\n",[564,663,661],{"__ignoreMap":622},[615,665,668],{"className":666,"code":667,"filename":574,"language":630,"meta":622},[628],"import ReverseContact from \"@reverse-contact\u002Fsdk\";\n\nconst client = new ReverseContact({ apiKey: process.env.RC_API_KEY });\n\nfor await (const person of client.search.iterPeople(\n  { currentPositionTitle: \"CTO\", location: { country: \"France\" }, perPage: 25 },\n  { maxResults: 100 }\n)) {\n  console.log(person.firstName, person.lastName);\n}\n",[564,669,667],{"__ignoreMap":622},[615,671,674],{"className":672,"code":673,"filename":395,"language":638,"meta":622},[636],"import os\n\nfrom reversecontact import ReverseContact\n\nwith ReverseContact(api_key=os.environ[\"RC_API_KEY\"]) as client:\n    for person in client.search.iter_people(\n        current_position_title=\"CTO\",\n        location={\"country\": \"France\"},\n        per_page=25,\n        max_results=100,\n    ):\n        if person is not None:\n            print(person.first_name, person.last_name)\n",[564,675,673],{"__ignoreMap":622},[615,677,680],{"className":678,"code":679,"filename":259,"language":621,"meta":622},[618],"remaining=100\ncursor=\"\"\nwhile [ \"$remaining\" -gt 0 ]; do\n  size=$((remaining \u003C 25 ? remaining : 25))\n  if [ -n \"$cursor\" ]; then\n    result=$(rc search people --title CTO --country France --limit \"$size\" --cursor \"$cursor\" --json) || break\n  else\n    result=$(rc search people --title CTO --country France --limit \"$size\" --json) || break\n  fi\n  printf '%s' \"$result\" | jq -c '.data.data[]'\n  delivered=$(printf '%s' \"$result\" | jq -er '.data.data | length')\n  remaining=$((remaining - delivered))\n  next_cursor=$(printf '%s' \"$result\" | jq -r '.data.metadata.nextCursor \u002F\u002F empty')\n  [ -z \"$next_cursor\" ] && break\n  [ \"$next_cursor\" = \"$cursor\" ] && { echo \"Repeated cursor\" >&2; break; }\n  cursor=$next_cursor\ndone\n",[564,681,679],{"__ignoreMap":622},[587,683,685],{"id":684},"describe-the-audience-in-a-prompt","Describe the audience in a prompt",[465,687,688,689,605,692,695,696,699],{},"You can use Agentic Search when your input is a sentence. Inspect ",[564,690,691],{},"data.interpretation.filters",[564,693,694],{},"warnings"," before buying more pages. This example requests one page of up to 25 profiles, which costs at most 26 credits. Do not add explicit search filters alongside ",[564,697,698],{},"prompt",".",[611,701,702,708,714],{"title":613},[615,703,706],{"className":704,"code":705,"filename":620,"language":621,"meta":622},[618],"curl --fail-with-body -sS -X POST https:\u002F\u002Fapi.reversecontact.com\u002Fv2\u002Fsearch\u002Fpeople\u002Fprompt \\\n  -H \"Authorization: Bearer $RC_API_KEY\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\"prompt\": \"CTOs at software companies in France\", \"perPage\": 25}'\n",[564,707,705],{"__ignoreMap":622},[615,709,712],{"className":710,"code":711,"filename":574,"language":630,"meta":622},[628],"import ReverseContact from \"@reverse-contact\u002Fsdk\";\n\nconst client = new ReverseContact({ apiKey: process.env.RC_API_KEY });\n\nconst page = await client.search.peopleByPrompt({\n  prompt: \"CTOs at software companies in France\", perPage: 25\n});\nconsole.log(\"Filters:\", page.interpretation?.filters);\nconsole.log(\"Warnings:\", page.interpretation?.warnings);\nconsole.log(page.data, \"credits:\", page.quotas?.creditsConsumed);\n",[564,713,711],{"__ignoreMap":622},[615,715,718],{"className":716,"code":717,"filename":395,"language":638,"meta":622},[636],"import os\n\nfrom reversecontact import ReverseContact\n\nwith ReverseContact(api_key=os.environ[\"RC_API_KEY\"]) as client:\n    page = client.search.people_by_prompt(\n        prompt=\"CTOs at software companies in France\", per_page=25\n    )\n    if page.interpretation is not None:\n        print(\"Filters:\", page.interpretation.filters)\n        print(\"Warnings:\", page.interpretation.warnings)\n    print(page.data, \"next cursor:\", page.next_cursor)\n",[564,719,717],{"__ignoreMap":622},[587,721,723],{"id":722},"find-people-similar-to-a-seed-profile","Find people similar to a seed profile",[465,725,726,727,730,731,734],{},"You can use People lookalike with exactly one indexed seed ",[564,728,729],{},"url"," or person ",[564,732,733],{},"id"," and no extra search filters. Results exclude the seed. This example retrieves at most 50 lookalikes for at most 50 credits.",[611,736,737,743,749],{"title":613},[615,738,741],{"className":739,"code":740,"filename":620,"language":621,"meta":622},[618],"remaining=50\ncursor=\"\"\nfilters='{\"url\": \"https:\u002F\u002Fwww.social.com\u002Fin\u002Fjanedoe\"}'\nwhile [ \"$remaining\" -gt 0 ]; do\n  size=$((remaining \u003C 25 ? remaining : 25))\n  body=$(printf '%s' \"$filters\" | jq --arg cursor \"$cursor\" --argjson size \"$size\" \\\n    '. + {perPage: $size} + (if $cursor == \"\" then {} else {cursor: $cursor} end)')\n  result=$(curl --fail-with-body -sS -X POST https:\u002F\u002Fapi.reversecontact.com\u002Fv2\u002Fsearch\u002Fpeople\u002Flookalike \\\n    -H \"Authorization: Bearer $RC_API_KEY\" \\\n    -H \"Content-Type: application\u002Fjson\" -d \"$body\") || break\n  printf '%s' \"$result\" | jq -c '.data.data[]'\n  delivered=$(printf '%s' \"$result\" | jq -er '.data.data | length')\n  remaining=$((remaining - delivered))\n  next_cursor=$(printf '%s' \"$result\" | jq -r '.data.metadata.nextCursor \u002F\u002F empty')\n  [ -z \"$next_cursor\" ] && break\n  [ \"$next_cursor\" = \"$cursor\" ] && { echo \"Repeated cursor\" >&2; break; }\n  cursor=$next_cursor\ndone\n",[564,742,740],{"__ignoreMap":622},[615,744,747],{"className":745,"code":746,"filename":574,"language":630,"meta":622},[628],"import ReverseContact from \"@reverse-contact\u002Fsdk\";\n\nconst client = new ReverseContact({ apiKey: process.env.RC_API_KEY });\n\nfor await (const person of client.search.iterPeopleLookalike(\n  { url: \"https:\u002F\u002Fwww.social.com\u002Fin\u002Fjanedoe\", perPage: 25 },\n  { maxResults: 50 }\n)) {\n  console.log(person.firstName, person.lastName);\n}\n",[564,748,746],{"__ignoreMap":622},[615,750,753],{"className":751,"code":752,"filename":395,"language":638,"meta":622},[636],"import os\n\nfrom reversecontact import ReverseContact\n\nwith ReverseContact(api_key=os.environ[\"RC_API_KEY\"]) as client:\n    for person in client.search.iter_people_lookalike(\n        url=\"https:\u002F\u002Fwww.social.com\u002Fin\u002Fjanedoe\", per_page=25, max_results=50\n    ):\n        if person is not None:\n            print(person.first_name, person.last_name)\n",[564,754,752],{"__ignoreMap":622},[469,756,758],{"id":757},"what-it-costs","What it costs",[465,760,761,762,766],{},"People search and People lookalike cost ",[763,764,765],"strong",{},"1 credit per profile delivered",". An empty page costs nothing, and counting a filtered search is free. Every result is a full profile, so no second fetch is needed to get the profile fields.",[465,768,769,770,773,774,777,778,781,782,699],{},"Agentic Search costs ",[763,771,772],{},"1 credit per page for the search, plus 1 credit per profile delivered",". The page fee still applies when no profile matches. SDK iterators use ",[564,775,776],{},"maxResults"," \u002F ",[564,779,780],{},"max_results"," to cap returned profiles, but this limit does not cover the extra page fees. Budget prompt pages separately or set an ",[507,783,784],{"href":245},"API key credit limit",[786,787,789],"docs-alert",{"type":788},"note",[465,790,791,792,795,796,799,800,699],{},"Count a query for free, then retrieve 100 profiles over four full pages of 25: filtered search costs ",[763,793,794],{},"100 credits",". The same four full pages through Agentic Search cost 100 + 4 = ",[763,797,798],{},"104 credits",". Each additional empty prompt page costs ",[763,801,802],{},"1 credit",[469,804,806],{"id":805},"good-to-know","Good to know",[465,808,809,810,813,814,816,817,699],{},"Filters combine with AND. Supported arrays such as ",[564,811,812],{},"currentPositionTitle"," match any listed value. Title matching is token-based, so ",[564,815,596],{}," can also match ",[564,818,819],{},"Deputy CTO",[465,821,822,823,826,827,829,830,833,834,837,838,840,841,844,845,848,849,852,853,605,856,859,860,864],{},"Use ",[564,824,825],{},"currentCompanyIndustry"," values from ",[507,828,328],{"href":327},", and full ",[564,831,832],{},"location.area"," ids such as ",[564,835,836],{},"MC:DACH"," from ",[507,839,324],{"href":323},". The ",[564,842,843],{},"currentFunction"," filter accepts values such as ",[564,846,847],{},"Marketing",", and ",[564,850,851],{},"currentSeniority"," accepts ",[564,854,855],{},"Director",[564,857,858],{},"VP",". Check the ",[507,861,863],{"href":862},"\u002Fendpoints\u002Fsearch-people#request-body","People search filter reference"," for all accepted values and exclusions.",[465,866,867,868,871,872,875,876,879,880,699],{},"For headcount, ",[564,869,870],{},"currentCompanyEmployeeCountRange"," matches whole size brackets: ",[564,873,874],{},"{ \"min\": 51, \"max\": 200 }"," matches the 51 to 200 bracket. Unknown fields and invalid closed-list values return ",[564,877,878],{},"422"," and cost 0 credits. Search count calls still count toward your ",[507,881,882],{"href":314},"rate limits",[465,884,885,886,888,889,891,892,895],{},"Request 1 to 100 profiles per page, 25 by default. Keep filters unchanged and pass the opaque cursor back as ",[564,887,604],{},". Stop when ",[564,890,654],{}," is ",[564,893,894],{},"null"," or your budget is spent. A short or empty page can still have a next cursor.",[465,897,898,899,903],{},"For filtered People search, read successive pages within 10 minutes for a consistent cached result set. The ",[507,900,902],{"href":901},"\u002Fendpoints\u002Fsearch-people#pagination-and-credits","pagination reference"," describes what happens after that.",[465,905,906,907,909],{},"For prompt searches, reuse the same prompt on the next page. You can send ",[564,908,691],{}," to People search count for a free total after the first paid prompt page.",[465,911,912,913,916,917,920],{},"A lookalike seed must already be indexed. An unindexed URL returns a free ",[564,914,915],{},"404",". Search uses cached data, so use ",[507,918,919],{"href":457},"profile freshness checks"," when you need a refresh.",[465,922,923,924,926,927,699],{},"The examples print profiles for your application to store. To save people in a persistent Reverse Contact List and buy contact data, use ",[507,925,291],{"href":290},". For individual profiles, see ",[507,928,452],{"href":451},[469,930,932],{"id":931},"faq","FAQ",[587,934,936],{"id":935},"how-do-i-count-people-matching-search-filters-without-spending-credits","How do I count people matching search filters without spending credits?",[465,938,939,940,943,944,578,946,948,949,951],{},"Send the People search filters to ",[564,941,942],{},"POST \u002Fv2\u002Fsearch\u002Fpeople\u002Fcount",", without ",[564,945,604],{},[564,947,608],{},". People search count returns ",[564,950,600],{}," and costs 0 credits, but the call counts toward request rate limits.",[587,953,955],{"id":954},"how-do-i-cap-the-credits-spent-on-a-people-search","How do I cap the credits spent on a people search?",[465,957,958,959,777,961,963],{},"For filtered People search, request no more profiles than your remaining credit budget, or use an SDK iterator with ",[564,960,776],{},[564,962,780],{},". Each delivered profile costs 1 credit. Agentic Search adds 1 credit per page, so budget those pages separately or set an API key credit limit.",[587,965,967],{"id":966},"does-an-empty-people-search-page-mean-there-are-no-more-results","Does an empty people search page mean there are no more results?",[465,969,970,971,973,974,976],{},"No. A search page can be empty while ",[564,972,654],{}," is still set. Continue with that cursor until the cursor is ",[564,975,894],{}," or your budget is spent.",[587,978,980],{"id":979},"can-i-search-for-people-using-a-sentence-instead-of-filters","Can I search for people using a sentence instead of filters?",[465,982,983,984,986,987,990],{},"Yes. Agentic Search accepts a ",[564,985,698],{}," and returns the applied filters and warnings in ",[564,988,989],{},"data.interpretation",". Each page costs 1 credit plus 1 credit per profile delivered. You cannot add explicit search filters alongside the prompt.",[587,992,994],{"id":993},"how-do-i-find-people-similar-to-a-social-profile","How do I find people similar to a Social profile?",[465,996,997,998,730,1000,1002],{},"Send exactly one seed ",[564,999,729],{},[564,1001,733],{}," to People lookalike. The seed must already be indexed and is excluded from the results. Each delivered lookalike costs 1 credit. People lookalike does not accept additional search filters.",{"title":622,"searchDepth":1004,"depth":1004,"links":1005},3,[1006,1007,1013,1014,1015],{"id":471,"depth":298,"text":472},{"id":558,"depth":298,"text":559,"children":1008},[1009,1010,1011,1012],{"id":589,"depth":1004,"text":590},{"id":643,"depth":1004,"text":644},{"id":684,"depth":1004,"text":685},{"id":722,"depth":1004,"text":723},{"id":757,"depth":298,"text":758},{"id":805,"depth":298,"text":806},{"id":931,"depth":298,"text":932,"children":1016},[1017,1018,1019,1020,1021],{"id":935,"depth":1004,"text":936},{"id":954,"depth":1004,"text":955},{"id":966,"depth":1004,"text":967},{"id":979,"depth":1004,"text":980},{"id":993,"depth":1004,"text":994},"Build a prospect list with the people search API. Count matches for free, filter by title and location, use prompts or lookalikes, and cap credits.","md","2026-11-04",{},true,"\u002Fdocs\u002Fguides\u002Flists,\u002Fdocs\u002Fguides\u002Fcredits,\u002Fdocs\u002Fguides\u002Fapi-key-management,\u002Fdocs\u002Fguides\u002Frate-limits",{"title":442,"description":1022},"use-cases\u002Fbuild-a-list-of-people","dLKt5R2Fx1mcPHdu-sbmeUUm2fwPar4shbYeLVoScs4",1793830203167]