Search Apollo's 275M+ contact database by title, seniority, location, and keywords via pay-per-call MPP.
What it does
This endpoint exposes Apollo.io's People Search API through the Locus MPP (Micropayment Protocol), allowing agents to search a database of over 275 million contacts without managing API keys or subscriptions. You POST a query with filters such as job titles, seniority levels, person locations, company domains, and free-text keywords, and receive paginated results (up to 100 per page, max 500 pages).
The endpoint is part of a broader Apollo suite hosted on the Locus MPP gateway that also includes people enrichment, bulk people enrichment, organization enrichment, bulk organization enrichment, organization search, job postings lookup, and news article search. Each call is settled individually via the Tempo L2 payment method using pathUSD (6 decimals). The People Search endpoint charges 5,000 base units per call, which equals $0.005 per request.
Filters available for people search include: q_keywords (free-text), person_titles, person_locations, q_organization_domains, organization_ids, and person_seniorities (with values like founder, c_suite, partner, vp, head, director, manager, senior, entry, intern). Pagination is controlled via per_page (default 25, max 100) and page (max 500). The endpoint accepts POST requests with a JSON body.
Capabilities
Use cases
- —Finding decision-makers at target companies by title and seniority
- —Building prospect lists filtered by location and industry domain
- —Searching for contacts matching specific keywords for outreach campaigns
- —Paginating through large result sets of people matching sales criteria
- —Agent-driven lead generation without API key management
Fit
Best for
- —AI agents that need on-demand B2B contact search without subscriptions
- —Sales automation workflows requiring pay-per-query contact lookups
- —Programmatic lead list building filtered by seniority, title, and geography
Not for
- —Bulk data exports exceeding 50,000 results (500 pages × 100 per page)
- —Use cases requiring real-time webhook or streaming contact updates
- —Scenarios needing enriched contact details (use the people-enrichment endpoint instead)
Quick start
curl -X POST https://apollo.mpp.paywithlocus.com/apollo/people-search \
-H "Content-Type: application/json" \
-d '{
"person_titles": "CTO",
"person_locations": "San Francisco",
"person_seniorities": "c_suite",
"per_page": 10,
"page": 1
}'Example
Request
{
"page": 1,
"per_page": 25,
"q_keywords": "machine learning",
"person_titles": "VP Engineering",
"person_locations": "New York",
"person_seniorities": "vp",
"q_organization_domains": "example.com"
}Endpoint
Quality
The OpenAPI spec provides a clear request schema with documented filters and pricing, but the probe did not capture a live 402 challenge on HEAD/GET (the endpoint requires POST). No response schema or example response is available, and crawled pages returned only 404 JSON errors. Pricing is documented in the spec's x-payment-info.
Warnings
- —Probe returned 404 on HEAD and GET; endpoint likely requires POST method only — not necessarily down but liveness unconfirmed via probe
- —No response schema documented — output structure must be inferred from Apollo.io's own API docs
- —No example response available from probe or crawl
- —Several request fields typed as 'string' in the schema appear to actually accept arrays (e.g., person_titles, organization_ids) — check Apollo API docs for correct format
Citations
- —Apollo database contains 275M+ contactshttps://apollo.mpp.paywithlocus.com
- —People Search endpoint charges 5000 base units (pathUSD) per call, i.e. $0.005https://apollo.mpp.paywithlocus.com
- —Seniority filter values include founder, c_suite, partner, vp, head, director, manager, senior, entry, internhttps://apollo.mpp.paywithlocus.com
- —Pagination supports max 100 results per page and up to page 500https://apollo.mpp.paywithlocus.com
- —Payment settles via Tempo L2 methodhttps://apollo.mpp.paywithlocus.com
- —Additional docs available at https://beta.paywithlocus.com/mpp/apollo.mdhttps://apollo.mpp.paywithlocus.com