LogoOcean.io
API/Endpoints/Search

Lookalike companies search

Search companies using filters

POST
/v3/search/companies

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
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

apiTokenApitoken

Header Parameters

x-api-tokenX-Api-Token
curl -X POST "https://api.ocean.io/v3/search/companies?apiToken=string" \
  -H "x-api-token: string" \
  -H "Content-Type: application/json" \
  -d '{
    "size": 10,
    "searchAfter": "NoBgdA7BAsBMEgGwBoAEAiADgGwK4HN8BTAJwC8wBjAewFt0BdIA",
    "companiesFilters": {
      "lookalikeDomains": [
        "bestcustomer.com",
        "idealcustomer.com"
      ],
      "includeDomains": [
        "interesting.com",
        "amazing.com"
      ],
      "excludeDomains": [
        "boring.com",
        "useless.com"
      ],
      "companySizes": [
        "2-10",
        "51-200",
        "100001-500000"
      ],
      "ecommerce": true,
      "yearFounded": {
        "from": 1960,
        "to": 1990
      },
      "countriesCount": {
        "from": 1,
        "to": 5
      },
      "revenues": [
        "0-1M",
        "1-10M",
        ">1000M"
      ],
      "employeeCountOcean": {
        "from": 10,
        "to": 100
      },
      "mobileApps": {
        "from": 1,
        "to": 5
      },
      "locationsCount": {
        "from": 5,
        "to": 10
      },
      "departmentSizes": [
        {
          "department": "Accounting and Finance",
          "from": 5,
          "to": 10
        }
      ],
      "employeeCountLinkedin": {
        "from": 50,
        "to": 100
      },
      "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"
      ],
      "fundingRound": {
        "date": {
          "from": "2020-01-01",
          "to": "2023-01-01"
        },
        "raised": {
          "from": 1000000,
          "to": 5000000
        },
        "types": [
          "Seed",
          "Series A"
        ]
      },
      "primaryLocations": {
        "includeCountries": [
          "es",
          "pt"
        ],
        "excludeCountries": [
          "br",
          "de"
        ],
        "includeRegions": [
          {
            "abbreviation": "CA",
            "country": "us"
          },
          {
            "abbreviation": "YT",
            "country": "ca"
          }
        ],
        "excludeRegions": [
          {
            "abbreviation": "CA",
            "country": "us"
          },
          {
            "abbreviation": "YT",
            "country": "ca"
          }
        ],
        "includeCities": [
          {
            "city": "New York",
            "country": "us"
          },
          {
            "city": "Los Angeles",
            "country": "us"
          }
        ],
        "excludeCities": [
          {
            "city": "New York",
            "country": "us"
          },
          {
            "city": "Los Angeles",
            "country": "us"
          }
        ],
        "geolocation": {
          "latitude": 38.880817,
          "longitude": -77.10216,
          "radius": 1000
        }
      },
      "otherLocations": {
        "includeCountries": [
          "es",
          "pt"
        ],
        "excludeCountries": [
          "br",
          "de"
        ],
        "includeRegions": [
          {
            "abbreviation": "CA",
            "country": "us"
          },
          {
            "abbreviation": "YT",
            "country": "ca"
          }
        ],
        "excludeRegions": [
          {
            "abbreviation": "CA",
            "country": "us"
          },
          {
            "abbreviation": "YT",
            "country": "ca"
          }
        ],
        "includeCities": [
          {
            "city": "New York",
            "country": "us"
          },
          {
            "city": "Los Angeles",
            "country": "us"
          }
        ],
        "excludeCities": [
          {
            "city": "New York",
            "country": "us"
          },
          {
            "city": "Los Angeles",
            "country": "us"
          }
        ],
        "geolocation": {
          "latitude": 38.880817,
          "longitude": -77.10216,
          "radius": 1000
        }
      },
      "webTraffic": {
        "views": {
          "from": 1000,
          "to": 1000000
        },
        "visits": {
          "from": 1000,
          "to": 10000
        }
      },
      "socialMedias": {
        "medias": {
          "all_of": [
            "facebook",
            "x"
          ],
          "any_of": [
            "youtube",
            "xing"
          ],
          "none_of": [
            "instagram",
            "tiktok"
          ]
        },
        "min_count": 3
      },
      "technologies": {
        "apps": {
          "all_of": [
            "Amazon Advertising",
            "Google Maps"
          ],
          "any_of": [
            "BrightEdge",
            "Nette Framework"
          ],
          "none_of": [
            "Kount",
            "Nativo"
          ]
        },
        "categories": {
          "all_of": [
            "Analytics",
            "Security"
          ],
          "any_of": [
            "Advertising",
            "WordPress themes"
          ],
          "none_of": [
            "CMS",
            "Reviews"
          ]
        }
      },
      "keywords": {
        "all_of": [
          "lead generation",
          "marketing"
        ],
        "any_of": [
          "smart prospecting",
          "data platform"
        ],
        "none_of": [
          "seo"
        ]
      }
    },
    "peopleFilters": {
      "lookalikeLinkedinHandles": [
        "michael-scott-13532",
        "dwight-schrute"
      ],
      "countries": [
        "us",
        "dk"
      ],
      "includePeopleIds": [
        "43g19df9c1d70f9a",
        "54hb1b1bfb1ffc5t"
      ],
      "includeLinkedinHandles": [
        "jim-halpert-5343",
        "toby-67832"
      ],
      "excludePeopleIds": [
        "43g19df9c1d70f9a",
        "54hb1b1bfb1ffc5t"
      ],
      "excludeLinkedinHandles": [
        "jim-halpert-5343",
        "toby-67832"
      ],
      "seniorities": [
        "Founder",
        "Owner"
      ],
      "jobTitleKeywords": {
        "allOf": [
          "Manager"
        ],
        "anyOf": [
          "Marketing",
          "designer"
        ],
        "noneOf": [
          "content"
        ]
      },
      "allJobDescriptions": {
        "allOf": [
          "software engineer"
        ],
        "anyOf": [
          "software engineer"
        ],
        "noneOf": [
          "entry-level"
        ]
      },
      "currentJobDescription": {
        "allOf": [
          "software engineer",
          "big tech company"
        ],
        "anyOf": [
          "software engineer"
        ],
        "noneOf": [
          "entry-level"
        ]
      },
      "profileDescription": {
        "allOf": [
          "software engineer"
        ],
        "anyOf": [
          "software engineer"
        ],
        "noneOf": [
          "entry-level"
        ]
      },
      "regions": [
        "CA",
        "TX"
      ],
      "states": [
        {
          "abbreviation": "NY",
          "country": "us"
        },
        {
          "abbreviation": "ENG",
          "country": "gb"
        },
        {
          "abbreviation": "5",
          "country": "at"
        },
        {
          "abbreviation": "SH",
          "country": "de"
        }
      ],
      "cities": [
        {
          "city": "New York",
          "country": "us"
        },
        {
          "city": "Los Angeles",
          "country": "us"
        }
      ],
      "names": [
        "John Doe",
        "Peter Pan"
      ],
      "departments": [
        "Management",
        "Marketing and Advertising"
      ],
      "fieldsExist": [
        "name",
        "country",
        "linkedinUrl"
      ],
      "fieldsNotExist": [
        "firstName",
        "location",
        "jobTitleEnglish"
      ],
      "changedPositionAfter": "2023-01"
    }
  }'

Successful Response

{
  "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"
  },
  "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"
        },
        "headcountGrowth": {
          "sixMonths": 20,
          "threeMonths": 10,
          "twelveMonths": 30
        },
        "headcountGrowthPerDepartment": [
          {
            "department": "Accounting and Finance",
            "growth": {
              "sixMonths": 20,
              "threeMonths": 10,
              "twelveMonths": 30
            }
          }
        ]
      },
      "relevance": "A"
    }
  ]
}

Lookalike companies search (deprecated)

Search companies using filters

Search people

Search people using filters and/or people Ids **Cost calculation:** - Request that contains one or more lookalike company domains - 3 credits per person in result - Request that does not contain any lookalike company domains - 1 credit per person in result