skills.rest
meloShaya
meloShayaCOMMUNITY
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 May 28, 2025
Search Tags:#rate limiting#lead generation#prospecting#email verification#search api#prospeo#b2b leads
One-click install
npx skills add https://github.com/meloShaya/insteltech --skill prospeo-search-api-meloshaya
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: prospeo-search-api
Source: https://github.com/meloShaya/insteltech/tree/main/crm/library/skills/prospeo-search-api
Command: npx skills add https://github.com/meloShaya/insteltech --skill prospeo-search-api-meloshaya

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Searching Prospeo's lead database at scale is error-prone: the API caps results at 25,000 per search, enforces strict rate limits, and uses non-obvious filter formats. This Skill documents the correct request structure, filter types, and crawling patterns so lead searches return complete, deduplicated results. ## Core Features & Use Cases - Complete Filter Reference: Covers location, job title, company headcount, industry, technology stack, funding stage, and verified-email filters with exact request formats. - State-by-State Crawling: Splits US-wide searches across all 50 states to bypass the 25K result ceiling per query. - Rate Limiting & Retry Patterns: Provides token bucket throttling at 2 requests/second and exponential backoff for 429 errors. - Use Case: Build a list of marketing VPs at US software companies with 50-200 employees that raised Series A funding in the last 180 days, restricted to verified emails. ## Quick Start Ask the AI to search Prospeo for tech executives at US software companies with verified emails using the Prospeo Search Person API.

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, industry, headcount, technology, and funding criteria.

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

Split the search into state-by-state queries, since Prospeo caps each search at 1000 pages of 25 results. Replace the country-level location filter with each US state formatted as "California, United States #US" and merge the results.

What is the Prospeo API rate limit?▼

The Prospeo Search Person API allows roughly 2 to 2.5 requests per second, or 120 to 150 requests per minute. A token bucket rate limiter is recommended, with exponential backoff retries when receiving HTTP 429 responses.

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

Set the person_contact_details filter with email set to ["VERIFIED"] in the request body. This restricts returned people to those whose email addresses Prospeo has verified, reducing bounce risk in outreach.

How do I find recently funded companies with Prospeo?▼

Use the company_funding filter with funding_date set to 90, 180, 270, or 365 days and stage set to values like "Seed" or "Series A". This targets companies that raised a round within the chosen recency window.

What location format does the Prospeo API expect?▼

Locations must use the format "State, United States #US", for example "Texas, United States #US", or "United States #US" for nationwide searches. 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
gooseworks-aigooseworks-ai
1.1k

event-prospecting-pipeline

Find event attendees and speakers, enrich with company data, and export outreach-ready lead lists.

Official
Advanced
orthogonal-shorthogonal-sh
12

verify-email

Validate email deliverability via Hunter or Tomba APIs.

Official
Intermediate
sachacoldiqsachacoldiq
242

clay-enrichment-9step

Orchestrate a 9-step B2B prospect enrichment workflow using Clay, Apollo, and Sales Navigator.

Community
Advanced