# Ocean.io People Lookup & Enrichment

> Ocean.io People Lookup & Enrichment is a paid API for AI agents from x402.orthogonal.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Batch-lookup and enrich professional profiles by LinkedIn handle or Ocean.io ID, returning detailed person data including job history, skills, email, and more.

## Facts

- Endpoint: POST https://x402.orthogonal.com/ocean-io/v2/lookup/people
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/ocean-io-people-lookup-enrichment-0921029f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_NoRBfvM5s_M5vQBaw29JF

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability ocean-io-people-lookup-enrichment-0921029f -d '<json body>'
```

Example prompt: Look up the LinkedIn profiles for 'john-doe-123' and 'jane-smith-456' and return their current job titles, emails, departments, and work experience.

## When to prefer this

Use this endpoint when you need to batch-enrich professional profiles for known individuals via LinkedIn handles or Ocean.io IDs — particularly for sales prospecting, CRM enrichment, recruiting, or ABM workflows. Prefer it over single-record lookup APIs when processing up to 1000 people at once. It's the right choice when you need structured career data (experience, seniority, department, email) rather than a search-by-name or company-based discovery approach.

## Known failure modes

- Person not found returns null for that entry rather than an error
- Exceeding 1000 combined handles/IDs returns a validation error
- Invalid LinkedIn handle format may return null or an error
- Insufficient credits results in a payment/credit error
- Stale data: profiles may not reflect very recent LinkedIn changes

## How this service works

Lookup and enrich multiple people by LinkedIn handle or Ocean.io ID (max 1000 total). Costs 0.05 credits per handle/ID. People not found return null.

## Output

Returns an array of Person objects (or null for not-found entries) containing requested fields such as name, email, LinkedIn URL, current job title, seniority, department, location, photo, work experience history (company domain, titles, dates, descriptions), skills, and a professional summary. Only fields specified in the 'fields' parameter are returned if provided; otherwise all fields are included.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "fields": {
   "type": "array",
   "description": "string[] - Fields to return in Person objects (reduces bandwidth). If not specified, all fields returned. Options: \"id\", \"domain\", \"name\", \"firstName\", \"lastName\", \"country\", \"state\", \"location\", \"linkedinUrl\", \"seniorities\", \"departments\", \"photo\", \"jobTitle\", \"jobTitleEnglish\", \"currentJobDescription\", \"experiences\", \"summary\", \"skills\", \"email\", \"updatedAt\". Nested: \"experiences.domain\", \"experiences.jobTitle\", \"experiences.dateFrom\", \"experiences.dateTo\", \"experiences.description\", \"experiences.linkedinCompanyHandle\", \"email.address\"."
  },
  "oceanIds": {
   "type": "array",
   "description": "string[] - List of Ocean.io person IDs to lookup. Max 1000 combined with linkedinHandles. Cost: 0.05 credits per ID."
  },
  "linkedinHandles": {
   "type": "array",
   "description": "string[] - List of LinkedIn profile handles to lookup (e.g. [\"john-doe\", \"jane-smith\"]). Max 1000 combined with oceanIds. Cost: 0.05 credits per handle."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/ocean-io-people-lookup-enrichment-0921029f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.orthogonal.com](https://www.zero.xyz/host/x402.orthogonal.com/llms.txt)