LinkedIn to Domain

Resolve a LinkedIn company URL to a domain.

Endpoint

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

Authentication

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

Request body

Field	Type	Required	Notes
`linkedin_url`	string	Yes	LinkedIn company URL.

cURL

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

Response (200): hit

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

Response (200): miss

{
  "data": {
    "found": false,
    "linkedin_url": "https://www.linkedin.com/company/unknown-example",
    "domain": null,
    "company": null
  }
}

Response fields

Field	Type	Notes
`found`	boolean	Whether a mapping was found.
`domain`	string \| null	Resolved company domain.
`linkedin_url`	string	Echoed input.
`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 LinkedIn URL is missing, or the LinkedIn company URL format is not valid.
`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.