API docs

Quickstart
Authentication
Workflows
Best practices
Credits
Pagination
Rate limiting
Errors
Webhooks
MCP server
post Lookalike companies search
post Lookalike people search
post Preview - Lookalike companies
post Preview - Lookalike people
post Enrich companies
post Enrich company
post Enrich people
post Enrich person
post Lookup multiple companies by domain
post Lookup multiple people by LinkedIn handle or Ocean ID
post Reveal emails
post Reveal phones
post Autocomplete companies
post Autocomplete job titles
post Autocomplete keywords
post Autocomplete locations
post Autocomplete skills
get Get credit balance
get Get data fields
post Warmup companies

Ocean.io API Documentation

v2.0.0

Welcome to the Ocean.io API

Programmatic access to company and people data — search, enrich, reveal contact details, and build GTM pipelines at scale.

The Ocean.io API gives you programmatic access to company and people data — search by filters or lookalike domains, enrich records, reveal contact details, and export to your CRM or data pipeline.

20 endpoints across 6 groups. All requests require an API token from Settings → API tokens . Credits are consumed per result — see Credits for rates.

Workflows

Find prospects and reveal emails

Search for VP of Sales at lookalike companies, then reveal verified email addresses.

Search PeopleReveal Emails

Build a lookalike company segment

Use 3–5 seed customers to find hundreds of similar companies for your next outreach segment.

Search Companies

Enrich your CRM

Fill missing company size, industry, tech stack, and revenue across your account list.

WarmupEnrich Companies

Find decision-makers at target accounts

Get one VP+ contact per domain from a list of target account domains.

Search People

Use from Claude, Cursor, and other AI tools

The Ocean.io MCP server connects your AI assistant directly to the API — no code required.

→
Authentication Token setup and request methods
→
Credits Per-endpoint costs and balance
→
Webhooks Async results from batch and reveal endpoints
→
20 API endpoints Full parameter and response reference
→