prospeo-full-export

Build your search in Prospeo's web UI, then describe the filters so they map to Search Person API filter keys. A generated TypeScript script paginates through every page at 25 results per request and writes all contacts to a CSV file.

Prospeo caps any single search at 25,000 results (1,000 pages of 25). For larger US searches, split the query into 50 state-level searches by replacing the country location filter with each state, then deduplicate across states by LinkedIn URL.

The API accepts filters for job title, location, company industry, headcount range, technology, revenue, founding year, company name and domain, and contact details like verified email or phone. Locations require a specific format such as "California, United States #US".

Each API request that returns results costs 1 credit and returns 25 contacts. A 25,000-result export costs roughly 1,000 credits, and a 100,000-result state-split export costs around 4,000 credits.

A 429 error means you exceeded the rate limit of 2 requests per second. The export script handles this automatically with exponential backoff up to 60 seconds, but you should only run one export at a time.

You need Node.js 18 or later for native fetch support, tsx to run TypeScript files directly, and a Prospeo account with API credits. Set your key as the PROSPEO_API_KEY environment variable rather than hardcoding it.