Quick Guide u2014 Company: Look up or Find Similar Companies. Person: Find or Enrich a Lead. Autocomplete: Cheap Spelling Helper Before Search/Enrich (0.1 Credits/run). Reveal: Get Email/phone After Search or Enrich. Other: Check Credit Balance.

automation CRM

v1.0.8

Last updated Jul 2, 2026

n8n community node for Ocean.io — lookalike company & people discovery, enrichment, reveal, and autocomplete

878 Weekly Downloads

914 Monthly Downloads

View on NPM GitHub Repository

Included Nodes

Quick Guide u2014 Company: Look up or Find Similar Companies. Person: Find or Enrich a Lead. Autocomplete: Cheap Spelling Helper Before Search/Enrich (0.1 Credits/run). Reveal: Get Email/phone After Search or Enrich. Other: Check Credit Balance.

Description

Lookalike company & people discovery for n8n
Search, enrich, reveal, and normalize prospect data — directly inside your workflows.

—

What is this?

n8n-nodes-ocean is a community node that connects n8n to the Ocean.io API.

Ocean.io specializes in lookalike discovery — finding companies and people similar to your best customers — plus firmographic enrichment and contact reveal. This node wraps those capabilities in a single, workflow-friendly Ocean.io node with clear helper text, dropdown filters, and patterns built for real automation (CRM sync, lead enrichment, outbound prospecting).

> Install: n8n-nodes-ocean on npm · Node name in n8n: Ocean.io

—

Why use it?

Built for backend automation — not just API coverage. Every resource includes in-node guidance, sensible defaults, and execute-time validation so workflows fail clearly instead of silently.

—

Operations overview

14 operations across 5 resources:

—

Installation

n8n (recommended)

1. Open Settings → Community Nodes
2. Click Install
3. Enter n8n-nodes-ocean
4. Confirm and restart n8n

Official n8n community node install guide →

Self-hosted / manual

npm install n8n-nodes-ocean

Set N8NCUSTOMEXTENSIONS to include the package path, then restart n8n.

—

Authentication

1. Get an API key from Ocean.io → Settings → API Keys
2. In n8n, add credentials of type Ocean.io API
3. Paste your key and click Test (calls GET /v2/credits/balance)

—

Resources & operations

Company

#### Search Companies
Find companies similar to your seed domains — Ocean’s core lookalike engine.

Lookalike Domains — comma-separated domains (e.g. topoffunnel.com, stripe.com); URLs normalized automatically
Countries & Industries — searchable dropdowns loaded from Ocean’s data fields
Employee count — min/max filters
Companies Filters JSON — optional advanced filters

#### Enrich Company
Look up one company by website domain (e.g. stripe.com). Accepts full URLs — https and www are stripped automatically.

—

Person

#### Search People
Build lists of prospects with filters that map to Ocean’s v3 people search.

Job Titles, Company Domains, Countries
Lookalike People — LinkedIn handles for similarity search
People Filters JSON / Companies Filters JSON — advanced filters

#### Enrich Person
Look up one person. Provide at least one identifier:

LinkedIn URL
Email
Full name
First name + last name

Tip: Name + work email (e.g. Brandon Charleson + brandon@company.com) works well for lead enrichment.

—

Reveal

Discover verified work emails or phone numbers for people you already found via Search or Enrich.

> Important: Reveal is asynchronous. The node returns { "status": "in progress" } immediately. Ocean delivers results to your Webhook URL when ready.

Requirements:

Ocean person IDs from Search People or Enrich Person (id field in output)
Webhook URL — for in-workflow delivery, use {{ $execution.resumeUrl }} and add a Wait node (mode: On Webhook Call) after Reveal

Account note: Reveal requires email/phone verification to be enabled on your Ocean.io organization. If disabled, the API returns 403.

—

Autocomplete

Cheap, synchronous lookup to fix spelling before Search or Enrich.

Cost: 0.1 credits per call (flat, not per suggestion). Does not return full profiles or contact info.

—

Other

—

Example workflows

Lookalike company discovery

Manual Trigger → Ocean.io (Company → Search Companies)
  Lookalike Domains: topoffunnel.com
  Limit: 25
→ Spreadsheet / CRM / Slack

CRM lead enrichment

HubSpot Trigger → Ocean.io (Person → Enrich Person)
  Person Name: {{ $json.firstname }} {{ $json.lastname }}
  Email: {{ $json.email }}
→ HubSpot (update contact)

Normalize then enrich

Google Sheets → Ocean.io (Autocomplete → Companies)
  Query: {{ $json.companyName }}
→ Set (pick best domain) → Ocean.io (Company → Enrich Company)

Search → reveal email (async)

Ocean.io (Person → Search People) → Ocean.io (Reveal → Reveal Emails)
  Ocean Person IDs: {{ $json.id }}
  Webhook URL: {{ $execution.resumeUrl }}
→ Wait (On Webhook Call) → CRM / sequencer

—

Credit costs

Rates below reflect Ocean.io’s v3 unified credit model. Check your plan if you’re on enterprise/legacy pricing.

Use Other → Get Credit Balance before large batch runs.

—

Developer setup

git clone https://github.com/bcharleson/n8n-nodes-ocean.git
cd n8n-nodes-ocean
npm install
npm run dev:full          # local n8n at http://localhost:5678
npm run verify:audit      # build + package checks + n8n-node lint
OCEANAPITOKEN=xxx npm run verify:e2e   # live API smoke test (optional)

—

Error handling

The node surfaces clear errors for common Ocean API responses:

Insufficient credits (402)
Invalid or missing API key (403)
Validation errors (422)
Reveal not enabled on account (403)

Enable Continue on Fail on the node to capture errors per item instead of stopping the workflow.

Ocean.io rate limit: 300 requests/minute.

—

Links

—

License

MIT

Support

This node: Open a GitHub issue
Ocean.io API: Ocean.io support