Discover Companies

Find companies that match a simple set of filters. Use this for ICP-driven account list building.

Endpoint

POST /api/v1/discover/companies

Authentication

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

Request body

Field	Type	Required	Notes
`industry`	string	No	Industry filter. Lowercase aliases are normalized (see table below).
`employee_size`	string	No	Company size range, for example `51-200`. Allowed values from `/meta/field-values.employee_ranges`.
`location`	string	No	HQ filter. Country names or ISO codes; `WORLD` for any country.
`revenue`	string	No	Accepted in contract; coverage varies.
`keywords`	string[]	No	Keyword include filter.
`max_results`	number	No	1 to 100. Defaults to 100.

At least one of industry, employee_size, location, revenue, or keywords must be provided. A request without any filter returns 400 validation_error with message "Provide at least one discovery filter.".

Industry alias normalization

You send	Provider value
`banking`	`Banking`
`saas` / `software`	`Software Development`
`fintech` / `finance`	`Financial Services`
`insurance`	`Insurance`
`consulting`	`Business Consulting and Services`
`retail`	`Retail`
`manufacturing`	`Manufacturing`
`healthcare`	`Hospitals and Health Care`
`education`	`Education`
`real_estate` / `real estate`	`Real Estate`

cURL

curl -i -X POST "https://api-staging.satellyte.ai/api/v1/discover/companies" \
  -H "X-Satellyte-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "industry": "Banking",
    "employee_size": "51-200",
    "location": "Singapore",
    "revenue": "$10M-$50M",
    "keywords": ["fintech", "payments", "compliance"],
    "max_results": 3
  }'

Response (200)

{
  "data": [
    {
      "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
    },
    {
      "id": "https://www.linkedin.com/company/state-bank-of-india",
      "name": "State Bank Of India",
      "domain": "bank.sbi",
      "website": "https://bank.sbi",
      "industry": "Banking",
      "location": "Mumbai, Maharashtra, India",
      "employee_size": null,
      "employee_count": null
    }
  ]
}

Response fields

Field	Type	Notes
`id`	string	Opaque company identifier. Often a LinkedIn URL.
`name`	string	Company display name.
`domain`	string	Primary domain.
`website`	string	Marketing site URL.
`industry`	string	Canonical industry label.
`location`	string \| null	HQ location, when known.
`employee_size`	string \| null	Size bucket, when known.
`employee_count`	number \| null	Exact headcount, when known.

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 company 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.