Search Companies

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

Endpoint

POST /api/v1/search/companies

Authentication

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

Request body

Top-level fields:

Field	Type	Required	Notes
`industry`	string	No	Flat compatibility field; same as `/discover/companies.industry`.
`employee_size`	string	No	Flat compatibility field.
`location`	string	No	Flat compatibility field.
`keywords`	string[]	No	Flat compatibility field.
`company`	object	No	Nested company filters (see below).
`max_results`	number	No	1 to 100. Defaults to 100.
`cursor`	string	No	Pagination cursor from the previous response.

Nested company object:

Field	Type	Notes
`company.industry.include`	string[]	Industries to include.
`company.industry.exclude`	string[]	Industries to exclude (best-effort).
`company.employee_range`	string[]	Size buckets.
`company.hq.country_code`	string[]	ISO codes or `WORLD`.
`company.keywords.include`	string[]	Keyword include filter.

cURL

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

Response (200)

{
  "data": {
    "items": [
      {
        "id": "https://www.linkedin.com/company/itau",
        "name": "Itaú Unibanco",
        "domain": "itau.com.br",
        "website": "https://www.itau.com.br",
        "industry": "Banking",
        "location": "Sao Paulo, Brazil",
        "employee_size": null,
        "employee_count": null
      }
    ],
    "pagination": { "cursor": null, "next_cursor": null, "has_more": false }
  }
}

Response fields

Field	Type	Notes
`items[]`	object[]	Same shape as `/discover/companies` items.
`pagination.cursor`	string \| null	The cursor that produced this page.
`pagination.next_cursor`	string \| null	Send back as `cursor` to fetch next page.
`pagination.has_more`	boolean	Whether more results exist.