Employee Finder

Paginated employee/contact search by company and title/level filters.

Endpoint

POST /api/v1/contacts/employee-finder

Authentication

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

Request body

Field	Type	Required	Notes
`company_domain`	string	Conditional	Required if `company_linkedin_url` or `linkedin_url` is absent.
`company_linkedin_url`	string	Conditional	LinkedIn company URL.
`linkedin_url`	string	Conditional	Alias for `company_linkedin_url`.
`job_titles`	string[]	No	Titles to match.
`job_functions`	string[]	No	Functions to match against title (Sales, Marketing).
`job_levels`	string[]	No	Levels to match against title (Founder, CXO, VP).
`locations`	string[]	No	Locations or ISO country codes. `WORLD` means no location restriction.
`max_results`	number	No	1 to 100. Defaults to 25.
`page`	number	No	Page number. Defaults to 1.

cURL

curl -i -X POST "https://api-staging.satellyte.ai/api/v1/contacts/employee-finder" \
  -H "X-Satellyte-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "company_domain": "openai.com",
    "company_linkedin_url": "https://www.linkedin.com/company/openai",
    "linkedin_url": "https://www.linkedin.com/company/openai",
    "job_titles": ["Founder", "CEO", "Head of Sales"],
    "job_functions": ["Sales", "Marketing"],
    "job_levels": ["Founder", "CXO", "VP"],
    "locations": ["Singapore", "United States"],
    "max_results": 10,
    "page": 1
  }'

Response (200)

{
  "data": {
    "items": [],
    "pagination": {
      "page": 1,
      "per_page": 3,
      "total": 0,
      "has_more": false,
      "next_page": null
    }
  }
}

Response fields

Field	Type	Notes
`items[]`	object[]	Same item shape as `/contacts/find`.
`pagination.page`	number	Current page.
`pagination.per_page`	number	Page size.
`pagination.total`	number	Total matched items.
`pagination.has_more`	boolean	Whether more pages exist.
`pagination.next_page`	number \| null	Send back as `page` for the next request.

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, the company identifier is missing or invalid, array filters are invalid, or pagination values are outside the supported range.
`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.