prospeo-search-apilisted
Install: claude install-skill automatewithuday/gtm-prospecting-system
# Prospeo Search Person API
This skill documents how to use the Prospeo Search Person API for finding leads with filters.
## When to Use
Use this skill when:
- Searching for people/leads by job title, industry, location, company size, etc.
- Building lead lists from Prospeo's database
- Running large US-wide searches that need state-by-state crawling
## API Overview
**Endpoint:** `POST https://api.prospeo.io/search-person`
**Authentication:** `X-KEY` header with API key
**Rate Limits:**
- 2-2.5 requests/second (120-150 req/min)
- Token bucket implementation recommended
**Result Limits:**
- 25 results per page
- 1000 pages max = 25,000 results per search
- 1 credit per search request that returns at least 1 result
## Request Format
```typescript
POST /search-person
Headers: {
'Content-Type': 'application/json',
'X-KEY': process.env.PROSPEO_API_KEY
}
Body: {
page: number, // 1-1000
filters: ProspeoSearchFilters
}
```
## Filter Types
```typescript
interface ProspeoSearchFilters {
// Location (use "State, United States #US" format)
person_location_search?: {
include?: string[]; // e.g., ["California, United States #US"]
exclude?: string[];
};
// Job titles
person_job_title?: {
include?: string[]; // e.g., ["CEO", "Founder"]
exclude?: string[];
match_only_exact_job_titles?: boolean;
};
// Company size
company_headcount_custom?: {
min?: number; // e.g., 11
max?: number; // e.g., 500
};
// Industry
c