skills.rest
Pinkycherry
PinkycherryCOMMUNITY
Explore all skills by this author →
GitHub

prospeo-search-api

Search leads with the Prospeo Search Person API using filters, rate limiting, and state-by-state crawling.

Updated Aug 2, 2026
Search Tags:#api#rate limiting#lead generation#email verification#b2b prospecting#search filters#prospeo
One-click install
npx skills add https://github.com/Pinkycherry/newbusinessideas3 --skill prospeo-search-api-pinkycherry
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: prospeo-search-api
Source: https://github.com/Pinkycherry/newbusinessideas3/tree/main/.claude/skills/prospeo-search-api
Command: npx skills add https://github.com/Pinkycherry/newbusinessideas3 --skill prospeo-search-api-pinkycherry

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Searching large lead databases through the Prospeo Search Person API is error-prone: incorrect filter formats, hitting the 25,000-result cap on US-wide searches, and exceeding the 2 requests/second rate limit all cause failed or incomplete exports. This Skill documents the exact API contract and proven patterns to avoid those failures. ## Core Features & Use Cases - Complete filter reference: Documents every filter type including job title, location, headcount, industry, technology, funding stage, and verified-email requirements. - State-by-state crawling: Splits US-wide searches across all 50 states to bypass the 25K result-per-search limit. - Rate limiting and retry logic: Provides a token bucket rate limiter and exponential backoff handling for 429 responses. - Use Case: Build a list of marketing executives at US software companies with 50-200 employees that raised a Series A in the last 180 days, restricted to verified emails only. ## Quick Start Use the prospeo-search-api skill to build a Prospeo search for verified US-based CTOs at software companies with 11 to 500 employees, splitting results by state.

Frequently Asked Questions about prospeo-search-api

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search for leads with the Prospeo Search Person API?▼

Send a POST request to https://api.prospeo.io/search-person with your API key in the X-KEY header and a JSON body containing a page number and filters object. Filters support job title, location, company headcount, industry, technology, and funding criteria.

How to get more than 25,000 results from a Prospeo search?▼

Split the search by US state instead of searching the whole country at once. Replace the 'United States #US' location filter with each state formatted as 'State, United States #US', then merge the per-state results.

What is the Prospeo API rate limit?▼

The Prospeo Search Person API allows roughly 2 to 2.5 requests per second (120-150 per minute). Use a token bucket rate limiter and retry 429 responses with exponential backoff up to 60 seconds.

How do I filter Prospeo results to verified emails only?▼

Set the person_contact_details filter with email set to ["VERIFIED"]. This restricts results to contacts whose email addresses Prospeo has verified, reducing bounce rates in outreach campaigns.

How do I target companies that recently raised Series A funding?▼

Use the company_funding filter with stage set to ["Series A"] and funding_date set to 90, 180, 270, or 365 to limit results by days since the last round. Omit funding_date to match any company currently at that stage.

What location format does the Prospeo API accept?▼

Locations must use the format 'State, United States #US', for example 'California, United States #US'. Plain state or country names without the #US suffix will not match correctly.

Related Skills

Explore More Marketing & Sales Skills→
growthenginenowoslawskigrowthenginenowoslawski
601

prospeo-search-api

Find and filter leads using the Prospeo Search Person API.

Community
Advanced
LOGIN-TBLOGIN-TB
73

cold-email

Drafts and reviews B2B cold outreach emails for German and DACH legal compliance.

Community
Advanced
OpenLaborOpenLabor
4

Lead Sourcing

Identify and source qualified leads matching an ideal customer profile across industries.

Official
Intermediate
cengo33cengo33

prospecting

Build and qualify prospect lists using firmographic, technographic, and operational signals.

Community
Advanced