{"uid":"cap_YLvm_GqL9aLLVALAcX3O0","slug":"ocean-io-people-search-033f9d83","name":"Ocean.io People Search","description":"Search for people using filters (job title, seniority, department, skills, location) with optional company filters. Returns enriched person profiles. Use the size parameter to control max results (1-10,000). Use searchAfter from the previous response to paginate.","url":"https://x402.orthogonal.com/ocean-io/v3/search/people","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"size":{"type":"integer","description":"Max results to return (1-10,000). Default: 50."},"fields":{"type":"array","description":"string[] - Fields to return in Person objects (reduces bandwidth). Options: \"id\", \"domain\", \"name\", \"firstName\", \"lastName\", \"country\", \"state\", \"location\", \"linkedinUrl\", \"seniorities\", \"departments\", \"photo\", \"jobTitle\", \"jobTitleEnglish\", \"currentJobDescription\", \"experiences\", \"summary\", \"skills\", \"email\", \"updatedAt\". Nested fields: \"experiences.domain\", \"experiences.jobTitle\", \"experiences.dateFrom\", \"experiences.dateTo\", \"experiences.description\", \"experiences.linkedinCompanyHandle\", \"email.address\"."},"searchAfter":{"type":"string","description":"Pagination cursor returned by the previous response to get the next page of results."},"peopleFilters":{"type":"object","description":"People filters object. Fields: lookalikeLinkedinHandles: string[], countries: string[] (ISO 3166 alpha-2), excludeCountries: string[], regions: string[], states: object[] ({country: string, abbreviation: string}), excludeStates: object[], cities: object[] ({country: string, city: string}), names: string[], seniorities: string[] (enum: \"Owner\", \"Founder\", \"Board Member\", \"C-Level\", \"Partner\", \"VP\", \"Head\", \"Director\", \"Manager\", \"Other\"), departments: string[] (enum: \"Accounting and Finance\", \"Board\", \"Business Support\", \"Customer Relations\", \"Design\", \"Editorial Personnel\", \"Engineering\", \"Founder/Owner\", \"Healthcare\", \"HR\", \"Legal\", \"Management\", \"Manufacturing\", \"Marketing and Advertising\", \"Operations\", \"PR and Communications\", \"Procurement\", \"Product\", \"Quality Control\", \"R&D\", \"Sales\", \"Security\", \"Supply Chain\", \"Other\"), jobTitleKeywords: object {anyOf: string[], allOf: string[], noneOf: string[]}, skills: object {anyOf: string[], allOf: string[], noneOf: string[]}, allJobDescriptions: object {anyOf: string[], allOf: string[], noneOf: string[]}, currentJobDescription: object {anyOf: string[], allOf: string[], noneOf: string[]}, profileDescription: object {anyOf: string[], allOf: string[], noneOf: string[]}, includePeopleIds: string[], includeLinkedinHandles: string[], excludePeopleIds: string[], excludeLinkedinHandles: string[], fieldsExist: string[], fieldsNotExist: string[], changedPositionAfter: string (YYYY-MM-DD), changedPositionBefore: string (YYYY-MM-DD), updatedWithinMonths: integer"},"companiesFilters":{"type":"object","description":"Company filters to scope people search. Fields: lookalikeDomains: string[], includeDomains: string[], excludeDomains: string[], companySizes: string[] (enum: \"0-1\", \"2-10\", \"11-50\", \"51-200\", \"201-500\", \"501-1000\", \"1001-5000\", \"5001-10000\", \"10001-50000\", \"50001-100000\", \"100001-500000\", \"500000+\"), revenues: string[] (enum: \"0-1M\", \"1-10M\", \"10-50M\", \"50-100M\", \"100-500M\", \"500-1000M\", \">1000M\"), primaryLocations: object {includeCountries: string[], excludeCountries: string[], includeRegions: object[], excludeRegions: object[], includeCities: object[], excludeCities: object[], geolocation: object {latitude: number, longitude: number, radius: integer}}, otherLocations: object (same as primaryLocations), industries: object {industries: string[], mode: string (\"anyOf\"|\"allOf\")}, industryCategories: object {industryCategories: string[], mode: string}, technologies: object {apps: object {anyOf: string[], allOf: string[], noneOf: string[]}, categories: object {anyOf: string[], allOf: string[], noneOf: string[]}}, keywords: object {anyOf: string[], allOf: string[], noneOf: string[]}, yearFounded: object {from: integer, to: integer}, employeeCountOcean: object {from: integer, to: integer}, employeeCountLinkedin: object {from: integer, to: integer}, ecommerce: boolean, headcountGrowth: object {asPercentage: boolean, growthRange: object {from: number, to: number}, months: string (\"Three months\"|\"Six months\"|\"Twelve months\")}, fundingRound: object {types: string[], raised: object {from: integer, to: integer}, date: object {from: string, to: string}}, updatedWithinMonths: integer, minRelevance: string, maxRelevance: string"},"peoplePerCompany":{"type":"integer","description":"Number of people to return per company. If unset, returns all matching people."},"jobTitleThreshold":{"type":"number","description":"Job title similarity threshold (0-1). Controls how strictly job titles are matched."}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"1","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":"$1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Io0iMALD3qoXuTocvcBQr","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"1","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search and filter professional person profiles by job title, seniority, department, skills, location, and company attributes, returning enriched person records with pagination support.","exampleAgentPrompt":"Find me up to 100 Director or VP-level people in the Engineering or Product departments based in the United States, with skills in machine learning — include their LinkedIn URLs, emails, and current job titles.","exampleUseCases":[{"title":"B2B sales lead prospecting","prompt":"Find me up to 200 C-Level and VP people working in Sales or Marketing departments at companies in the UK, and return their LinkedIn URLs, email addresses, and current job titles so I can build a prospect list."},{"title":"Talent sourcing for recruiters","prompt":"Search for Manager and Director-level people in the Engineering department who have Python and Kubernetes skills, located in California or New York — give me up to 50 results including their name, LinkedIn URL, and work experience."},{"title":"Market research on startup founders","prompt":"Find up to 500 Founder or Owner-level people in the US working in the healthcare industry — I want their names, locations, LinkedIn profiles, and current job descriptions for a market research report."}],"resultDescription":"Returns a paginated list of enriched person profiles matching the filters. Each profile can include: id, name, firstName, lastName, LinkedIn URL, email address, job title, department, seniority, location (country, state, city), skills, work experiences (with company domain, dates, and descriptions), photo URL, and a summary. A searchAfter cursor is returned to retrieve the next page of results.","failureModes":["Invalid filter values (e.g. unsupported seniority or department enum strings) return a validation error","Exceeding the size limit of 10,000 returns an error","Invalid or expired searchAfter pagination cursor returns an error or empty results","Missing or invalid x402 payment header causes a 402 Payment Required response","Overly restrictive filter combinations may return zero results","Requested fields not in the allowed field list may be rejected"],"whenToPreferThis":"Use this endpoint when you need to search a large database of professional profiles with granular filters (seniority, department, skills, location, company) and require paginated, enriched results including LinkedIn URLs and email addresses. Prefer this over generic web-scraping approaches when you need structured, up-to-date B2B people data at scale (up to 10,000 results per query) for sales prospecting, recruiting, or market research.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:57:49.235Z","isFirstParty":false}