Lookalike people search

Webhook result: Email results Phone results

Example use case: Find VP-level Sales leaders at US SaaS companies with 200–1000 employees who changed jobs in the last 90 days.

Quickstart#

curl -X POST "https://api.ocean.io/v3/search/people" \
  -H "X-Api-Token: YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "peopleFilters": {
      "seniorities": ["VP", "C-Level"],
      "departments": ["Sales"]
    },
    "companiesFilters": {
      "primaryLocations": { "includeCountries": ["us"] },
      "companySizes": ["201-500", "501-1000"],
      "industries": { "industries": ["SaaS"] }
    },
    "size": 10
  }'

import requests

response = requests.post(
    'https://api.ocean.io/v3/search/people',
    headers={'X-Api-Token': 'YOUR_API_TOKEN'},
    json={
        'peopleFilters': {
            'seniorities': ['VP', 'C-Level'],
            'departments': ['Sales'],
        },
        'companiesFilters': {
            'primaryLocations': {'includeCountries': ['us']},
            'companySizes': ['201-500', '501-1000'],
            'industries': {'industries': ['SaaS']},
        },
        'size': 10,
    },
)
data = response.json()

const response = await fetch('https://api.ocean.io/v3/search/people', {
  method: 'POST',
  headers: { 'X-Api-Token': 'YOUR_API_TOKEN', 'Content-Type': 'application/json' },
  body: JSON.stringify({
    peopleFilters: {
      seniorities: ['VP', 'C-Level'],
      departments: ['Sales'],
    },
    companiesFilters: {
      primaryLocations: { includeCountries: ['us'] },
      companySizes: ['201-500', '501-1000'],
      industries: { industries: ['SaaS'] },
    },
    size: 10,
  }),
});
const data = await response.json();

Example response:

{
  "people": [
    {
      "id": "abc123",
      "name": "Jane Doe",
      "jobTitle": "VP of Sales",
      "seniorities": ["VP"],
      "departments": ["Sales"],
      "domain": "example.com",
      "country": "us",
      "linkedinUrl": "https://linkedin.com/in/jane-doe-123"
    }
  ],
  "searchAfter": ["abc123"],
  "total": 3210
}

Store the id field from each result — you'll need it to reveal emails or enrich the person.

Use searchAfter to paginate. See Pagination for details.