---
title: "Prospeo API: pricing, rate limits & MCP | ONEGTMLAB"
description: "Prospeo API: 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…"
canonical: https://www.onegtmlab.dev/tool-directory/sourcing/prospeo
---

# Prospeo API: pricing, rate limits & MCP | ONEGTMLAB

[](/)

[

Book a call

](/book)

![](/_astro/prospeo.deQVoOYK_Zg0PFP.webp)

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

[

See pricing

](#pricing)[

Prospeo API docs

](https://prospeo.io/api-docs)

At a glance

Category

Sourcing, Enrichment

Pricing model

Credits

Free tier

Free: $0, 100 credits per month, 28 search filters, 25 max row selection, MCP…

Entry price

$37/mo, billed annually Starter

Auth

API key

Official MCP

Yes

Best for

Building TAM and persona lists cheaply: 1 credit per page of 25 people or companies, with a free total\_count…

[prospeo.io ↗](https://prospeo.io)[Pricing page ↗](https://prospeo.io/pricing)

## What a call costs

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

Action

Cost

Per

Verified work email (enrich person)

1 credit

per email found

Mobile reveal (email included)

10 credits

per mobile found

Company enrich / company export

1 credit

per matched company

Search person or company

1 credit

per page of up to 25 results

Search suggestions / account information

0 credits

per call

Credit add-on

$10

per 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 APIPlan 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 includedPlan 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 includedPlan 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 includedPlan 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).

Limit

Free

Starter

Growth

Pro

Enrich

No access

5/s, 300/min, 2,000/day

5/s, 300/min, 5,000/day

30/s, 1,800/min, 500,000/day

Search

No access

1/s, 30/min, 1,000/day

2/s, 60/min, 4,000/day

5/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

What

Where

Documentation

[prospeo.io/api-docs](https://prospeo.io/api-docs)

API reference

[prospeo.io/api-docs](https://prospeo.io/api-docs)

Base URL

`https://api.prospeo.io`

MCP server

`https://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.

[

![](/_astro/ai-ark.BE60pifs_Z1HkjgQ.webp)

AI Ark

Sourcing

Free planOfficial MCP

Best for sizing an ICP for almost nothing: People Preview costs 1 credit per page of up to 100.

AI Ark API review →](/tool-directory/sourcing/ai-ark)[

![](/_astro/apollo.DNg6-7d3.svg)

Apollo

Sourcing

Free planOfficial MCP

Best for people search at 0 credits on paid plans to size and pull prospect lists.

Apollo API review →](/tool-directory/sourcing/apollo-io)[

![](/_astro/blitz-api.Bf9EP17n_qoQcx.webp)

BlitzAPI

Sourcing

From $99/moOfficial MCP

Best for high-volume list building at a flat monthly price.

BlitzAPI API review →](/tool-directory/sourcing/blitz-api)

## Before you build

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

-   **Confirm the API is on your plan**API 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 code**API key. It is sent as: header X-KEY (plus Content-Type: application/json).
    
-   **Design around the rate limit**Two independent buckets per team plan: Enrich (enrich-person/company and bulk) and Search (search-person/company).
    
-   **Know the catch before you scale**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
    

## 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.

[

Book a call

](/book)[

See case studies

](/case-studies)

Read from [prospeo.io/pricing](https://prospeo.io/pricing), [prospeo.io/api-docs](https://prospeo.io/api-docs) and [prospeo.io/api-docs/rate-limits](https://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:** `https://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

Filter endpoints

8 endpoints

Method

Path

What it does

Cost

POST

`/search-person`

Search 200M+ contacts with 30+ filters; returns person + current company, email/mobile obfuscated

1 credit per page that returns at least 1 result; same page repeated within 30 days is free

POST

`/search-company`

Search 30M+ companies with company filters

1 credit per page with at least 1 result; 30-day dedup free

POST

`/search-suggestions`

Resolve canonical filter values (locations, job titles, technologies, industries, NAICS, SIC, investors, awards, ICP fields, etc.)

free

POST

`/enrich-person`

Match one person and return full profile, current company, verified email and optionally mobile

1 credit per email found; 10 credits per mobile found (email included); 0 on NO\_MATCH; same record within 90 days free

POST

`/bulk-enrich-person`

Enrich up to 50 people in one request

Same per-record rules as /enrich-person

POST

`/enrich-company`

Enrich 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-company`

Enrich up to 50 companies in one request

1 credit per matched company; 90-day dedup

GET

`/account-information`

Plan, remaining/used credits, team size, next renewal date

free

[](/)

© 2026 ONEGTMLAB Private Limited. All rights reserved.

COMPANY

[

Why Us

](/#why-us)[

Process

](/#timeline)[

Blogs

](/blogs)[

About

](/about)[

Clients

](/clients)[

Free resources

](/free-resources)[

Newsletter

](/newsletter)

Services

[

GTM Engineering

](/ai-gtm-engineering)[

Account-Based Marketing

](/services/account-based-marketing)[

Paid Media

](/services/paid-media)[

Content Engineering

](/linkedin-personal-branding)[

RevOps

](/services/revops)[

SEO, AEO & GEO

](/services/seo-aeo-geo)[

All services

](/services)

![](/_astro/wordmark-3d.CMEfGdYr.svg)
