Discover People

Find people that match titles, industry, location, or company size. Sourced from existing Satellyte lead data.

Endpoint

POST /api/v1/discover/people

Authentication

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

Request body

Field	Type	Required	Notes
`titles`	string[]	No	Target titles (for example `Founder`, `CEO`, `Head of Sales`).
`industry`	string	No	Industry filter; same normalization as `/discover/companies`.
`location`	string	No	Person location filter.
`company_size`	string	No	Size bucket of the person's company.
`max_results`	number	No	1 to 100. Defaults to 100.

At least one of titles, industry, location, or company_size must be provided.

cURL

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

Response (200)

{
  "data": [
    {
      "id": "https://www.linkedin.com/in/miltonmaluhyfilho",
      "name": "Milton Maluhy Filho",
      "title": "CEO do Itaú Unibanco",
      "company": "Itaú Unibanco",
      "linkedin_url": "https://www.linkedin.com/in/miltonmaluhyfilho",
      "location": "São Paulo, BR",
      "score": null
    }
  ]
}

Response fields

Field	Type	Notes
`id`	string	Opaque person identifier; often a LinkedIn URL.
`name`	string	Full name.
`title`	string \| null	Job title from profile.
`company`	string \| null	Current company name.
`linkedin_url`	string \| null	LinkedIn profile URL.
`location`	string \| null	City, region, country.
`score`	number \| null	Lead score, when available.