Search
Lookalike people search
Search people using filters and/or people Ids Looking for the legacy endpoint? Access it here
Cost calculation:
- Request that contains one or more lookalike people or one or more lookalike companies - 3 credits per person in result
- Request that does not contain lookalike people and does not include lookalike companies - 1 credit per person in result
Webhook result: Email results Phone results
Request Body
application/jsonRequiredsizeMaximum number of resultsNumber of people to return. The maximum value is 10,000.
Default:
50Minimum: 1Maximum: 10000peopleFiltersobject | null | nullcompaniesFiltersobject | null | nullpeoplePerCompanyinteger | null | nulljobTitleThresholdnumber | null | nullsearchAfterstring | null | nullQuery Parameters
apiTokenstring | null | nullHeader Parameters
x-api-tokenstring | null | nullResponse Body
Successful Response
TypeScript Definitions
Use the response body type in TypeScript.
peopleRequiredPeopledetailRequiredDetailStatus text
lookalikePeopleStatusesobject | null | nulltotalinteger | null | nullsearchAfterstring | null | nullBad Request
TypeScript Definitions
Use the response body type in TypeScript.
detailRequiredstringValue in:
"Conflicting API tokens provided in query parameters and headers"Payment Required
TypeScript Definitions
Use the response body type in TypeScript.
detailRequiredstringValue in:
"Insufficient standard credits"Forbidden
TypeScript Definitions
Use the response body type in TypeScript.
detailRequiredstringValue in:
"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.
detailDetailcurl -X POST "https://api.ocean.io/v3/search/people?apiToken=string" \
-H "x-api-token: string" \
-H "Content-Type: application/json" \
-d '{
"size": 10,
"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"
],
"skills": {
"allOf": [
"Product Management",
"Entrepreneurship"
],
"anyOf": [
"Social Media",
"Competitive Analysis"
],
"noneOf": [
"Writing",
"Project Management"
]
},
"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",
"changedPositionBefore": "2023-01"
},
"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"
]
},
"minRelevance": "B",
"maxRelevance": "B"
},
"peoplePerCompany": 3,
"jobTitleThreshold": 0.8,
"searchAfter": "N4IglgdgJgpgHiAXAVgL5A"
}'const body = JSON.stringify({
"size": 10,
"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"
],
"skills": {
"allOf": [
"Product Management",
"Entrepreneurship"
],
"anyOf": [
"Social Media",
"Competitive Analysis"
],
"noneOf": [
"Writing",
"Project Management"
]
},
"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",
"changedPositionBefore": "2023-01"
},
"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"
]
},
"minRelevance": "B",
"maxRelevance": "B"
},
"peoplePerCompany": 3,
"jobTitleThreshold": 0.8,
"searchAfter": "N4IglgdgJgpgHiAXAVgL5A"
})
fetch("https://api.ocean.io/v3/search/people?apiToken=string", {
headers: {
"x-api-token": "string"
},
body
})package main
import (
"fmt"
"net/http"
"io/ioutil"
"strings"
)
func main() {
url := "https://api.ocean.io/v3/search/people?apiToken=string"
body := strings.NewReader(`{
"size": 10,
"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"
],
"skills": {
"allOf": [
"Product Management",
"Entrepreneurship"
],
"anyOf": [
"Social Media",
"Competitive Analysis"
],
"noneOf": [
"Writing",
"Project Management"
]
},
"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",
"changedPositionBefore": "2023-01"
},
"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"
]
},
"minRelevance": "B",
"maxRelevance": "B"
},
"peoplePerCompany": 3,
"jobTitleThreshold": 0.8,
"searchAfter": "N4IglgdgJgpgHiAXAVgL5A"
}`)
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/v3/search/people?apiToken=string"
body = {
"size": 10,
"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"
],
"skills": {
"allOf": [
"Product Management",
"Entrepreneurship"
],
"anyOf": [
"Social Media",
"Competitive Analysis"
],
"noneOf": [
"Writing",
"Project Management"
]
},
"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",
"changedPositionBefore": "2023-01"
},
"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"
]
},
"minRelevance": "B",
"maxRelevance": "B"
},
"peoplePerCompany": 3,
"jobTitleThreshold": 0.8,
"searchAfter": "N4IglgdgJgpgHiAXAVgL5A"
}
response = requests.request("POST", url, json = body, headers = {
"x-api-token": "string",
"Content-Type": "application/json"
})
print(response.text){
"people": [
{
"id": "e9447c74eafa8a19",
"domain": "google.com",
"name": "John Doe",
"firstName": "John",
"lastName": "Doe",
"country": "us",
"state": "CA",
"location": "Copenhagen, Capital Region, Denmark",
"linkedinUrl": "https://www.linkedin.com/in/someone",
"seniorities": [
"C-Level",
"Manager"
],
"departments": [
"Management",
"Marketing and Advertising"
],
"photo": "http://media.licdn.com/dms/image/somelink",
"jobTitle": "Professeur",
"jobTitleEnglish": "Teacher",
"currentJobDescription": "Software Engineer specializing in cloud infrastructure",
"experiences": [
{
"dateFrom": "2020-01-01",
"dateTo": "2021-01-01",
"description": "Software Engineer specializing in cloud infrastructure",
"domain": "domain.com",
"jobTitle": "Software Engineer"
}
],
"summary": "Some text that the person wrote to describe themselves",
"skills": [
"Product Management",
"Entrepreneurship",
"Social Media"
],
"phone": {
"numbers": [
"+4512345678",
"+33 6 00 00 00 00"
],
"status": "verified"
},
"email": {
"address": "example.jonas@ocean.io",
"status": "verified"
},
"company": {
"companySize": "2-10",
"logo": "https://cdn2.ocean.io/companies-logos-v1/domain.com/020539e284d9318e805301b672ad23047c30818a.png",
"name": "Dunder Mifflin Paper Company"
}
}
],
"detail": "OK",
"lookalikePeopleStatuses": {
"successfulPeople": [
"person_id_1",
"person_id_2"
],
"notFoundPeople": [
"person_id_1",
"person_id_2"
],
"triggeredDomainPeople": [
"person_id_1",
"person_id_2"
],
"missingCompanyInformationPeople": [
"person_id_1",
"person_id_2"
]
},
"total": 32871,
"searchAfter": "NoBgdA7BAsBMEgGwBoAEAiADgGwK4HN8BTAJwC8wBjAewFt0BdIA"
}{
"detail": "Conflicting API tokens provided in query parameters and headers"
}{
"detail": "Insufficient standard credits"
}{
"detail": "API token should be provided in headers or query parameters"
}Empty
{
"detail": [
{
"loc": [
"string"
],
"msg": "string",
"type": "string"
}
]
}