Lookalike companies search (deprecated)
Search companies using filters
Request Body
application/json
Requiredsize
Maximum number of resultsNumber of companies to return. The maximum value is 10,000. To get more than 10,000 results, use searchAfter
.
50
Minimum: 1
Maximum: 10000
from
Index 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
1
Minimum: 1
Maximum: 10001
searchAfter
string | null | nullcompaniesFilters
object | null | nullpeopleFilters
object | null | nullQuery Parameters
apiToken
string | null | nullHeader Parameters
x-api-token
string | null | nullResponse Body
Successful Response
TypeScript Definitions
Use the response body type in TypeScript.
searchAfter
string | null | nulldetail
RequiredDetailStatus text
total
integer | null | nullmissingDomains
object | null | nullcompanies
RequiredCompanies foundArray of found companies. Returns empty array if no results
Bad Request
TypeScript Definitions
Use the response body type in TypeScript.
detail
Requiredstring"Conflicting API tokens provided in query parameters and headers"
Payment Required
TypeScript Definitions
Use the response body type in TypeScript.
detail
Requiredstring"Insufficient credits"
Forbidden
TypeScript Definitions
Use the response body type in TypeScript.
detail
Requiredstring"API token should be provided in headers or query parameters" | "Current API token is not registered in our database"
Not found
Validation Error
TypeScript Definitions
Use the response body type in TypeScript.
detail
Detailcurl -X POST "https://api.ocean.io/v2/search/companies?apiToken=string" \
-H "x-api-token: string" \
-H "Content-Type: application/json" \
-d '{
"size": 10,
"from": 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"
]
},
"countries": [
"es",
"pt"
],
"primaryCountries": [
"de"
],
"states": [
{
"abbreviation": "CA",
"country": "us"
},
{
"abbreviation": "YT",
"country": "ca"
}
],
"primaryStates": [
{
"abbreviation": "NY",
"country": "us"
}
],
"cities": [
{
"city": "New York",
"country": "us"
},
{
"city": "Los Angeles",
"country": "us"
}
],
"primaryCities": [
{
"city": "New York",
"country": "us"
},
{
"city": "Los Angeles",
"country": "us"
}
],
"headquarterGeolocation": {
"latitude": 38.880817,
"longitude": -77.10216,
"radius": 1000
},
"geolocation": {
"latitude": 50.83348,
"longitude": -0.1410065,
"radius": 5000
},
"webTrafficVisits": {
"from": 1000,
"to": 10000
},
"keywords": {
"keywords": [
"premium copy paper",
"paper"
],
"mode": "anyOf"
},
"fieldsExist": [
"industries",
"emails",
"locations"
],
"fieldsNotExist": [
"industryCategories",
"phones"
],
"socialMedias": {
"medias": [
"linkedin",
"facebook"
],
"mode": "anyOf"
},
"technologies": {
"mode": "anyOf",
"technologies": [
"Amazon Advertising",
"Google Maps"
]
},
"minScore": 0.95
},
"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",
"changedPositionBefore": "2023-01"
}
}'
const body = JSON.stringify({
"size": 10,
"from": 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"
]
},
"countries": [
"es",
"pt"
],
"primaryCountries": [
"de"
],
"states": [
{
"abbreviation": "CA",
"country": "us"
},
{
"abbreviation": "YT",
"country": "ca"
}
],
"primaryStates": [
{
"abbreviation": "NY",
"country": "us"
}
],
"cities": [
{
"city": "New York",
"country": "us"
},
{
"city": "Los Angeles",
"country": "us"
}
],
"primaryCities": [
{
"city": "New York",
"country": "us"
},
{
"city": "Los Angeles",
"country": "us"
}
],
"headquarterGeolocation": {
"latitude": 38.880817,
"longitude": -77.10216,
"radius": 1000
},
"geolocation": {
"latitude": 50.83348,
"longitude": -0.1410065,
"radius": 5000
},
"webTrafficVisits": {
"from": 1000,
"to": 10000
},
"keywords": {
"keywords": [
"premium copy paper",
"paper"
],
"mode": "anyOf"
},
"fieldsExist": [
"industries",
"emails",
"locations"
],
"fieldsNotExist": [
"industryCategories",
"phones"
],
"socialMedias": {
"medias": [
"linkedin",
"facebook"
],
"mode": "anyOf"
},
"technologies": {
"mode": "anyOf",
"technologies": [
"Amazon Advertising",
"Google Maps"
]
},
"minScore": 0.95
},
"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",
"changedPositionBefore": "2023-01"
}
})
fetch("https://api.ocean.io/v2/search/companies?apiToken=string", {
headers: {
"x-api-token": "string"
},
body
})
package main
import (
"fmt"
"net/http"
"io/ioutil"
"strings"
)
func main() {
url := "https://api.ocean.io/v2/search/companies?apiToken=string"
body := strings.NewReader(`{
"size": 10,
"from": 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"
]
},
"countries": [
"es",
"pt"
],
"primaryCountries": [
"de"
],
"states": [
{
"abbreviation": "CA",
"country": "us"
},
{
"abbreviation": "YT",
"country": "ca"
}
],
"primaryStates": [
{
"abbreviation": "NY",
"country": "us"
}
],
"cities": [
{
"city": "New York",
"country": "us"
},
{
"city": "Los Angeles",
"country": "us"
}
],
"primaryCities": [
{
"city": "New York",
"country": "us"
},
{
"city": "Los Angeles",
"country": "us"
}
],
"headquarterGeolocation": {
"latitude": 38.880817,
"longitude": -77.10216,
"radius": 1000
},
"geolocation": {
"latitude": 50.83348,
"longitude": -0.1410065,
"radius": 5000
},
"webTrafficVisits": {
"from": 1000,
"to": 10000
},
"keywords": {
"keywords": [
"premium copy paper",
"paper"
],
"mode": "anyOf"
},
"fieldsExist": [
"industries",
"emails",
"locations"
],
"fieldsNotExist": [
"industryCategories",
"phones"
],
"socialMedias": {
"medias": [
"linkedin",
"facebook"
],
"mode": "anyOf"
},
"technologies": {
"mode": "anyOf",
"technologies": [
"Amazon Advertising",
"Google Maps"
]
},
"minScore": 0.95
},
"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",
"changedPositionBefore": "2023-01"
}
}`)
req, _ := http.NewRequest("POST", url, body)
req.Header.Add("x-api-token", "string")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := ioutil.ReadAll(res.Body)
fmt.Println(res)
fmt.Println(string(body))
}
import requests
url = "https://api.ocean.io/v2/search/companies?apiToken=string"
body = {
"size": 10,
"from": 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"
]
},
"countries": [
"es",
"pt"
],
"primaryCountries": [
"de"
],
"states": [
{
"abbreviation": "CA",
"country": "us"
},
{
"abbreviation": "YT",
"country": "ca"
}
],
"primaryStates": [
{
"abbreviation": "NY",
"country": "us"
}
],
"cities": [
{
"city": "New York",
"country": "us"
},
{
"city": "Los Angeles",
"country": "us"
}
],
"primaryCities": [
{
"city": "New York",
"country": "us"
},
{
"city": "Los Angeles",
"country": "us"
}
],
"headquarterGeolocation": {
"latitude": 38.880817,
"longitude": -77.10216,
"radius": 1000
},
"geolocation": {
"latitude": 50.83348,
"longitude": -0.1410065,
"radius": 5000
},
"webTrafficVisits": {
"from": 1000,
"to": 10000
},
"keywords": {
"keywords": [
"premium copy paper",
"paper"
],
"mode": "anyOf"
},
"fieldsExist": [
"industries",
"emails",
"locations"
],
"fieldsNotExist": [
"industryCategories",
"phones"
],
"socialMedias": {
"medias": [
"linkedin",
"facebook"
],
"mode": "anyOf"
},
"technologies": {
"mode": "anyOf",
"technologies": [
"Amazon Advertising",
"Google Maps"
]
},
"minScore": 0.95
},
"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",
"changedPositionBefore": "2023-01"
}
}
response = requests.request("POST", url, json = body, headers = {
"x-api-token": "string",
"Content-Type": "application/json"
})
print(response.text)
{
"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
}
}
]
},
"score": 0.96
}
]
}
{
"detail": "Conflicting API tokens provided in query parameters and headers"
}
{
"detail": "Insufficient credits"
}
{
"detail": "API token should be provided in headers or query parameters"
}
{
"detail": [
{
"loc": [
"string"
],
"msg": "string",
"type": "string"
}
]
}