Skip to content

About

Ocean.io Scraper API by Piloterr: oceanio search data from Ocean.io as structured JSON. Python, TypeScript, cURL, PHP, C#, Go, Java, Ruby examples.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

6 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Ocean.io Scraper API by Piloterr – scrape Ocean.io data as JSON

Ocean.io Scraper API

Discord Get API key API docs License: MIT

The Piloterr Ocean.io Scraper API lets you extract public data from Ocean.io as clean, structured JSON — no proxies, headless browsers or HTML parsing to maintain. Endpoints available in production:

  • Oceanio Search API — Search Ocean.io by domain or company name to find the matching company, similar companies, contacts, and people.

Use it for lead generation, CRM enrichment, market mapping, investment research or job market analytics.

Endpoint Path Credits What you get
Oceanio Search API /v2/oceanio/search 1 Search Ocean.io by domain or company name to find the matching company, similar companies, contacts, and people.

Table of contents

How it works

  1. Create a free Piloterr account and copy your API key from the dashboard.
  2. Send a GET (or POST) request to https://api.piloterr.com/v2/... with the header x-api-key: YOUR_API_KEY.
  3. Receive structured JSON — Piloterr handles rendering, proxies, retries and parsing.
export PILOTERR_API_KEY="your-api-key"
pip install requests        # Python
# TypeScript: Node.js 18+ (native fetch), run with `npx tsx file.ts`

Every endpoint accepts both GET (query string) and POST (JSON body with the same fields).

Oceanio Search API

Search Ocean.io by domain or company name to find the matching company, similar companies, contacts, and people.

GET | POST https://api.piloterr.com/v2/oceanio/search · 1 credit per request · Full reference

Request parameters

Parameter Type Required Description
query string ✅ Domain or company name.

Python example

import json
import os
import requests

response = requests.get(
    "https://api.piloterr.com/v2/oceanio/search",
    headers={"x-api-key": os.environ["PILOTERR_API_KEY"]},
    params={
        "query": "google.com",
    },
    timeout=120,
)
response.raise_for_status()
data = response.json()

print(json.dumps(data, indent=2, ensure_ascii=False)[:2000])

TypeScript example

type OceanioSearch = {
  total?: number;
  people?: {
    "google.com"?: {
      id?: string;
      photo?: string;
      job_title?: string;
      last_name?: string;
      first_name?: string;
    }[];
  };
  results?: {
    url?: string;
    logo?: string;
    name?: string;
    score?: number;
    domain?: string;
    phones?: {
      number?: string;
      country?: string;
      primary?: boolean;
    }[];
    countries?: string[];
    locations?: {
      region?: string;
      country?: string;
      locality?: string;
    }[];
    industries?: string[];
    description?: string;
    company_size?: string;
    people_count?: number;
    year_founded?: number;
    website_status?: number;
  }[];
  companies?: {
    url?: string;
    logo?: string;
    name?: string;
    domain?: string;
    locations?: {
      region?: string;
      country?: string;
      locality?: string;
      postal_code?: string;
      street_address?: string;
    }[];
    industries?: string[];
    description?: string;
    company_size?: string;
    people_count?: number;
    year_founded?: number;
    website_status?: number;
    social_networks?: {
      url?: string;
      platform?: string;
    }[];
  }[];
};

const params = new URLSearchParams({
  "query": "google.com",
});

const response = await fetch(`https://api.piloterr.com/v2/oceanio/search?${params}`, {
  headers: { "x-api-key": process.env.PILOTERR_API_KEY! },
});
if (!response.ok) throw new Error(`Piloterr error ${response.status}: ${await response.text()}`);

const data = (await response.json()) as OceanioSearch;

console.log(JSON.stringify(data, null, 2).slice(0, 2000));
POST variant
POST https://api.piloterr.com/v2/oceanio/search
x-api-key: YOUR_API_KEY
Content-Type: application/json

{"query": "google.com"}

Output example

Example response from the API reference, abridged — real values depend on the page you scrape.

{
  "total": 17286,
  "people": {
    "google.com": [
      {
        "id": "aadeeshgarg",
        "photo": "https://images.aviato.co/entity-images/person?id=fTAjrx0423cxW2eaUfbHYo8xx9PcxoI",
        "job_title": "Software Engineer",
        "last_name": "example",
        "first_name": "example"
      }
    ]
  },
  "results": [
    {
      "url": "http://www.baidu.com/baidu.html?from=noscript",
      "logo": "https://cdn.ocean.io/logos/baidu.com/82b9ece05c9d92c810fabbc84a208c16a1cfad5d.png",
      "name": "Baidu",
      "score": 1,
      "domain": "baidu.com",
      "phones": [
        {}
      ],
      "countries": [
        "au",
        "cn"
      ],
      "locations": [
        {}
      ],
      "industries": [
        "Software Engineering"
      ],
      "description": "Most of Baidu's revenue comes from Baidu core, with the rest coming from video-streaming subsidiary iQiyi. The firm's main businesses inc…",
      "company_size": "I",
      "people_count": 18178,
      "year_founded": 2000,
      "website_status": 13
    },
    {
      "url": "https://yandex.com",
      "logo": "https://cdn.ocean.io/logos/yandex.com/23288ad569a8afc502172adfec84075aa76e3d91.png",
      "name": "Yandex",
      "score": 1,
      "domain": "yandex.com",
      "phones": [
        {}
      ],
      "locations": [
        {}
      ],
      "description": "Yandex International PJSC is a technology company that provides intelligent products and services managed by machine learning.",
      "company_size": "I",
      "people_count": 16802,
      "year_founded": 1997,
      "website_status": 1
    }
  ],
  "companies": [
    {
      "url": "https://www.google.com",
      "logo": "https://cdn.ocean.io/logos/google.com/a9f28f00b14b94419d51c0c9c5ed9ba53dfdf235.png",
      "name": "Google",
      "domain": "google.com",
      "locations": [
        {}
      ],
      "industries": [
        "Software Engineering"
      ],
      "description": "Google provides internet products and services, including online search, advertising, YouTube, Android and Google Cloud.",
      "company_size": "I",
      "people_count": 426322,
      "year_founded": 1996,
      "website_status": 1,
      "social_networks": [
        {},
        {}
      ]
    }
  ]
}

Response fields

Field Type Description
total integer
people object
people.google.com[] object[]
results[] object[]
results[].url string
results[].logo string
results[].name string
results[].score integer
results[].domain string
results[].phones[] object[]
results[].countries string[]
results[].locations[] object[]
results[].industries string[]
results[].description string
results[].company_size string
results[].people_count integer
results[].year_founded integer
results[].website_status integer
companies[] object[]
companies[].url string
companies[].logo string
companies[].name string
companies[].domain string
companies[].locations[] object[]
companies[].industries string[]

Code examples in other languages

Ready-to-run examples live in the examples/ folder. Each one reads your key from the PILOTERR_API_KEY environment variable.

Language Oceanio Search
cURL (Bash) search
PHP search
C# search
Go search
Java search
Ruby search
Node.js search

Practical use cases

  • Lead generation — Build target account lists from public company data.
  • CRM enrichment — Keep firmographics, websites and descriptions up to date.
  • Market mapping — Map competitors and segments across countries and industries.
  • Investment research — Screen companies, funding and signals for deal flow.
  • Job market analytics — Track hiring, roles and salaries where available.

Why Piloterr?

  • No infrastructure — no proxies, headless browsers or CAPTCHA solving to run yourself.
  • Structured JSON — stable, documented fields instead of brittle HTML selectors.
  • Pay per request — transparent credit cost per endpoint, failed requests are retried for you.
  • One API key, hundreds of sources — Ocean.io plus many other e-commerce, search and company data endpoints in the Piloterr library.
  • Any language — plain HTTPS + JSON, with examples for Python, TypeScript, cURL, PHP, C#, Go, Java, Ruby and Node.js.

FAQ

Is it legal to scrape Ocean.io?

Collecting publicly available data is generally allowed in many jurisdictions, but rules depend on your country, the data you collect and how you use it. Avoid personal data unless you have a lawful basis, respect the website's terms where they apply, and get legal advice for your specific use case. This is not legal advice.

Do I need proxies or a headless browser?

No. Piloterr handles rendering, proxy rotation and retries on its side. You only send an HTTPS request with your x-api-key header and receive JSON.

How much does a request cost?

Credits per call: /v2/oceanio/search 1. See the Piloterr website for plans.

What data does the Ocean.io API return?

Each endpoint returns structured JSON: Oceanio Search — total, people, people.google.com[], results[], results[].url, results[].logo.

Which languages are supported?

Any language that can make an HTTP request. This README shows Python and TypeScript; the examples/ folder contains cURL, PHP, C#, Go, Java, Ruby and Node.js.

Official SDKs

Use Piloterr from your own language with a typed client:

SDK Package Install
Node.js @piloterr/sdk npm install @piloterr/sdk
Python piloterr pip install piloterr
Go piloterr-go go get github.com/piloterr/piloterr-go
.NET Piloterr dotnet add package Piloterr
Ruby piloterr gem install piloterr
PHP piloterr/sdk composer require piloterr/sdk
Java piloterr-java build from source, see its README
CLI @piloterr/cli npm install -g @piloterr/cli
MCP server @piloterr/mcp npx -y @piloterr/mcp

Related scrapers

Support


Piloterr
Built by Piloterr — web scraping APIs for e-commerce, search, real estate and more, one API key.

Ocean.io is a trademark of its respective owner. This repository is not affiliated with or endorsed by Ocean.io. Examples are released under the MIT license.

About

Ocean.io Scraper API by Piloterr: oceanio search data from Ocean.io as structured JSON. Python, TypeScript, cURL, PHP, C#, Go, Java, Ruby examples.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors