Lookup

Lookup multiple companies by domain

Lookup and enrich multiple companies by domain (max 1000). This endpoint provides simple, per-result pricing.

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.

POST
/v2/lookup/companies

Query Parameters

apiToken?string | null

Header Parameters

x-api-token?string | null
domainsarray<string>

List of company domains to lookup (max 1000). Domain redirections are handled automatically.

Example["ocean.io","google.com","apple.com"]

Response Body

curl -X POST "https://api.ocean.io/v2/lookup/companies?apiToken=string" \
  -H "x-api-token: string" \
  -H "Content-Type: application/json" \
  -d '{
    "domains": [
      "ocean.io",
      "google.com",
      "apple.com"
    ]
  }'
{
  "companies": [
    {
      "domain": "dundermifflinpaper.com",
      "countries": [
        "us",
        "ca"
      ],
      "primaryCountry": "us",
      "companySize": "2-10",
      "industryCategories": [
        "Consumer Electronics",
        "Hardware"
      ],
      "industries": [
        "Audio",
        "Electronics"
      ],
      "linkedinIndustry": "Computer Software",
      "ecommerce": true,
      "keywords": [
        "paper",
        "premium copy paper"
      ],
      "employeeCountOcean": 57,
      "employeeCountLinkedin": 70,
      "revenue": "1-10M",
      "yearFounded": 1999,
      "description": "Dunder Mifflin Paper Company, Inc. is a fictional paper and office supplies wholesale company featured in the American television series The Office.",
      "emails": [
        "[email protected]",
        "[email protected]"
      ],
      "phones": [
        {
          "country": "us",
          "number": "+1 212 456 7890",
          "primary": true
        },
        {
          "country": "ca",
          "number": "+1 250 555 0199"
        }
      ],
      "logo": "https://cdn2.ocean.io/companies-logos-v1/domain.com/020539e284d9318e805301b672ad23047c30818a.png",
      "technologies": [
        "Accesso",
        "Adcash",
        "Atlassian Jira"
      ],
      "technologyCategories": [
        "Security",
        "Analytics",
        "Blogs"
      ],
      "mobileApps": [
        {
          "link": "https://www.my.app.com/",
          "name": "My awesome app"
        }
      ],
      "webTraffic": {
        "bounceRate": 0.5227,
        "pageViews": 2155984,
        "pagesPerVisit": 4.88,
        "visits": 10000
      },
      "medias": {
        "linkedin": {
          "handle": "dunder-mifflin",
          "name": "Dunder Mifflin Paper Company, Inc.",
          "url": "https://www.linkedin.com/company/dunder-mifflin"
        },
        "twitter": {
          "handle": "dunder-mifflin",
          "name": "Dunder Mifflin Paper Company, Inc.",
          "url": "https://twitter.com/dunder-mifflin"
        },
        "youtube": {
          "handle": "dunder-mifflin",
          "name": "Dunder Mifflin Paper Company, Inc.",
          "url": "https://youtube.com/channel/dunder-mifflin"
        },
        "facebook": {
          "handle": "dunder-mifflin",
          "name": "Dunder Mifflin Paper Company, Inc.",
          "url": "https://facebook.com/dunder-mifflin"
        },
        "xing": {
          "handle": "dunder-mifflin",
          "name": "Dunder Mifflin Paper Company, Inc.",
          "url": "https://xing.com/dunder-mifflin"
        },
        "tiktok": {
          "handle": "dunder-mifflin",
          "name": "Dunder Mifflin Paper Company, Inc.",
          "url": "https://tiktok.com/dunder-mifflin"
        },
        "instagram": {
          "handle": "dunder-mifflin",
          "name": "Dunder Mifflin Paper Company, Inc.",
          "url": "https://instagram.com/dunder-mifflin"
        }
      },
      "name": "Dunder Mifflin Paper Company",
      "legalName": "Dunder Mifflin Paper Company, Inc.",
      "locations": [
        {
          "primary": true,
          "latitude": 43.6471,
          "longitude": -79.3971,
          "country": "us",
          "locality": "Scranton",
          "region": "Lackawanna County",
          "postalCode": "18505",
          "streetAddress": "Scranton Business Park, 1725 Slough Ave Suit 200",
          "state": "pa",
          "regionCode": "PA"
        }
      ],
      "departmentSizes": [
        {
          "department": "Accounting and Finance",
          "size": 10
        },
        {
          "department": "Sales",
          "size": 15
        }
      ],
      "rootUrl": "https://dundermifflinpaper.com/",
      "faxes": [
        {
          "country": "us",
          "number": "5709045026",
          "primary": true
        }
      ],
      "impressum": {
        "company": "Dunder Mifflin Paper Company, Inc.",
        "address": "Scranton Business Park, 1725 Slough Ave Suit 200, Scranton, USA",
        "email": "[email protected]",
        "phone": "+35123456789",
        "fax": "+35123456790",
        "vat": "123456",
        "url": "https://dundermifflinpaper.com/impressum",
        "people": [
          {
            "name": "Michael Scott",
            "position": "Regional Manager"
          }
        ]
      },
      "fundingRound": {
        "cbUrl": "https://www.crunchbase.com/funding_round/orderyoyo-post-ipo-equity--5c26b0c0",
        "date": "2020-01-01",
        "moneyRaisedInUsd": 1000000,
        "type": "Seed"
      },
      "redirectedFrom": [
        "pol.dk",
        "pressen.nu"
      ],
      "headcountGrowth": {
        "sixMonths": 10,
        "sixMonthsPercentage": 0.2,
        "threeMonths": 5,
        "threeMonthsPercentage": 0.1,
        "twelveMonths": 15,
        "twelveMonthsPercentage": 0.3
      },
      "headcountGrowthPerDepartment": [
        {
          "department": "Accounting and Finance",
          "growth": {
            "sixMonths": 10,
            "sixMonthsPercentage": 0.2,
            "threeMonths": 5,
            "threeMonthsPercentage": 0.1,
            "twelveMonths": 15,
            "twelveMonthsPercentage": 0.3
          }
        }
      ]
    }
  ],
  "totalRequested": 3,
  "totalFound": 2,
  "redirectMap": {
    "given_local_domain.uk": "original.com",
    "ikea.nl": "ikea.com"
  }
}
{
  "detail": "Conflicting API tokens provided in query parameters and headers"
}
{
  "detail": "Insufficient credits"
}
{
  "detail": "API token should be provided in headers or query parameters"
}
Empty
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}