Lookup multiple people by LinkedIn handle or Ocean ID

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.

Quickstart#

LinkedIn handle format

Use the URL slug only — the part after linkedin.com/in/. For https://linkedin.com/in/jane-doe-123, pass "jane-doe-123".

curl -X POST "https://api.ocean.io/v2/lookup/people" \
  -H "X-Api-Token: YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "linkedinHandles": ["jane-doe-123", "john-smith-456"],
    "oceanIds": ["ocean-id-abc"]
  }'

import requests

response = requests.post(
    'https://api.ocean.io/v2/lookup/people',
    headers={'X-Api-Token': 'YOUR_API_TOKEN'},
    json={
        'linkedinHandles': ['jane-doe-123', 'john-smith-456'],
        'oceanIds': ['ocean-id-abc'],
    },
)
data = response.json()

const response = await fetch('https://api.ocean.io/v2/lookup/people', {
  method: 'POST',
  headers: {
    'X-Api-Token': 'YOUR_API_TOKEN',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    linkedinHandles: ['jane-doe-123', 'john-smith-456'],
    oceanIds: ['ocean-id-abc'],
  }),
});
const data = await response.json();

Example response:

{
  "people": [
    {
      "id": "abc123",
      "name": "Jane Doe",
      "jobTitle": "Head of Product",
      "domain": "example.com",
      "linkedinUrl": "https://linkedin.com/in/jane-doe-123"
    }
  ],
  "totalRequested": 3,
  "totalFound": 2
}

Unmatched identifiers are silently omitted. Compare totalRequested vs totalFound to identify gaps.