Search People

Nested-filter alternative to /discover/people with a paginated cursor envelope.

Endpoint

POST /api/v1/search/people

Authentication

All requests require the X-Satellyte-API-Key header. See Quickstart.

Request body

Field	Type	Required	Notes
`titles`	string[]	No	Flat compatibility field.
`industry`	string	No	Flat compatibility field.
`location`	string	No	Flat compatibility field.
`company_size`	string	No	Flat compatibility field.
`people`	object	No	Nested people filters.
`company`	object	No	Nested company filters.
`max_results`	number	No	1 to 100. Defaults to 100.
`cursor`	string	No	Pagination cursor.

Nested object schemas:

Field	Type	Notes
`people.job_title.include`	string[]	Titles to match.
`people.job_function`	string[]	Functions (Sales, Marketing).
`people.job_level`	string[]	Levels (CXO, VP).
`people.location.country_code`	string[]	ISO codes or `WORLD`.
`company.industry.include`	string[]	Industries the person's company must match.

cURL

curl -i -X POST "https://api-staging.satellyte.ai/api/v1/search/people" \
  -H "X-Satellyte-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "people": { "job_title": { "include": ["CEO"] } },
    "company": { "industry": { "include": ["banking"] } },
    "max_results": 3
  }'

Response (200)

{
  "data": {
    "items": [
      {
        "id": "https://www.linkedin.com/in/thomas-kurian-469b6219",
        "name": "Thomas Kurian",
        "title": "CEO - Google Cloud",
        "company": "Google",
        "linkedin_url": "https://www.linkedin.com/in/thomas-kurian-469b6219",
        "location": "Atherton, CA, US",
        "score": null
      }
    ],
    "pagination": { "cursor": null, "next_cursor": null, "has_more": false }
  }
}

Response fields

Field	Type	Notes
`items[]`	object[]	Same shape as `/discover/people` items.
`pagination.*`	various	Cursor pagination.