Lookalike people search (RC)
Note: this endpoint is marked as a Release Candidate (RC). We won't change the format of parameters/results but there is a lot we want to improve, mainly about speed, stability and number of results. Search people using filters. Note: at the moment, lookalikePeopleIds is mandatory.
Body Required
-
size integer
Number of people to return. The maximum value is 10,000.
Minimum value is
1.0
, maximum value is10000.0
. Default value is50
. -
peopleFilters object | null
Additional properties are NOT allowed.
-
companiesFilters object | null
Additional properties are NOT allowed.
-
peoplePerCompany integer | null
Minimum value is
1.0
. -
jobTitleThreshold number | null
Minimum value is
0.0
, maximum value is1.0
. Default value is0.8
.
POST /v3/search/people
curl \
-X POST https://api.ocean.io/v3/search/people?apiToken=string \
-H "Content-Type: application/json" \
-d '{"size":10,"peopleFilters":{"lookalikePeopleIds":["string"],"lookalikeLinkedinHandles":["string"],"countries":["string"],"excludePeopleIds":["string"],"excludeLinkedinHandles":["string"],"seniorities":["Founder","Owner"],"regions":["string"]},"companiesFilters":{"lookalikeDomains":["string"],"includeDomains":["string"],"industries":["string"],"excludeDomains":["string"],"primaryCountries":["de"],"companySizes":["2-10","51-200","100001-500000"]},"peoplePerCompany":3,"jobTitleThreshold":0.8}'
Request examples
{
"size": 10,
"peopleFilters": {
"lookalikePeopleIds": [
"string"
],
"lookalikeLinkedinHandles": [
"string"
],
"countries": [
"string"
],
"excludePeopleIds": [
"string"
],
"excludeLinkedinHandles": [
"string"
],
"seniorities": [
"Founder",
"Owner"
],
"regions": [
"string"
]
},
"companiesFilters": {
"lookalikeDomains": [
"string"
],
"includeDomains": [
"string"
],
"industries": [
"string"
],
"excludeDomains": [
"string"
],
"primaryCountries": [
"de"
],
"companySizes": [
"2-10",
"51-200",
"100001-500000"
]
},
"peoplePerCompany": 3,
"jobTitleThreshold": 0.8
}
Response examples (200)
{
"people": [
{
"id": "e9447c74eafa8a19",
"domain": "google.com",
"name": "John Doe",
"firstName": "John",
"lastName": "Doe",
"country": "us",
"region": "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",
"summary": "Some text that the person wrote to describe themselves"
}
],
"searchAfter": "NoBgdA7BAsBMEgGwBoAEAiADgGwK4HN8BTAJwC8wBjAewFt0BdIA",
"detail": "OK",
"total": 32871
}
Response examples (402)
{
"detail": "Insufficient standard credits"
}
Response examples (422)
{
"detail": [
{
"loc": [
"string"
],
"msg": "string",
"type": "string"
}
]
}