prospeo-full-export

Build your search in Prospeo's web UI, then describe the filters to the AI, which maps them to Search Person API calls and paginates through every page. Results are deduplicated and written to a CSV file in your current directory.

Prospeo caps any single search at 25,000 results (1,000 pages of 25). The export script detects US-wide searches over 20K results and automatically splits them into 50 state-level searches, then deduplicates across states by LinkedIn URL.

You need a Prospeo account on a plan with the Search Person API and an API key from Settings > API. Set it as the PROSPEO_API_KEY environment variable, and use Node.js 18+ with tsx to run the generated TypeScript script.

Each API request returning results costs 1 credit and returns 25 contacts, so a 25,000-result search costs about 1,000 credits. The Skill estimates total credits from the result count and asks for confirmation before running.

A 401 means your API key is invalid; verify it at prospeo.io/app/settings/api. A 429 means rate limiting at 2 requests per second; the script handles this automatically with exponential backoff, so run only one export at a time.

Locations must include a country code suffix, such as "United States #US" for country, "California, United States #US" for state, or "San Francisco, California, United States #US" for city. Incorrect formats cause low or zero results.