polymerdao/polymer-pay-ocean

Ocean.io

Ocean.io provides B2B data for company and people search, enrichment, lookup, and discovery. Find lookalike companies, enrich contacts, and reveal decision makers through the Polymer Pay proxy.

Authentication

All requests route through the Polymer Pay proxy. Include your Polymer Pay API key in every request:

{
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  }
}

Base URL: https://pay.polymerlabs.org/proxy/https/x402.orth.sh/ocean-io

Common Operations

Search Companies

Search for companies using filters (industry, size, location, technologies, revenue).

Pricing: Dynamic

{
  "method": "POST",
  "url": "https://pay.polymerlabs.org/proxy/https/x402.orth.sh/ocean-io/v3/search/companies",
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  },
  "body": {
    "size": 50,
    "companiesFilters": {
      "companySizes": ["51-200", "201-500"],
      "industries": {
        "industries": ["Software", "SaaS"],
        "mode": "anyOf"
      },
      "primaryLocations": {
        "includeCountries": ["US", "GB"]
      }
    }
  }
}

Search People

Search for people using job title, seniority, department, and location filters.

Pricing: Dynamic

{
  "method": "POST",
  "url": "https://pay.polymerlabs.org/proxy/https/x402.orth.sh/ocean-io/v3/search/people",
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  },
  "body": {
    "size": 50,
    "peopleFilters": {
      "jobTitleKeywords": {
        "anyOf": ["CEO", "CTO", "VP"]
      },
      "seniorities": ["C-Level", "VP"],
      "departments": ["Engineering", "Sales"]
    }
  }
}

Enrich Company

Match and enrich a company with additional information.

Pricing: $0.01

{
  "method": "POST",
  "url": "https://pay.polymerlabs.org/proxy/https/x402.orth.sh/ocean-io/v2/enrich/company",
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  },
  "body": {
    "company": {
      "domain": "stripe.com",
      "name": "Stripe"
    },
    "fields": ["domain", "companySize", "revenue", "technologies"]
  }
}

Enrich Person

Match and enrich a person with job title, company, and contact info.

Pricing: $0.01

{
  "method": "POST",
  "url": "https://pay.polymerlabs.org/proxy/https/x402.orth.sh/ocean-io/v2/enrich/person",
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  },
  "body": {
    "person": {
      "linkedin": "john-doe",
      "name": "John Doe",
      "jobTitle": "Software Engineer"
    }
  }
}

Lookup Companies by Domain

Lookup and enrich multiple companies by domain (max 1000).

Pricing: Dynamic

{
  "method": "POST",
  "url": "https://pay.polymerlabs.org/proxy/https/x402.orth.sh/ocean-io/v2/lookup/companies",
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  },
  "body": {
    "domains": ["stripe.com", "google.com", "apple.com"],
    "fields": ["domain", "companySize", "industries", "revenue"]
  }
}

Get Data Fields

Returns all valid filter values for search endpoints.

Pricing: $0.00

{
  "method": "GET",
  "url": "https://pay.polymerlabs.org/proxy/https/x402.orth.sh/ocean-io/v2/data-fields",
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  }
}

When to Use

• Company search — Find companies by size, industry, location, technology stack
• People search — Find decision makers by job title, seniority, department
• Lookalike matching — Find companies similar to your best customers
• Account enrichment — Add firmographic data to company records
• Contact enrichment — Add job titles, emails, and social profiles to people
• Technographic data — Discover what technologies companies use
• B2B prospecting — Build targeted lead lists with advanced filters

Best Practices

• Use data fields endpoint — Call /v2/data-fields first to get valid filter values
• Specify fields — Use fields parameter to reduce bandwidth and improve speed
• Pagination — Use searchAfter cursor from previous response for next page
• Combine filters — Use multiple filters (size, industry, location) for precise targeting
• Warmup before search — Use /v2/warmup/companies to check domain availability
• Set result size — Use size parameter (1-10,000) to control result count
• For errors — See @skills/polymer-pay-api-errors/SKILL.md for complete error code reference and troubleshooting