Sign in

v2

latestOpenAPI 3.1.02026-07-2626156230.6 KB
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.

post/v2/lookup/people

Query parameters

apiTokenstring nullable

Headers

x-api-tokenstring nullable

Request body

linkedinHandlesstring[]

List of LinkedIn profile handles to lookup (e.g., ['john-doe', 'jane-smith'])

oceanIdsstring[]

List of Ocean.io person IDs to lookup (e.g., ['abc123', 'def456'])

Example request

{
  "linkedinHandles": [
    "john-doe",
    "jane-smith"
  ],
  "oceanIds": [
    "abc123",
    "def456"
  ]
}

Response

Successful Response

totalRequestedinteger required

Total number of identifiers requested

totalFoundinteger required

Total number of people found

creditsUsednumber required

Number of credits charged for this request.

Example response

{
  "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"
        ]
      },
      "email": {
        "address": "name@gmail.com"
      },
      "inferredEmails": [
        "john.doe@domain.com",
        "j.doe@domain.com"
      ],
      "updatedAt": "2022-10-27T12:09:37Z",
      "connectionsCount": 10,
      "followersCount": 50,
      "headline": "Senior Software Engineer | Tech Lead",
      "company": {
        "logo": "https://cdn2.ocean.io/companies-logos-v1/domain.com/020539e284d9318e805301b672ad23047c30818a.png",
        "name": "Dunder Mifflin Paper Company",
        "employeeCountOcean": 57,
        "industries": [
          "Audio",
          "Electronics"
        ],
        "technologies": [
          "Accesso",
          "Adcash",
          "Atlassian Jira"
        ]
      },
      "relevance": "A"
    }
  ],
  "totalRequested": 2,
  "totalFound": 1,
  "creditsUsed": 1
}