Sign in

v2

latestOpenAPI 3.1.02026-07-2626156230.6 KB
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

apiTokenstring nullable

Headers

x-api-tokenstring nullable

Request body

domainsstring[] required

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

fieldsCompanyField[] nullable

Fields to return in the Company objects. Only requesting the fields that are needed will use less bandwidth and result in faster responses. If not specified, all fields are returned that can be seen in the example.

Example request

{
  "domains": [
    "ocean.io",
    "google.com",
    "apple.com"
  ],
  "fields": [
    "domain",
    "countries",
    "primaryCountry",
    "companySize",
    "industryCategories",
    "industries",
    "linkedinIndustry",
    "ecommerce",
    "keywords",
    "employeeCountOcean",
    "employeeCountLinkedin",
    "revenue",
    "yearFounded",
    "description",
    "emails",
    "phones",
    "logo",
    "technologies",
    "technologyCategories",
    "mobileApps",
    "webTraffic",
    "medias",
    "name",
    "legalName",
    "locations",
    "departmentSizes",
    "rootUrl",
    "faxes",
    "impressum",
    "fundingRound",
    "updatedAt"
  ]
}

Response

Successful Response

totalRequestedinteger required

Total number of domains requested

totalFoundinteger required

Total number of companies found

redirectMapobject nullable

Mapping of original domains passed in filters to their redirected domains.

creditsUsednumber required

Number of credits charged for this request.

Example response

{
  "companies": [
    {
      "domain": "dundermifflinpaper.com",
      "countries": [
        "us",
        "ca"
      ],
      "primaryCountry": "us",
      "industryCategories": [
        "Consumer Electronics",
        "Hardware"
      ],
      "industries": [
        "Audio",
        "Electronics"
      ],
      "linkedinIndustry": "Computer Software",
      "ecommerce": true,
      "keywords": [
        "paper",
        "premium copy paper"
      ],
      "employeeCountOcean": 57,
      "employeeCountLinkedin": 70,
      "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": [
        "email1@domain.com",
        "email2@domain.com"
      ],
      "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"
        }
      ],
      "medias": {
        "linkedin": {
          "specialties": [
            "artificial intelligence",
            "machine learning"
          ]
        },
        "twitter": {
          "specialties": [
            "artificial intelligence",
            "machine learning"
          ]
        },
        "youtube": {
          "specialties": [
            "artificial intelligence",
            "machine learning"
          ]
        },
        "facebook": {
          "specialties": [
            "artificial intelligence",
            "machine learning"
          ]
        },
        "xing": {
          "specialties": [
            "artificial intelligence",
            "machine learning"
          ]
        },
        "tiktok": {
          "specialties": [
            "artificial intelligence",
            "machine learning"
          ]
        },
        "instagram": {
          "specialties": [
            "artificial intelligence",
            "machine learning"
          ]
        }
      },
      "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@dundermifflin.com",
        "phone": "+35123456789",
        "fax": "+35123456790",
        "vat": "123456",
        "url": "https://dundermifflinpaper.com/impressum",
        "people": [
          {
            "name": "Michael Scott",
            "position": "Regional Manager"
          }
        ]
      },
      "redirectedFrom": [
        "pol.dk",
        "pressen.nu"
      ],
      "updatedAt": "2022-08-22T12:09:37Z",
      "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"
  },
  "creditsUsed": 1
}