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

Ocean.io API docs

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 included

Plan 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

How to get an API key

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

Create a Ocean.io account. API access starts on the Growth (marketing page) plan.
Account Settings > API Tokens > Generate new token (MCP doc: only managers can create tokens)
Send it with every request: header: X-Api-Token: <token> (or ?apiToken= query param; never both, that returns 400).

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
API reference	app.ocean.io/docs
OpenAPI spec	api.ocean.io/openapi.json
llms.txt	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 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; 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
API mixes versions: search is /v3, enrich/lookup/reveal are /v2. Source: api.ocean.io/openapi.json
Sending the token both as header and query param returns 400. Source: 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 (FAQ)
Phones cost 10 credits each (50x a company search result). Source: 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; 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
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

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.

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

Apollo

Sourcing

Free planOfficial MCP

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

Apollo API review

BlitzAPI

Sourcing

From $99/moOfficial MCP

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

BlitzAPI API review

Before you build

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

Confirm the API is on your planAPI 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 codeAPI key. It is sent as: header: X-Api-Token: <token> (or ?apiToken= query param; never both, that returns 400).
Design around the rate limitSelf-serve: 60 requests per minute and 1,000 requests per day; Enterprise limits by contract.
Know the catch before you scaleSelf-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

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

See case studies

Read from ocean.io/pricing, app.ocean.io/docs and 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: 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; 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

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