---
title: "Ocean.io API: pricing, rate limits & MCP | ONEGTMLAB"
description: "Ocean.io API: Lookalike-first B2B data API over an 85M+ company index: lookalike company and people search (v3), company/person enrichment (single and…"
canonical: https://www.onegtmlab.dev/tool-directory/sourcing/ocean-io
---

# Ocean.io API: pricing, rate limits & MCP | ONEGTMLAB

[](/)

[

Book a call

](/book)

![](/_astro/ocean-io.J2zU7SDe.svg)

API review

# Ocean.io API review

Lookalike-first B2B data API over an 85M+ company index: lookalike company and people search (v3), company/person enrichment (single and webhook batches of up to 10,000), domain lookups (up to 1,000), email/phone reveal, exclusion lists, segmentation and LinkedIn social data, on one credit pool, with an official MCP. Best for building account lists from 3-5 seed customers instead of industry codes.

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

[

See pricing

](#pricing)[

Ocean.io API docs

](https://app.ocean.io/docs)

At a glance

Category

Sourcing, Enrichment, Data platform

Pricing model

Credits

Free tier

14-day free trial, no card: 300 trial credits (valid 14 days) + 10 free credits…

Entry price

$250/mo, billed annually Growth (marketing page)

Auth

API key

Official MCP

Yes

Best for

Building account lists from 3-5 seed customers instead of industry codes

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

## What a call costs

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

Action

Cost

Per

Search companies / people

0.2

credits per result (measured 0.2 on our trial)

Enrich company / person (single or batch)

0.1

credits per result (measured 0.1 on our trial)

Lookup companies / people

0.05

credits per result

Autocomplete

0.1

credits per call

Reveal email

1

credit per email found (MCP doc: 3 on older plans)

Reveal phone

10

credits per phone found

Export via MCP (CSV, CRM, webhook)

0.2

credits per exported record (MCP doc); in-app pricing says 'Export company or person: Free'

## Pricing, plan by plan

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

Free tier 14-day free trial, no card: 300 trial credits (valid 14 days) + 10 free credits observed on our account; includes REST API and MCP; no waterfall enrichment, direct phones or free exports (marketing table)

### Growth (marketing page)

$250/mo

annual billing only

$3,000/year billed annually, 60,000 credits a year (about $0.05/credit), valid 12 months; waterfall enrichment (16+ sources), double email verification, direct phones, free exports

API included

### Yearly subscription (in-app checkout)

$690/mo

annual billing only

Credit slider, 'Minimum 48,000 credits'; default shown 180,000 credits at $0.046/credit = $690/month billed yearly at $8,280.

API includedPlan details

Price at the 48,000 minimum was not captured. Unlimited seats, credits valid 12 months

### Revenue Navigator

Custom quote

custom credit volume, flexible allocation, free API previews, built on your won/lost/open deals

API included

## Rate limits

Self-serve: 60 requests per minute and 1,000 requests per day; Enterprise limits by contract.

Limit

self-serve

Enterprise

Per Minute

60

contract

Per Day

1,000

contract

More on limitsLess

429 with Retry-After and X-RateLimit-Limit. Live (our trial, 2026-10-25): no rate-limit headers on 200 responses; remaining daily requests are in the balance body (dailyLimitRateLeft) and the Usage page ('24-hour API rate limit 2 / 1,000').

## How to get an API key

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

1.  Create a Ocean.io account. API access starts on the Growth (marketing page) plan.
2.  Account Settings > API Tokens > Generate new token (MCP doc: only managers can create tokens)
3.  Send it with every request: header: X-Api-Token: <token> (or ?apiToken= query param; never both, that returns 400).
4.  Make a first call: Company search by filters and lookalike seed domains. Keep the key in an environment variable, never in the command.
    
    ```
    curl -X POST "https://api.ocean.io/v3/search/companies" \
      -H "X-Api-Token: $OCEAN_IO_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{}'
    ```
    

## Where the docs live

What

Where

Documentation

[app.ocean.io/docs](https://app.ocean.io/docs)

API reference

[app.ocean.io/docs](https://app.ocean.io/docs)

OpenAPI spec

[api.ocean.io/openapi.json](https://api.ocean.io/openapi.json)

llms.txt

[ocean.io/llms.txt](https://www.ocean.io/llms.txt)

Base URL

`https://api.ocean.io`

MCP server

`https://api.ocean.io/mcp/`

## Strengths and limits

### Where it fits

-   Building account lists from 3-5 seed customers (lookalike search) instead of industry codes
-   Batch firmographic/tech-stack fill of a CRM account list by webhook
-   Cheap domain lookups at 0.05 credits per result (up to 1,000 domains per call)
-   Agent access via `https://api.ocean.io/mcp/` (OAuth or x-api-token)

### Where it falls short

-   Self-serve high-volume API use: 60 requests/minute and 1,000 requests/day by default
-   Monthly pay-as-you-go: self-serve is a yearly credit subscription only (marketing: Growth $3,000/year; in-app checkout: min 48,000 credits at $0.046/credit). Sources: [ocean.io/pricing](https://www.ocean.io/pricing); [app.ocean.io/pricing](https://app.ocean.io/pricing) (2026-10-25)
-   Phone-heavy enrichment on a budget (10 credits per phone found)

### Worth knowing

-   Self-serve API is capped at 1,000 requests per DAY (and 60/min); plan batch endpoints accordingly. Source: [app.ocean.io/docs/getting-started/rate-limiting](https://app.ocean.io/docs/getting-started/rate-limiting)
-   API mixes versions: search is /v3, enrich/lookup/reveal are /v2. Source: [api.ocean.io/openapi.json](https://api.ocean.io/openapi.json)
-   Sending the token both as header and query param returns 400. Source: [app.ocean.io/docs/getting-started/authentication](https://app.ocean.io/docs/getting-started/authentication)
-   A domain returning 201 repeatedly may be unreachable or have too little content to index; use warmup first. Source: [app.ocean.io/docs](https://app.ocean.io/docs) (FAQ)
-   Phones cost 10 credits each (50x a company search result). Source: [app.ocean.io/docs/getting-started/credits](https://app.ocean.io/docs/getting-started/credits)

5 moreShow fewer

-   Docs are a JS app with no docs llms.txt (app.ocean.io/llms.txt 404); www.ocean.io/llms.txt is a marketing overview. The OpenAPI at api.ocean.io/openapi.json is the clean source (checked 2026-10-25).
-   Marketing price (Growth $3,000/yr, 60,000 credits) differs from the in-app checkout (min 48,000 credits; $0.046/credit; $8,280/yr at the 180,000 default). Sources: [ocean.io/pricing](https://www.ocean.io/pricing); [app.ocean.io/pricing](https://app.ocean.io/pricing) (2026-10-25)
-   Enrich field names are strict enums: 'yearFounded' works, 'foundedYear' returns 422 (no charge). Source: live test 2026-10-25
-   Reveal emails/phones take max 500 personIds per call; warmup max 500 domains. Source: [api.ocean.io/openapi.json](https://api.ocean.io/openapi.json)
-   MCP lookups are free while REST lookups cost 0.05/result; MCP exports cost 0.2/record. Source: [app.ocean.io/docs/getting-started/mcp](https://app.ocean.io/docs/getting-started/mcp)

## Who should use it

Use Ocean.io for

Building account lists from 3-5 seed customers (lookalike search) instead of industry codes

Look elsewhere for

Self-serve high-volume API use: 60 requests/minute and 1,000 requests/day by default

## If Ocean.io 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 Ocean.io's own pages.

-   **Confirm the API is on your plan**API access starts on the Growth (marketing page) plan. Free tier: 14-day free trial, no card: 300 trial credits (valid 14 days) + 10 free credits observed on our account.
    
-   **Keep the key out of your code**API key. It is sent as: header: X-Api-Token: <token> (or ?apiToken= query param; never both, that returns 400).
    
-   **Design around the rate limit**Self-serve: 60 requests per minute and 1,000 requests per day; Enterprise limits by contract.
    
-   **Know the catch before you scale**Self-serve API is capped at 1,000 requests per DAY (and 60/min); plan batch endpoints accordingly. Source: [app.ocean.io/docs/getting-started/rate-limiting](https://app.ocean.io/docs/getting-started/rate-limiting)
    

## Want us to build it for you?

Tell us what you want Ocean.io 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 [ocean.io/pricing](https://www.ocean.io/pricing), [app.ocean.io/docs](https://app.ocean.io/docs) and [app.ocean.io/docs/getting-started/rate-limiting](https://app.ocean.io/docs/getting-started/rate-limiting). Verified 25 Oct 2026.

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

**Base URL:** `https://api.ocean.io`

**Bulk and async:** Batch enrich (companies up to 10,000 per request) by webhook; lookup up to 1,000 domains per call. Sources: [app.ocean.io/docs](https://app.ocean.io/docs); [api.ocean.io/openapi.json](https://api.ocean.io/openapi.json)

**Webhooks:** Async results only: batch enrich, reveal emails/phones and reveal flags deliver to your webhookUrl; must be public HTTPS, return 2xx, be idempotent; retries with exponential backoff. Source: [app.ocean.io/docs/getting-started/webhooks](https://app.ocean.io/docs/getting-started/webhooks)

Filter endpoints

10 endpoints

Method

Path

What it does

Cost

POST

`/v3/search/companies`

Company search by filters and lookalike seed domains

0.2 credits per result

POST

`/v3/search/people`

People search at target/lookalike companies, optional revealEmails

0.2 credits per result (+1 per email revealed)

POST

`/v3/search/companies/preview | /v3/search/people/preview`

Preview lookalike results (max 50). OpenAPI: 'Only available for enterprise API customers.'

Credits table: 'Not available on this plan'; Revenue Navigator lists 'Free API previews'

POST

`/v2/enrich/company | /v2/enrich/person`

Enrich one company or person

0.1 credits per result

POSTasync

`/v2/enrich/companies | /v2/enrich/people`

Batch enrichment delivered by webhook (companies and people: up to 10,000 per request)

0.1 credits per result

POST

`/v2/lookup/companies | /v2/lookup/people`

Lookup up to 1,000 company domains (redirects handled) or people by LinkedIn handle

0.05 credits per result

POSTasync

`/v2/reveal/emails | /v2/reveal/phones`

Reveal work emails / phones for people, async by webhook

1 credit per email found; 10 credits per phone found

POSTasync

`/v2/warmup/companies`

Check which domains Ocean has and trigger data gathering for missing ones

free

POST

`/v2/exclusion-lists`

Create an exclusion list (people or companies) to drop from searches; items added via POST /v2/exclusion-lists/items (up to 10,000 per request, list up to 300,000 or the plan limit)

Not stated

GET

`/v2/credits/balance`

Credit balance

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)
