Domain to LinkedIn

Resolve a company domain to a LinkedIn company URL when one is known.

Endpoint

POST /api/v1/companies/domain-to-linkedin

Authentication

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

Request body

Field	Type	Required	Notes
`domain`	string	Yes	Company domain, for example `openai.com`.

cURL

curl -i -X POST "https://api-staging.satellyte.ai/api/v1/companies/domain-to-linkedin" \
  -H "X-Satellyte-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "domain": "stripe.com" }'

Response (200): hit

{
  "data": {
    "found": true,
    "domain": "stripe.com",
    "linkedin_url": "https://www.linkedin.com/company/stripe",
    "company": null
  }
}

Response (200): miss

{
  "data": {
    "found": false,
    "domain": "unknown.example",
    "linkedin_url": null,
    "company": null
  }
}

Response fields

Field	Type	Notes
`found`	boolean	Whether a mapping was found.
`domain`	string	Echoed input.
`linkedin_url`	string \| null	Resolved LinkedIn company URL.
`company`	string \| null	Company name 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, the domain is missing, or the domain format is not valid.
`401`	`unauthorized`	Returned when `X-Satellyte-API-Key` is missing, invalid, or expired.
`404`	`not_found`	Returned when no LinkedIn company URL is known for the requested domain.
`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.