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",
    "job_titles": ["Founder", "CEO", "Head of Sales"],
    "locations": ["SG"],
    "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.