Hiring Signals

Recent hiring signals for one company.

Endpoint

GET /api/v1/signals/hiring

Authentication

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

Query parameters

Field	Type	Required	Notes
`company_domain`	string	Conditional	Required if `linkedin_url` is absent.
`linkedin_url`	string	Conditional	Required if `company_domain` is absent.

cURL

curl -i "https://api-staging.satellyte.ai/api/v1/signals/hiring?company_domain=openai.com" \
  -H "X-Satellyte-API-Key: $API_KEY"

Response (200)

{
  "data": [
    {
      "type": "company_hiring",
      "company": "OpenAI",
      "title": "Hiring AI infrastructure engineers",
      "date": "2026-05-01T00:00:00.000Z",
      "url": "https://example.com/job",
      "detail": "Detected from lead/company signals"
    }
  ]
}

Response fields

Field	Type	Notes
`type`	string	Always `"company_hiring"` for this endpoint.
`company`	string	Company name.
`title`	string	Headline of the signal.
`date`	string	ISO timestamp.
`url`	string	Source URL.
`detail`	string	Free-form provenance description.

Empty array if no signals are known.

Error responses

All failed calls use the standard error envelope documented in Errors.

Status	Code	Notes
`400`	`validation_error`	Returned when required query parameters 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.