Search people

Quota limitation

Results received from this endpoint count towards the people search quota

Search for people based on the provided filters.
Note that some filters only accept pre-defined values, as provided by the filters endpoint.

Looking for V1? It’s deprecated, but still available here

Authorization

AuthorizationRequiredBearer <token>

In: header

Request Body

application/jsonRequired

List of filters to use as search criteria

companiesobject

limitinteger

Limit - Is the maximum amount of results per page, must be between 1 and 200

Default: 10Minimum: 1Maximum: 200

pageTokenstring

PageToken - token to retrieve the next page of results. When provided, the filters originally used for the first page are reused and any changes to filters are ignored.

peopleobject

peoplePerCompanyinteger

PeoplePerCompany - Limits the number of people returned per company when searching by domain or name only. Valid values are between 1 and 5. For more in-depth results, search using a single domain and omit this parameter. This field is ignored if the search includes criteria beyond domain or name. todo: cleanup and add peoplePerOrgValidator validator back in when opensearch is released https://linear.app/surfe/issue/API-474/cleanupfix-searchpeoplerequestv2-field-validation

curl -X POST "https://api.surfe.com/v2/people/search" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "companies": {
      "countries": [
        "fr"
      ],
      "domains": [
        "surfe.com"
      ],
      "domainsExcluded": [
        "surfshop.fr"
      ],
      "employeeCount": {
        "from": 1,
        "to": 999999999999999
      },
      "industries": [
        "CRM",
        "Software",
        "SaaS",
        "Internet"
      ],
      "names": [
        "Surfe",
        "Leadjet"
      ],
      "revenue": {
        "from": 1,
        "to": 999999999999999
      }
    },
    "limit": 10,
    "pageToken": "",
    "people": {
      "countries": [
        "fr"
      ],
      "departments": [
        "Management"
      ],
      "jobTitles": [
        "CEO",
        "CTO"
      ],
      "seniorities": [
        "Founder",
        "C-Level"
      ]
    },
    "peoplePerCompany": 5
  }'

List of people found

{
  "nextPageToken": "string",
  "people": [
    {
      "companyDomain": "surfe.com",
      "companyName": "Surfe",
      "country": "France",
      "departments": [
        "Management",
        "Founder/Owner"
      ],
      "firstName": "David",
      "jobTitle": "Co-Founder & CEO",
      "lastName": "Chevalier",
      "linkedInUrl": "https://www.linkedin.com/in/david-maurice-chevalier/",
      "seniorities": [
        "Founder",
        "C-Level"
      ]
    }
  ],
  "total": 0
}

Search people

Authorization

Request Body

Response

TypeScript