Lookalike companies search

Request Body

application/jsonRequired

sizeMaximum number of results

Number of companies to return. The maximum value is 10,000. To get more than 10,000 results, use searchAfter.

Default: 50Minimum: 1Maximum: 10000

fromIndex the returned results start from.

Return companies from number X. Passing 1 will return all the results. Passing 10 will return results from the 10th. Note: size + from cannot be higher than 10,001

Default: 1Minimum: 1Maximum: 10001

searchAfterSearch after

Use searchAfter returned by the previous request to get the next page

companiesFiltersCompanies filters

Collection of companies filters to be applied to the search

peopleFiltersPeople filters

Collection of people filters to be applied to the search, the search results will display companies that have at least one person matching those filters

Query Parameters

apiTokenRequiredApitoken

curl -X POST "https://api.ocean.io/v2/search/companies?apiToken=string" \
  -H "Content-Type: application/json" \
  -d '{
    "size": 10,
    "from": 10,
    "searchAfter": "NoBgdA7BAsBMEgGwBoAEAiADgGwK4HN8BTAJwC8wBjAewFt0BdIA",
    "companiesFilters": {
      "lookalikeDomains": [
        "bestcustomer.com",
        "idealcustomer.com"
      ],
      "minScore": 0.95,
      "includeDomains": [
        "interesting.com",
        "amazing.com"
      ],
      "excludeDomains": [
        "boring.com",
        "useless.com"
      ],
      "companySizes": [
        "2-10",
        "51-200",
        "100001-500000"
      ],
      "ecommerce": true,
      "socialMedias": {
        "medias": [
          "linkedin",
          "facebook"
        ],
        "mode": "anyOf"
      },
      "yearFounded": {
        "from": 1960,
        "to": 1990
      },
      "countriesCount": {
        "from": 1,
        "to": 5
      },
      "revenues": [
        "0-1M",
        "1-10M",
        ">1000M"
      ],
      "employeeCountOcean": {
        "from": 10,
        "to": 100
      },
      "webTrafficVisits": {
        "from": 1000,
        "to": 10000
      },
      "mobileApps": {
        "from": 1,
        "to": 5
      },
      "headquarterGeolocation": {
        "latitude": 38.880817,
        "longitude": -77.10216,
        "radius": 1000
      },
      "geolocation": {
        "latitude": 50.83348,
        "longitude": -0.1410065,
        "radius": 5000
      },
      "locationsCount": {
        "from": 5,
        "to": 10
      },
      "departmentSizes": [
        {
          "department": "Accounting and Finance",
          "from": 5,
          "to": 10
        }
      ],
      "keywords": {
        "keywords": [
          "premium copy paper",
          "paper"
        ],
        "mode": "anyOf"
      },
      "states": [
        {
          "abbreviation": "CA",
          "country": "us"
        },
        {
          "abbreviation": "YT",
          "country": "ca"
        }
      ],
      "primaryStates": [
        {
          "abbreviation": "NY",
          "country": "us"
        }
      ],
      "employeeCountLinkedin": {
        "from": 50,
        "to": 100
      },
      "countries": [
        "es",
        "pt"
      ],
      "primaryCountries": [
        "de"
      ],
      "industries": {
        "industries": [
          "Advertising Platforms",
          "Biopharma"
        ],
        "mode": "anyOf"
      },
      "excludeIndustries": [
        "CRM",
        "B2B"
      ],
      "industryCategories": {
        "industryCategories": [
          "Real Estate",
          "Hardware"
        ],
        "mode": "anyOf"
      },
      "excludeIndustryCategories": [
        "Information Technology",
        "Privacy and Security"
      ],
      "linkedinIndustries": [
        "Management Consulting",
        "Computer Software"
      ],
      "excludeLinkedinIndustries": [
        "Management Consulting",
        "Computer Software"
      ],
      "technologies": {
        "mode": "anyOf",
        "technologies": [
          "Amazon Advertising",
          "Google Maps"
        ]
      },
      "fundingRound": {
        "date": {
          "from": "2020-01-01",
          "to": "2023-01-01"
        },
        "raised": {
          "from": 1000000,
          "to": 5000000
        },
        "types": [
          "Seed",
          "Series A"
        ]
      },
      "fieldsExist": [
        "industries",
        "emails",
        "locations"
      ],
      "fieldsNotExist": [
        "industryCategories",
        "phones"
      ]
    },
    "peopleFilters": {
      "includeIds": [
        "51e19df9c1d70c7c",
        "971b1b1bfb1ffb1a"
      ],
      "excludeIds": [
        "51e19df9c1d70c7c",
        "971b1b1bfb1ffb1a"
      ],
      "seniorities": [
        "Founder",
        "Owner"
      ],
      "jobTitles": [
        "CEO",
        "CTO"
      ],
      "excludeJobTitles": [
        "CEO",
        "CTO"
      ],
      "departments": [
        "Management",
        "Marketing and Advertising"
      ],
      "countries": [
        "us",
        "dk"
      ],
      "states": [
        {
          "abbreviation": "NY",
          "country": "us"
        },
        {
          "abbreviation": "ON",
          "country": "ca"
        },
        {
          "abbreviation": "5",
          "country": "at"
        },
        {
          "abbreviation": "SH",
          "country": "de"
        }
      ],
      "names": [
        "John Doe",
        "Peter Pan"
      ],
      "emails": [
        "email_1@domain.com",
        "email_2@domain.com"
      ],
      "keywords": [
        "engineering",
        "research"
      ],
      "fieldsExist": [
        "name",
        "country",
        "linkedinUrl"
      ],
      "fieldsNotExist": [
        "firstName",
        "location",
        "jobTitleEnglish"
      ],
      "changedPositionAfter": "2023-01"
    }
  }'

Successful Response

{
  "companies": [
    {
      "company": {
        "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": [
          "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"
          }
        ],
        "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@dundermifflin.com",
          "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"
        }
      },
      "score": 0.96
    }
  ],
  "searchAfter": "NoBgdA7BAsBMEgGwBoAEAiADgGwK4HN8BTAJwC8wBjAewFt0BdIA",
  "detail": "OK",
  "total": 32871,
  "missingDomains": {
    "domain-with-bad-content.com": "bad content",
    "domain-with-missing-context-vector.com": "missing context vector",
    "not-yet-crawled-domain.com": "data gathering started"
  }
}

Lookalike companies search

Request Body

Query Parameters

Response

TypeScript