[{"data":1,"prerenderedAt":975},["ShallowReactive",2],{"docs-navigation":3,"docs-\u002Fuse-cases\u002Fbuild-a-list-of-companies":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":437,"audience":10,"badgeColor":10,"badgeLabel":10,"body":461,"category":438,"description":966,"endpointId":10,"extension":967,"family":439,"lastVerified":968,"links":10,"meta":969,"navigation":970,"order":341,"path":436,"relatedArticles":971,"requiresFlag":10,"seo":972,"status":11,"stem":973,"subfamily":10,"__hash__":974},"docs\u002Fuse-cases\u002Fbuild-a-list-of-companies.md",{"type":462,"value":463,"toc":948},"minimark",[464,468,473,543,551,555,580,585,600,631,635,646,672,676,690,710,714,722,740,759,774,778,785,824,844,861,867,877,882,886,890,902,906,911,915,923,927,933,937],[465,466,467],"p",{},"Find companies by industry, headcount and headquarters location, or describe the companies you want in a sentence. You can count a filtered search for free before retrieving profiles. Search returns full company profiles synchronously from the index, within your credit budget.",[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],"tbody",{},[480,499,500,504,509,512],{},[501,502,503],"td",{},"Filters to count matches before buying profiles",[501,505,506],{},[507,508,194],"a",{"href":193},[501,510,511],{},"Free",[501,513,514],{},"Synchronous",[480,516,517,520,524,527],{},[501,518,519],{},"Explicit company filters",[501,521,522],{},[507,523,181],{"href":180},[501,525,526],{},"1 credit per company delivered. An empty page is free",[501,528,514],{},[480,530,531,534,538,541],{},[501,532,533],{},"A description of the companies to find",[501,535,536],{},[507,537,199],{"href":198},[501,539,540],{},"1 credit per page plus 1 per company delivered",[501,542,514],{},[465,544,545,546,550],{},"The API routes use ",[547,548,549],"code",{},"\u002Fv2\u002Fsearch\u002Forganizations",". The reference pages linked above keep their existing company-search addresses.",[469,552,554],{"id":553},"how-it-works","How it works",[465,556,557,558,561,562,565,566,569,570,572,573,575,576,579],{},"Set ",[547,559,560],{},"RC_API_KEY"," to your ",[507,563,564],{"href":22},"API key",". Install the ",[507,567,568],{"href":331},"TypeScript SDK",", ",[507,571,395],{"href":394}," or ",[507,574,259],{"href":257}," for your chosen example. Shell examples use ",[547,577,578],{},"jq",". Prompt search is an alternative to filtered search, with its own charges.",[581,582,584],"h3",{"id":583},"count-the-companies-that-match","Count the companies that match",[465,586,587,588,591,592,595,596,599],{},"Count software companies headquartered in France, in the 51 to 200 employee bracket, founded in 2015 or later. Read ",[547,589,590],{},"data.count"," and reuse the same filters for the paid search. Leave ",[547,593,594],{},"cursor"," and ",[547,597,598],{},"perPage"," out of the count request.",[601,602,604,615,623],"code-group",{"title":603},"Code Examples",[605,606,613],"pre",{"className":607,"code":609,"filename":610,"language":611,"meta":612},[608],"language-bash","curl --fail-with-body -sS -X POST https:\u002F\u002Fapi.reversecontact.com\u002Fv2\u002Fsearch\u002Forganizations\u002Fcount \\\n  -H \"Authorization: Bearer $RC_API_KEY\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\"industry\": \"Software Development\", \"employeeCountRange\": {\"min\": 51, \"max\": 200}, \"foundedYear\": {\"min\": 2015}, \"location\": {\"countryCode\": \"FR\"}}'\n","cURL","bash","",[547,614,609],{"__ignoreMap":612},[605,616,621],{"className":617,"code":619,"filename":568,"language":620,"meta":612},[618],"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.countOrganizations({\n  industry: \"Software Development\",\n  employeeCountRange: { min: 51, max: 200 },\n  foundedYear: { min: 2015 },\n  location: { countryCode: \"FR\" }\n});\nconsole.log(\"Matching companies:\", count.data.count);\n","typescript",[547,622,619],{"__ignoreMap":612},[605,624,629],{"className":625,"code":627,"filename":395,"language":628,"meta":612},[626],"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_organizations(\n        industry=\"Software Development\",\n        employee_count_range={\"min\": 51, \"max\": 200},\n        founded_year={\"min\": 2015},\n        location={\"countryCode\": \"FR\"},\n    )\n    print(\"Matching companies:\", count.data.count if count.data else None)\n","python",[547,630,627],{"__ignoreMap":612},[581,632,634],{"id":633},"retrieve-the-company-profiles-within-budget","Retrieve the company profiles within budget",[465,636,637,638,641,642,645],{},"Retrieve at most 100 companies for at most 100 credits. Request pages of up to 25 companies, with a smaller final request when needed. The raw API returns companies in ",[547,639,640],{},"data.data"," and the cursor in ",[547,643,644],{},"data.metadata.nextCursor",". The SDKs handle pagination, and the CLI counts for free before searching.",[601,647,648,654,660,666],{"title":603},[605,649,652],{"className":650,"code":651,"filename":610,"language":611,"meta":612},[608],"remaining=100\ncursor=\"\"\nfilters='{\"industry\": \"Software Development\", \"employeeCountRange\": {\"min\": 51, \"max\": 200}, \"foundedYear\": {\"min\": 2015}, \"location\": {\"countryCode\": \"FR\"}}'\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\u002Forganizations \\\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",[547,653,651],{"__ignoreMap":612},[605,655,658],{"className":656,"code":657,"filename":568,"language":620,"meta":612},[618],"import ReverseContact from \"@reverse-contact\u002Fsdk\";\n\nconst client = new ReverseContact({ apiKey: process.env.RC_API_KEY });\n\nfor await (const company of client.search.iterOrganizations(\n  {\n    industry: \"Software Development\",\n    employeeCountRange: { min: 51, max: 200 },\n    foundedYear: { min: 2015 },\n    location: { countryCode: \"FR\" },\n    perPage: 25\n  },\n  { maxResults: 100 }\n)) {\n  console.log(company.companyName, company.websiteUrl);\n}\n",[547,659,657],{"__ignoreMap":612},[605,661,664],{"className":662,"code":663,"filename":395,"language":628,"meta":612},[626],"import os\n\nfrom reversecontact import ReverseContact\n\nwith ReverseContact(api_key=os.environ[\"RC_API_KEY\"]) as client:\n    for company in client.search.iter_organizations(\n        industry=\"Software Development\",\n        employee_count_range={\"min\": 51, \"max\": 200},\n        founded_year={\"min\": 2015},\n        location={\"countryCode\": \"FR\"},\n        per_page=25,\n        max_results=100,\n    ):\n        if company is not None:\n            print(company.company_name, company.website_url)\n",[547,665,663],{"__ignoreMap":612},[605,667,670],{"className":668,"code":669,"filename":259,"language":611,"meta":612},[608],"remaining=100\ncursor=\"\"\nwhile [ \"$remaining\" -gt 0 ]; do\n  size=$((remaining \u003C 25 ? remaining : 25))\n  if [ -n \"$cursor\" ]; then\n    result=$(rc search organizations --industry \"Software Development\" --size 51-200 --founded-year 2015- --country-code FR --limit \"$size\" --cursor \"$cursor\" --json) || break\n  else\n    result=$(rc search organizations --industry \"Software Development\" --size 51-200 --founded-year 2015- --country-code FR --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",[547,671,669],{"__ignoreMap":612},[581,673,675],{"id":674},"search-from-a-description","Search from a description",[465,677,678,679,682,683,595,686,689],{},"You can use Agentic Company Search with a ",[547,680,681],{},"prompt",". Inspect ",[547,684,685],{},"data.interpretation.filters",[547,687,688],{},"warnings"," before continuing. This example requests one page of up to 25 companies for at most 26 credits. Describe every criterion in the prompt instead of adding explicit filter fields.",[601,691,692,698,704],{"title":603},[605,693,696],{"className":694,"code":695,"filename":610,"language":611,"meta":612},[608],"curl --fail-with-body -sS -X POST https:\u002F\u002Fapi.reversecontact.com\u002Fv2\u002Fsearch\u002Forganizations\u002Fprompt \\\n  -H \"Authorization: Bearer $RC_API_KEY\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\"prompt\": \"Software companies headquartered in France with 51 to 200 employees, founded since 2015\", \"perPage\": 25}'\n",[547,697,695],{"__ignoreMap":612},[605,699,702],{"className":700,"code":701,"filename":568,"language":620,"meta":612},[618],"import ReverseContact from \"@reverse-contact\u002Fsdk\";\n\nconst client = new ReverseContact({ apiKey: process.env.RC_API_KEY });\n\nconst page = await client.search.organizationsByPrompt({\n  prompt: \"Software companies headquartered in France with 51 to 200 employees, founded since 2015\",\n  perPage: 25\n});\nconsole.log(\"Filters:\", page.interpretation?.filters);\nconsole.log(\"Warnings:\", page.interpretation?.warnings);\nconsole.log(page.data, \"credits:\", page.quotas?.creditsConsumed);\n",[547,703,701],{"__ignoreMap":612},[605,705,708],{"className":706,"code":707,"filename":395,"language":628,"meta":612},[626],"import os\n\nfrom reversecontact import ReverseContact\n\nwith ReverseContact(api_key=os.environ[\"RC_API_KEY\"]) as client:\n    page = client.search.organizations_by_prompt(\n        prompt=\"Software companies headquartered in France with 51 to 200 employees, founded since 2015\",\n        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",[547,709,707],{"__ignoreMap":612},[469,711,713],{"id":712},"what-it-costs","What it costs",[465,715,716,717,721],{},"Company search costs ",[718,719,720],"strong",{},"1 credit per company delivered",". An empty page costs nothing, and Company search count is free. The full company profile is included, so you do not need a second fetch to retrieve its fields.",[465,723,724,725,728,729,731,732,735,736,739],{},"Agentic Company Search costs ",[718,726,727],{},"1 credit per page for the search, plus 1 credit per company delivered",". The 1-credit page fee also applies to empty pages. Before a request runs, your available balance must cover ",[547,730,598],{}," credits for filtered search, or ",[547,733,734],{},"perPage + 1"," for a prompt search. Otherwise, the API returns ",[547,737,738],{},"402 INSUFFICIENT_CREDITS"," without charging.",[741,742,744],"docs-alert",{"type":743},"note",[465,745,746,747,750,751,754,755,758],{},"Count a query for free, then retrieve 100 companies over four full pages of 25: filtered search costs ",[718,748,749],{},"100 credits",". The same four full pages through Agentic Company Search cost 100 + 4 = ",[718,752,753],{},"104 credits",". An additional empty prompt page adds ",[718,756,757],{},"1 credit",".",[465,760,761,762,765,766,769,770,773],{},"SDK iterators use ",[547,763,764],{},"maxResults"," \u002F ",[547,767,768],{},"max_results"," to cap profiles, but this limit does not cover the extra page fees of Agentic Company Search. Limit prompt requests page by page, or configure an ",[507,771,772],{"href":245},"API key credit limit"," to cap total spending.",[469,775,777],{"id":776},"good-to-know","Good to know",[465,779,780,781,784],{},"Company search and Company search count require at least one filter. The ",[547,782,783],{},"maxDataAgeDate"," filter cannot be used alone. Filters combine with AND.",[465,786,787,788,791,792,795,796,798,799,802,803,795,806,808,809,812,813,816,817,812,820,823],{},"Use ",[547,789,790],{},"industry"," values such as ",[547,793,794],{},"Software Development"," from ",[507,797,328],{"href":327},", and full ",[547,800,801],{},"location.area"," ids such as ",[547,804,805],{},"MC:DACH",[507,807,324],{"href":323},". Put country codes in ",[547,810,811],{},"location.countryCode"," (",[547,814,815],{},"FR",") and country names in ",[547,818,819],{},"location.country",[547,821,822],{},"France",").",[465,825,826,827,830,831,834,835,838,839,843],{},"The ",[547,828,829],{},"employeeCountRange"," filter matches whole size brackets. For example, ",[547,832,833],{},"{ \"min\": 51, \"max\": 200 }"," matches the 51 to 200 bracket. A range that contains no complete bracket returns no companies. Unknown fields and invalid closed-list values return ",[547,836,837],{},"422"," and cost 0 credits. The ",[507,840,842],{"href":841},"\u002Fendpoints\u002Fsearch-companies#request-body","Company search request reference"," lists the filters and their accepted values.",[465,845,846,847,849,850,852,853,856,857,860],{},"Request 1 to 100 companies per page, 25 by default. Keep filters unchanged and pass ",[547,848,644],{}," back as ",[547,851,594],{},". Stop only when the cursor is ",[547,854,855],{},"null"," or your budget is spent. A short or empty page can still have a next cursor, and there is no ",[547,858,859],{},"page"," parameter.",[465,862,863,864,866],{},"For prompt search, resend the same prompt. After the first paid prompt page, send ",[547,865,685],{}," to Company search count to get a free total.",[465,868,869,870,872,873,876],{},"Search uses cached profiles. See ",[507,871,458],{"href":457}," when you need current company data, and check the ",[507,874,875],{"href":314},"rate limits"," when paging at scale. Search count calls still count toward those request limits.",[465,878,879,880,758],{},"The examples print profiles for your application to store. To save companies in a persistent Reverse Contact List, use ",[507,881,291],{"href":290},[469,883,885],{"id":884},"faq","FAQ",[581,887,889],{"id":888},"how-do-i-build-a-company-list-by-industry-and-employee-count","How do I build a company list by industry and employee count?",[465,891,892,893,595,895,897,898,901],{},"Send ",[547,894,790],{},[547,896,829],{}," to Company search count to count matches for free. Use the same filters with ",[547,899,900],{},"POST \u002Fv2\u002Fsearch\u002Forganizations"," to retrieve full company profiles at 1 credit per company delivered.",[581,903,905],{"id":904},"why-does-company-search-return-no-results-for-my-employee-range","Why does company search return no results for my employee range?",[465,907,826,908,910],{},[547,909,829],{}," filter must contain whole size brackets. A range such as 51 to 200 matches that bracket. A range that contains no complete bracket returns no companies.",[581,912,914],{"id":913},"how-do-i-cap-company-search-credits","How do I cap company search credits?",[465,916,917,918,765,920,922],{},"For filtered Company search, use an SDK iterator with ",[547,919,764],{},[547,921,768],{}," or request no more companies than the remaining budget. Agentic Company Search adds 1 credit per page, so budget those fees separately or use an API key credit limit.",[581,924,926],{"id":925},"can-i-search-for-companies-with-a-plain-language-prompt","Can I search for companies with a plain-language prompt?",[465,928,929,930,932],{},"Yes. Agentic Company Search accepts a ",[547,931,681],{}," and returns the interpreted filters and warnings. Each page costs 1 credit plus 1 per company delivered. You cannot add explicit filter fields alongside the prompt.",[581,934,936],{"id":935},"how-do-i-get-the-next-page-of-company-search-results","How do I get the next page of company search results?",[465,938,892,939,941,942,944,945,947],{},[547,940,644],{}," as ",[547,943,594],{},". Keep the same filters for Company search, or the same prompt for Agentic Company Search. Continue until the cursor is ",[547,946,855],{}," or your budget is spent. An empty page alone does not mean the search has ended.",{"title":612,"searchDepth":949,"depth":949,"links":950},3,[951,952,957,958,959],{"id":471,"depth":298,"text":472},{"id":553,"depth":298,"text":554,"children":953},[954,955,956],{"id":583,"depth":949,"text":584},{"id":633,"depth":949,"text":634},{"id":674,"depth":949,"text":675},{"id":712,"depth":298,"text":713},{"id":776,"depth":298,"text":777},{"id":884,"depth":298,"text":885,"children":960},[961,962,963,964,965],{"id":888,"depth":949,"text":889},{"id":904,"depth":949,"text":905},{"id":913,"depth":949,"text":914},{"id":925,"depth":949,"text":926},{"id":935,"depth":949,"text":936},"Build a company list with the search API. Count matches for free, filter by industry, headcount and location, use prompts, and cap credit spending.","md","2026-11-04",{},true,"\u002Fdocs\u002Fguides\u002Flists,\u002Fdocs\u002Fguides\u002Fcredits,\u002Fdocs\u002Fguides\u002Fapi-key-management,\u002Fdocs\u002Fguides\u002Frate-limits",{"title":437,"description":966},"use-cases\u002Fbuild-a-list-of-companies","FYfCeW5kkKogmnJ7nGTwH5rvMIWt7902DpBEKoPnqnI",1793830204038]