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", "Founder", "Head of Sales"],
    "industry": "Banking",
    "employee_size": "51-200",
    "location": "Singapore",
    "keywords": ["fintech", "payments", "compliance"],
    "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.

Error responses

All failed calls use the standard error envelope documented in Errors.

Status	Code	Notes
`400`	`validation_error`	Returned when the request body is invalid or the people discovery filters are missing or invalid.
`401`	`unauthorized`	Returned when `X-Satellyte-API-Key` is missing, invalid, or expired.
`404`	`not_found`	Returned when Public API access is not enabled or the requested Public API resource is unavailable.
`429`	`rate_limit_exceeded`	Returned when the API key exceeds its configured rate limit.
`500`	`service_error`	Returned when the service cannot complete the request. Retry with backoff.