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

apiTokenApitoken

Header Parameters

x-api-tokenX-Api-Token

curl -X POST "https://api.ocean.io/v3/search/people?apiToken=string" \
  -H "x-api-token: string" \
  -H "Content-Type: application/json" \
  -d '{
    "size": 10,
    "peopleFilters": {
      "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"
        ]
      },
      "allJobDescriptions": {
        "allOf": [
          "software engineer"
        ],
        "anyOf": [
          "software engineer"
        ],
        "noneOf": [
          "entry-level"
        ]
      },
      "currentJobDescription": {
        "allOf": [
          "software engineer",
          "big tech company"
        ],
        "anyOf": [
          "software engineer"
        ],
        "noneOf": [
          "entry-level"
        ]
      },
      "profileDescription": {
        "allOf": [
          "software engineer"
        ],
        "anyOf": [
          "software engineer"
        ],
        "noneOf": [
          "entry-level"
        ]
      },
      "regions": [
        "CA",
        "TX"
      ],
      "states": [
        {
          "abbreviation": "NY",
          "country": "us"
        },
        {
          "abbreviation": "ENG",
          "country": "gb"
        },
        {
          "abbreviation": "5",
          "country": "at"
        },
        {
          "abbreviation": "SH",
          "country": "de"
        }
      ],
      "cities": [
        {
          "city": "New York",
          "country": "us"
        },
        {
          "city": "Los Angeles",
          "country": "us"
        }
      ],
      "names": [
        "John Doe",
        "Peter Pan"
      ],
      "departments": [
        "Management",
        "Marketing and Advertising"
      ],
      "fieldsExist": [
        "name",
        "country",
        "linkedinUrl"
      ],
      "fieldsNotExist": [
        "firstName",
        "location",
        "jobTitleEnglish"
      ],
      "changedPositionAfter": "2023-01"
    },
    "companiesFilters": {
      "lookalikeDomains": [
        "bestcustomer.com",
        "idealcustomer.com"
      ],
      "includeDomains": [
        "interesting.com",
        "amazing.com"
      ],
      "excludeDomains": [
        "boring.com",
        "useless.com"
      ],
      "companySizes": [
        "2-10",
        "51-200",
        "100001-500000"
      ],
      "ecommerce": true,
      "yearFounded": {
        "from": 1960,
        "to": 1990
      },
      "countriesCount": {
        "from": 1,
        "to": 5
      },
      "revenues": [
        "0-1M",
        "1-10M",
        ">1000M"
      ],
      "employeeCountOcean": {
        "from": 10,
        "to": 100
      },
      "mobileApps": {
        "from": 1,
        "to": 5
      },
      "locationsCount": {
        "from": 5,
        "to": 10
      },
      "departmentSizes": [
        {
          "department": "Accounting and Finance",
          "from": 5,
          "to": 10
        }
      ],
      "employeeCountLinkedin": {
        "from": 50,
        "to": 100
      },
      "industries": {
        "industries": [
          "Advertising Platforms",
          "Biopharma"
        ],
        "mode": "anyOf"
      },
      "excludeIndustries": [
        "CRM",
        "B2B"
      ],
      "industryCategories": {
        "industryCategories": [
          "Real Estate",
          "Hardware"
        ],
        "mode": "anyOf"
      },
      "excludeIndustryCategories": [
        "Information Technology",
        "Privacy and Security"
      ],
      "linkedinIndustries": [
        "Management Consulting",
        "Computer Software"
      ],
      "excludeLinkedinIndustries": [
        "Management Consulting",
        "Computer Software"
      ],
      "fundingRound": {
        "date": {
          "from": "2020-01-01",
          "to": "2023-01-01"
        },
        "raised": {
          "from": 1000000,
          "to": 5000000
        },
        "types": [
          "Seed",
          "Series A"
        ]
      },
      "primaryLocations": {
        "includeCountries": [
          "es",
          "pt"
        ],
        "excludeCountries": [
          "br",
          "de"
        ],
        "includeRegions": [
          {
            "abbreviation": "CA",
            "country": "us"
          },
          {
            "abbreviation": "YT",
            "country": "ca"
          }
        ],
        "excludeRegions": [
          {
            "abbreviation": "CA",
            "country": "us"
          },
          {
            "abbreviation": "YT",
            "country": "ca"
          }
        ],
        "includeCities": [
          {
            "city": "New York",
            "country": "us"
          },
          {
            "city": "Los Angeles",
            "country": "us"
          }
        ],
        "excludeCities": [
          {
            "city": "New York",
            "country": "us"
          },
          {
            "city": "Los Angeles",
            "country": "us"
          }
        ],
        "geolocation": {
          "latitude": 38.880817,
          "longitude": -77.10216,
          "radius": 1000
        }
      },
      "otherLocations": {
        "includeCountries": [
          "es",
          "pt"
        ],
        "excludeCountries": [
          "br",
          "de"
        ],
        "includeRegions": [
          {
            "abbreviation": "CA",
            "country": "us"
          },
          {
            "abbreviation": "YT",
            "country": "ca"
          }
        ],
        "excludeRegions": [
          {
            "abbreviation": "CA",
            "country": "us"
          },
          {
            "abbreviation": "YT",
            "country": "ca"
          }
        ],
        "includeCities": [
          {
            "city": "New York",
            "country": "us"
          },
          {
            "city": "Los Angeles",
            "country": "us"
          }
        ],
        "excludeCities": [
          {
            "city": "New York",
            "country": "us"
          },
          {
            "city": "Los Angeles",
            "country": "us"
          }
        ],
        "geolocation": {
          "latitude": 38.880817,
          "longitude": -77.10216,
          "radius": 1000
        }
      },
      "webTraffic": {
        "views": {
          "from": 1000,
          "to": 1000000
        },
        "visits": {
          "from": 1000,
          "to": 10000
        }
      },
      "socialMedias": {
        "medias": {
          "all_of": [
            "facebook",
            "x"
          ],
          "any_of": [
            "youtube",
            "xing"
          ],
          "none_of": [
            "instagram",
            "tiktok"
          ]
        },
        "min_count": 3
      },
      "technologies": {
        "apps": {
          "all_of": [
            "Amazon Advertising",
            "Google Maps"
          ],
          "any_of": [
            "BrightEdge",
            "Nette Framework"
          ],
          "none_of": [
            "Kount",
            "Nativo"
          ]
        },
        "categories": {
          "all_of": [
            "Analytics",
            "Security"
          ],
          "any_of": [
            "Advertising",
            "WordPress themes"
          ],
          "none_of": [
            "CMS",
            "Reviews"
          ]
        }
      },
      "keywords": {
        "all_of": [
          "lead generation",
          "marketing"
        ],
        "any_of": [
          "smart prospecting",
          "data platform"
        ],
        "none_of": [
          "seo"
        ]
      }
    },
    "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",
      "currentJobDescription": "Software Engineer specializing in cloud infrastructure",
      "experiences": [
        {
          "dateFrom": "2020-01-01",
          "dateTo": "2021-01-01",
          "description": "Software Engineer specializing in cloud infrastructure",
          "domain": "domain.com",
          "jobTitle": "Software Engineer"
        }
      ],
      "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

Header Parameters

Response

TypeScript