Lookalike people search (RC)

Search people using filters and/or people Ids **Cost calculation:** - Request that contains one or more lookalike people or one or more lookalike companies - 3 credits per person in result - Request that does not contain lookalike people and does not include lookalike companies - 1 credit per person in result

Request Body

application/jsonRequired

sizeMaximum number of results

Number of people to return. The maximum value is 10,000.

Default: 50Minimum: 1Maximum: 10000

peopleFiltersPeople filters

Collection of filters to be applied to the search

companiesFiltersCompanies filters

Collection of companies filters, the search results will display people that are associated with those companies

peoplePerCompanyPeople per company

Number of people to return per company. If you want to return all people from a company, don't set this value.

jobTitleThresholdJob title threshold

Threshold for job title similarity. The value must be between 0 and 1. Default is 0.8

Default: 0.8

searchAfterSearch after

Use searchAfter returned by the previous request to get the next page.

Query Parameters

apiTokenRequiredApitoken

curl -X POST "https://api.ocean.io/v3/search/people?apiToken=string" \
  -H "Content-Type: application/json" \
  -d '{
    "size": 10,
    "peopleFilters": {
      "lookalikePeopleIds": [
        "michael-scott-13532",
        "dwight-schrute"
      ],
      "lookalikeLinkedinHandles": [
        "michael-scott-13532",
        "dwight-schrute"
      ],
      "countries": [
        "us",
        "dk"
      ],
      "includePeopleIds": [
        "43g19df9c1d70f9a",
        "54hb1b1bfb1ffc5t"
      ],
      "includeLinkedinHandles": [
        "jim-halpert-5343",
        "toby-67832"
      ],
      "excludePeopleIds": [
        "43g19df9c1d70f9a",
        "54hb1b1bfb1ffc5t"
      ],
      "excludeLinkedinHandles": [
        "jim-halpert-5343",
        "toby-67832"
      ],
      "seniorities": [
        "Founder",
        "Owner"
      ],
      "jobTitleKeywords": {
        "allOf": [
          "Manager"
        ],
        "anyOf": [
          "Marketing",
          "designer"
        ],
        "noneOf": [
          "content"
        ]
      },
      "regions": [
        "CA",
        "TX"
      ],
      "states": [
        {
          "abbreviation": "NY",
          "country": "us"
        },
        {
          "abbreviation": "ENG",
          "country": "gb"
        },
        {
          "abbreviation": "5",
          "country": "at"
        },
        {
          "abbreviation": "SH",
          "country": "de"
        }
      ]
    },
    "companiesFilters": {
      "lookalikeDomains": [
        "best-customer.com",
        "ideal-lead.com"
      ],
      "includeDomains": [
        "interesting.com",
        "potential-lead.io"
      ],
      "industries": {
        "industries": [
          "Advertising Platforms",
          "Biopharma"
        ],
        "mode": "anyOf"
      },
      "excludeDomains": [
        "waste-of-time.co.uk",
        "useless.com"
      ],
      "primaryCountries": [
        "de"
      ],
      "companySizes": [
        "2-10",
        "51-200",
        "100001-500000"
      ]
    },
    "peoplePerCompany": 3,
    "jobTitleThreshold": 0.8,
    "searchAfter": "NoBgdA7BAsBMEgGwBoAEAiADgGwK4HN8BTAJwC8wBjAewFt0BdIA"
  }'

Successful 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",
      "summary": "Some text that the person wrote to describe themselves",
      "phone": {
        "numbers": [
          "+4512345678",
          "+33 6 00 00 00 00"
        ],
        "status": "verified"
      },
      "email": {
        "address": "example.jonas@ocean.io",
        "status": "verified"
      },
      "company": {
        "companySize": "2-10",
        "logo": "https://cdn2.ocean.io/companies-logos-v1/domain.com/020539e284d9318e805301b672ad23047c30818a.png",
        "name": "Dunder Mifflin Paper Company"
      }
    }
  ],
  "detail": "OK",
  "lookalikePeopleStatuses": {
    "successfulPeople": [
      "person_id_1",
      "person_id_2"
    ],
    "notFoundPeople": [
      "person_id_1",
      "person_id_2"
    ],
    "triggeredDomainPeople": [
      "person_id_1",
      "person_id_2"
    ],
    "missingCompanyInformationPeople": [
      "person_id_1",
      "person_id_2"
    ]
  },
  "total": 32871,
  "searchAfter": "NoBgdA7BAsBMEgGwBoAEAiADgGwK4HN8BTAJwC8wBjAewFt0BdIA"
}

Lookalike people search (RC)

Request Body

Query Parameters

Response

TypeScript