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. |
- How it works
- Oceanio Search API
- Code examples in other languages
- Practical use cases
- Why Piloterr?
- FAQ
- Official SDKs
- Related scrapers
- Support
- Create a free Piloterr account and copy your API key from the dashboard.
- Send a
GET(orPOST) request tohttps://api.piloterr.com/v2/...with the headerx-api-key: YOUR_API_KEY. - 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) andPOST(JSON body with the same fields).
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
| Parameter | Type | Required | Description |
|---|---|---|---|
query |
string | ✅ | Domain or company name. |
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])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"}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": [
{},
{}
]
}
]
}| 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[] |
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 |
- 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.
- 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.
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.
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.
Credits per call: /v2/oceanio/search 1. See the Piloterr website for plans.
Each endpoint returns structured JSON: Oceanio Search — total, people, people.google.com[], results[], results[].url, results[].logo.
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.
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 |
- Company Database Scraper API
- Crunchbase Scraper API
- Europages Scraper API
- Fiverr Scraper API
- G2 Scraper API
- GitHub Scraper API
- All Piloterr scrapers on GitHub
- 💬 Join the Piloterr Discord to ask questions and share what you build.
- 📚 Browse the API reference (OpenAPI) and the Piloterr library.
- 🔑 Get your API key.
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.
