API review

Prospeo API review

B2B people and company database with a filter-rich Search API (25 results per credit) and Enrich API for verified work email (1 credit) and mobile (10 credits), plus an official hosted MCP server. Best for building TAM and persona lists cheaply: 1 credit per page of 25 people or companies, with a free total_count on page 1.

Verified 25 Oct 2026 · 8 endpoints listed · Official MCP server

What a call costs

The actions you pay for, as Prospeo prices them in credits.

ActionCostPer
Verified work email (enrich person)1 creditper email found
Mobile reveal (email included)10 creditsper mobile found
Company enrich / company export1 creditper matched company
Search person or company1 creditper page of up to 25 results
Search suggestions / account information0 creditsper call
Credit add-on$10per 1,000 credits (starting tier)

Pricing, plan by plan

US dollars, as Prospeo's pricing page shows them on 25 Oct 2026. Monthly and annual billing are shown apart.

Free tier Free: $0, 100 credits per month, 28 search filters, 25 max row selection, MCP Server included, no Public API (plan table: Public API and API rate limits "No access")

Free

$0

Free

100 credits/month

No API
Plan details

No overage; buy credit add-on

Starter

$49/mo

billed monthly

$37/mo

billed annually ($441 a year)

2,000 credits/month or 24,000/year upfront, per user

API included
Plan details

No overage; credit add-ons from 1,000 credits for $10

Growth

$99/mo

billed monthly

$74/mo

billed annually ($888 a year)

5,000 credits/month or 60,000/year upfront, per user

API included
Plan details

No overage; credit add-ons from 1,000 credits for $10

Pro

$249/mo

billed monthly

$187/mo

billed annually ($2,241 a year)

15,000 credits/month or 180,000/year upfront, per user

API included
Plan details

No overage; credit add-ons; yearly credits add-on via sales

Rate limits

Two independent buckets per team plan: Enrich (enrich-person/company and bulk) and Search (search-person/company).

LimitFreeStarterGrowthPro
EnrichNo access5/s, 300/min, 2,000/day5/s, 300/min, 5,000/day30/s, 1,800/min, 500,000/day
SearchNo access1/s, 30/min, 1,000/day2/s, 60/min, 4,000/day5/s, 180/min, 250,000/day
More on limitsLess

429 when exceeded. Headers x-daily-request-left, x-minute-request-left, x-*-reset-seconds, x-*-rate-limit. /search-suggestions has its own 15 req/s on all plans. Free plan has no API access.

How to get an API key

Prospeo uses API key. The steps below follow Prospeo's own docs.

  1. Create a Prospeo account. API access starts on the Starter plan.
  2. Dashboard at app.prospeo.io/api; multiple keys allowed
  3. Send it with every request: header X-KEY (plus Content-Type: application/json).
  4. Make a first call: Search 200M+ contacts with 30+ filters; returns person + current company, email/mobile obfuscated. Keep the key in an environment variable, never in the command.
    curl -X POST "https://api.prospeo.io/search-person" \
      -H "X-KEY: $PROSPEO_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{}'

Where the docs live

WhatWhere
Documentationprospeo.io/api-docs
API referenceprospeo.io/api-docs
Base URLhttps://api.prospeo.io
MCP serverhttps://mcp.prospeo.io

Strengths and limits

Where it fits

  • Building TAM and persona lists cheaply: 1 credit per page of 25 people or companies, with a free total_count on page 1
  • Verified work emails on a pay-only-if-found basis (1 credit per email, 0 on no match)
  • Resolving canonical filter values for free via /search-suggestions
  • Lookalike, technographic, funding, hiring, intent, website-traffic and key-exec-event filters in a single search call
  • Agent workflows through the official hosted MCP at mcp.prospeo.io

Where it falls short

  • Pulling more than 25,000 results from one search (1,000 pages x 25 is a hard cap; split the TAM)
  • Cheap mobiles: a mobile reveal is 10 credits, among the priciest per mobile in our stack
  • Reselling or building a competing database from Output Data (terms section 1.2)
  • API use on the Free plan (pricing table shows Public API and API rate limits as 'No access' on Free)
  • Async/webhook pipelines: everything is synchronous, there are no webhooks

Worth knowing

  • Every error except rate limit is HTTP 400 with error:true and an error_code (NO_MATCH, INVALID_DATAPOINTS, INSUFFICIENT_CREDITS, PLAN_REQUIRED, INVALID_FILTERS); parse error before anything else
  • Filters above your plan return 400 PLAN_REQUIRED with filter_error naming the minimum plan (e.g. company_key_execs, company_website_traffic, company_website_search, company_google_discovery need Pro; education, past company/title, job change, ICP, awards, integrations, headcount by location need Growth)
  • Search hard caps: 25 results per page fixed, max page 1,000, so 25,000 results per search; max 20,000 filter values total and 500 include/exclude items per filter; a search made only of exclude filters is rejected
  • Dashboard-only filters (persona_ids, saved-list filters, duplicate-control filters) are rejected by the API with INVALID_FILTERS
  • company.company_oids works on /search-person only; on /search-company use company.names or company.websites (max 500)
7 moreShow fewer
  • Search results never contain revealed email or mobile; you pay again to reveal via enrich-person with person_id
  • Credits expire every billing period and do not roll over; all purchases final, no refunds (terms 2.2, 2.9)
  • Re-enriching with enrich_mobile a record you previously enriched without mobile is charged (free_enrichment:false)
  • The legacy /email-finder, /mobile-finder and /social-url-enrichment doc pages now redirect to the API intro: those endpoints are gone
  • API intro page says 'Free API access for all users' but the pricing table shows Public API and API rate limits as 'No access' on the Free plan
  • Terms: automation only via the documented public API (no UI scraping), no FCRA-type use, no resale or competing database; 90 days notice promised for breaking API changes
  • Empty results come back as HTTP 400 with error_code NO_MATCH (enrich) or NO_RESULTS (search), not 200/404; treat these as "no data, no charge".

Our take

Prospeo is the first step in our email-finding waterfall because it enriches in bulk and charges nothing on a miss. We size each market from the total_count that page 1 of a search returns before pulling, and we re-classify companies from their descriptions because the industry filter alone undercounts target accounts.

Who should use it

Use Prospeo for
Building TAM and persona lists cheaply: 1 credit per page of 25 people or companies, with a free total_count on page 1
Look elsewhere for
Pulling more than 25,000 results from one search (1,000 pages x 25 is a hard cap; split the TAM)

If Prospeo is not the answer

Other Sourcing tools in this directory, each with its own review.

Before you build

Four things to settle first, each read off Prospeo's own pages.

  • Confirm the API is on your planAPI access starts on the Starter plan. Free tier: Free: $0, 100 credits per month, 28 search filters, 25 max row selection, MCP Server included, no Public API (plan table: Public API and API….
  • Keep the key out of your codeAPI key. It is sent as: header X-KEY (plus Content-Type: application/json).
  • Design around the rate limitTwo independent buckets per team plan: Enrich (enrich-person/company and bulk) and Search (search-person/company).
  • Know the catch before you scaleEvery error except rate limit is HTTP 400 with error:true and an error_code (NO_MATCH, INVALID_DATAPOINTS, INSUFFICIENT_CREDITS, PLAN_REQUIRED, INVALID_FILTERS); parse error before anything else

Want us to build it for you?

Tell us what you want Prospeo to do in your stack. We will show you how we would wire it into your data, outbound or CRM, and what we would check first.

Read from prospeo.io/pricing, prospeo.io/api-docs and prospeo.io/api-docs/rate-limits. Verified 25 Oct 2026.

All 8 endpointsFor developers: method, path, what it does and what it costs.

Base URL: api.prospeo.io

Bulk and async: Synchronous bulk: /bulk-enrich-person and /bulk-enrich-company take up to 50 records per request (MCP bulk tools take 25)

Webhooks: No

8 endpoints
MethodPathWhat it doesCost
POST/search-personSearch 200M+ contacts with 30+ filters; returns person + current company, email/mobile obfuscated1 credit per page that returns at least 1 result; same page repeated within 30 days is free
POST/search-companySearch 30M+ companies with company filters1 credit per page with at least 1 result; 30-day dedup free
POST/search-suggestionsResolve canonical filter values (locations, job titles, technologies, industries, NAICS, SIC, investors, awards, ICP fields, etc.)free
POST/enrich-personMatch one person and return full profile, current company, verified email and optionally mobile1 credit per email found; 10 credits per mobile found (email included); 0 on NO_MATCH; same record within 90 days free
POST/bulk-enrich-personEnrich up to 50 people in one requestSame per-record rules as /enrich-person
POST/enrich-companyEnrich one company (firmographics, funding, tech, job postings, 50+ data points)1 credit per matched company; 0 on no match; free within 90 days
POST/bulk-enrich-companyEnrich up to 50 companies in one request1 credit per matched company; 90-day dedup
GET/account-informationPlan, remaining/used credits, team size, next renewal datefree