{"uid":"cap_NoRBfvM5s_M5vQBaw29JF","slug":"ocean-io-people-lookup-enrichment-0921029f","name":"Ocean.io People Lookup & Enrichment","description":"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.","url":"https://x402.orthogonal.com/ocean-io/v2/lookup/people","method":"POST","headers":{},"bodySchema":{"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."}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_GWAdXR9uSBIUSkfYaeont","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Batch-lookup and enrich professional profiles by LinkedIn handle or Ocean.io ID, returning detailed person data including job history, skills, email, and more.","exampleAgentPrompt":"Look up the LinkedIn profiles for 'john-doe-123' and 'jane-smith-456' and return their current job titles, emails, departments, and work experience.","exampleUseCases":[{"title":"Enrich sales prospect list","prompt":"I have a list of LinkedIn handles from my sales pipeline — 'alice-johnson-b2b', 'mark-taylor-saas', and 'priya-patel-cto' — can you pull their current job titles, company domains, seniority levels, and email addresses so I can update my CRM?"},{"title":"Recruiting candidate background check","prompt":"I'm screening candidates and have their LinkedIn handles: 'carlos-mendez-eng', 'li-wei-product', and 'fatima-hassan-design'. Can you get me their full work experience, skills, and current job descriptions?"},{"title":"Account-based marketing profile enrichment","prompt":"We're running an ABM campaign and I need to enrich these Ocean.io person IDs — '0p1q2r3s', '4t5u6v7w', '8x9y0z1a' — with their names, locations, departments, and LinkedIn URLs so we can personalize outreach."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:57:47.463Z","isFirstParty":false}