Lookup multiple companies by domain

Key features:

• Batch lookup up to 1000 company domains
• Domain redirections are handled automatically

Returns enriched company data for each domain. Companies not found will have company: null in the result.

Example use case: I have 200 domains from a trade show badge scan. I want to enrich all of them in one call.

Quickstart#

curl -X POST "https://api.ocean.io/v2/lookup/companies" \
  -H "X-Api-Token: YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "domains": ["stripe.com", "twilio.com", "notindatabase.io"],
    "fields": ["name", "companySize", "primaryCountry", "technologies"]
  }'

import requests

response = requests.post(
    'https://api.ocean.io/v2/lookup/companies',
    headers={'X-Api-Token': 'YOUR_API_TOKEN'},
    json={
        'domains': ['stripe.com', 'twilio.com', 'notindatabase.io'],
        'fields': ['name', 'companySize', 'primaryCountry', 'technologies'],
    },
)
data = response.json()

const response = await fetch('https://api.ocean.io/v2/lookup/companies', {
  method: 'POST',
  headers: { 'X-Api-Token': 'YOUR_API_TOKEN', 'Content-Type': 'application/json' },
  body: JSON.stringify({
    domains: ['stripe.com', 'twilio.com', 'notindatabase.io'],
    fields: ['name', 'companySize', 'primaryCountry', 'technologies'],
  }),
});
const data = await response.json();

Example response:

{
  "companies": [
    { "domain": "stripe.com", "company": { "name": "Stripe", "companySize": "1001-5000" } },
    { "domain": "notindatabase.io", "company": null }
  ],
  "totalRequested": 3,
  "totalFound": 2,
  "redirectMap": { "stripe.co.uk": "stripe.com" }
}

Domains not in the database return company: null — not an error. The redirectMap shows any canonical domain redirects Ocean.io detected.

Lookup vs. Enrich (Batch)#