News Events

Recent news events for one company domain.

Endpoint

GET /api/v1/signals/news-events

Authentication

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

Query parameters

Field	Type	Required	Notes
`company_domain`	string	Yes	Company domain.
`found_at_from`	string	No	Lower bound for event found date.
`found_at_until`	string	No	Upper bound for event found date.
`page`	number	No	Page number. Minimum `1`.
`limit`	number	No	Page size. Minimum `1`, maximum `50`.

cURL

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

Response (200)

Example response when news events exist:

{
  "data": {
    "company_domain": "stripe.com",
    "type": "news_events",
    "count": 5,
    "items": [
      {
        "id": "62d941af-f688-4833-8fb0-e11f8523eef6",
        "event_type": "news_event",
        "categories": ["integrates_with"],
        "effective_date": "2026-06-09",
        "found_at": "2026-06-09T00:00:00Z",
        "attributes": {
          "summary": "Stripe, Inc. integrated with Lloyds Bank on Jun 9th '26.",
          "confidence": 0.1854,
          "article_sentence": "Stripe's global payments infrastructure is now integrated into Lloyds' Business Account through a new suite of tools called Lloyds Accept.",
          "planning": false,
          "amount": null,
          "amount_normalized": null,
          "assets": null,
          "assets_tags": [],
          "award": null,
          "contact": null,
          "division": null,
          "event": null,
          "financing_type": null,
          "financing_type_normalized": null,
          "financing_type_tags": [],
          "headcount": null,
          "job_title": null,
          "job_title_tags": [],
          "location": null,
          "location_data": [],
          "product": null,
          "product_data": {
            "full_text": null,
            "name": null,
            "release_type": null,
            "release_version": null,
            "fuzzy_match": null
          },
          "product_tags": [],
          "recognition": null,
          "vulnerability": null
        }
      }
    ]
  }
}

Response fields

Field	Type	Notes
`company_domain`	string	Normalized company domain that was queried.
`type`	string	Always `news_events`.
`count`	number	Number of news event records returned in `items`.
`items[].id`	string	Unique news event ID.
`items[].event_type`	string	Event type, usually `news_event`.
`items[].categories`	string[]	Event categories, for example `integrates_with`, `partners_with`, `launches`, or `acquires`.
`items[].effective_date`	string \| null	Effective event date in `YYYY-MM-DD` format when available.
`items[].found_at`	string	Timestamp when the event was found.
`items[].attributes.summary`	string \| null	Short generated summary of the event.
`items[].attributes.confidence`	number \| null	Confidence score for the event extraction.
`items[].attributes.article_sentence`	string \| null	Source sentence or excerpt used for the event.
`items[].attributes.planning`	boolean \| null	Whether the event is planned or future-looking.
`items[].attributes.amount`	string \| null	Reported amount when relevant.
`items[].attributes.amount_normalized`	number \| null	Numeric amount when it can be normalized.
`items[].attributes.assets`	string \| null	Assets referenced by the event when relevant.
`items[].attributes.assets_tags`	string[]	Tags associated with detected assets.
`items[].attributes.award`	string \| null	Award name when the event is award-related.
`items[].attributes.contact`	string \| null	Contact name or value when available.
`items[].attributes.division`	string \| null	Division or business unit when available.
`items[].attributes.event`	string \| null	Event name when available.
`items[].attributes.financing_type`	string \| null	Financing type when the news item includes financing context.
`items[].attributes.financing_type_normalized`	string \| null	Normalized financing type when available.
`items[].attributes.financing_type_tags`	string[]	Financing-related tags.
`items[].attributes.headcount`	number \| null	Headcount value when detected.
`items[].attributes.job_title`	string \| null	Job title when the news item relates to hiring or appointments.
`items[].attributes.job_title_tags`	string[]	Tags associated with detected job titles.
`items[].attributes.location`	string \| null	Human-readable location when available.
`items[].attributes.location_data`	object[]	Structured location objects when available.
`items[].attributes.product`	string \| null	Product name or product text when detected.
`items[].attributes.product_data`	object	Structured product extraction data.
`items[].attributes.product_tags`	string[]	Tags associated with detected products.
`items[].attributes.recognition`	string \| null	Recognition text when the event is recognition-related.
`items[].attributes.vulnerability`	string \| null	Vulnerability name or identifier when available.

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.