Lookup
Lookup multiple people by LinkedIn handle or Ocean ID
Lookup and enrich multiple people by LinkedIn handles and/or Ocean.io IDs (max 1000 total). This endpoint provides simple, per-result pricing.
Key features:
- Batch lookup up to 1000 people (combined total of linkedinHandles + oceanIds)
- Provide either linkedinHandles, oceanIds, or both lists
Returns only successfully matched people in the response.
Query Parameters
apiToken?string | null
Header Parameters
x-api-token?string | null
linkedinHandles?array<string>
List of LinkedIn profile handles to lookup (e.g., ['john-doe', 'jane-smith'])
Example
["john-doe","jane-smith"]oceanIds?array<string>
List of Ocean.io person IDs to lookup (e.g., ['abc123', 'def456'])
Example
["abc123","def456"]Response Body
curl -X POST "https://api.ocean.io/v2/lookup/people?apiToken=string" \
-H "x-api-token: string" \
-H "Content-Type: application/json" \
-d '{}'{
"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": "[email protected]",
"status": "verified"
},
"company": {
"companySize": "2-10",
"logo": "https://cdn2.ocean.io/companies-logos-v1/domain.com/020539e284d9318e805301b672ad23047c30818a.png",
"name": "Dunder Mifflin Paper Company"
}
}
],
"totalRequested": 2,
"totalFound": 1
}{
"detail": "Conflicting API tokens provided in query parameters and headers"
}{
"detail": "Insufficient credits"
}{
"detail": "API token should be provided in headers or query parameters"
}Empty
{
"detail": [
{
"loc": [
"string"
],
"msg": "string",
"type": "string"
}
]
}