---
title: "Get news feed"
method: POST
path: "/news"
tags: ["News"]
---

# Get news feed

`POST /news`

Retrieve a paginated feed of news items. You can filter by ISINs, news group IDs, and publication date range.

## Request body

- object
  - `lang` 'en' | 'de' — Preferred language for news content (ISO 639-1 code)
  - `isins` string[] — Filter news by specific ISINs
  - `news_group_ids` string[] — Filter news by specific news group IDs
  - `start_date` string, date-time — Only return news published on or after this date and time
  - `end_date` string, date-time — Only return news published on or before this date and time
  - `limit` integer — Maximum number of news groups to return
  - `cursor` object, nullable — Cursor for pagination, obtained from the nextCursor field of the previous response
    - `created_at` string, date-time — ISO 8601 timestamp of the last item in the previous page
    - `published_at` string, date-time — (Legacy) ISO 8601 timestamp of the last item in the previous page. Use 'created_at' instead.
    - `id` string, uuid, required — UUID of the last item in the previous page

## Response `200`

Successfully retrieved news feed

- object
  - `data` object[], required — Array of news groups
    - `group_id` string, uuid, required — Unique identifier for the news group
    - `items` object[], required — List of news items in this group
      - `id` string, uuid, required — Unique identifier for the news item
      - `headline` string, required — Title of the news article
      - `summary` string, required — Brief summary or excerpt of the news article
      - `original_lang` string, required — Original language of the news article (ISO 639-1 code)
      - `url` string, uri, required — URL to the full news article
      - `published_at` string, date-time, required — ISO 8601 timestamp when the article was published
      - `created_at` string, date-time, required — ISO 8601 timestamp when the article was created in our system
      - `group_id` string, uuid, required — UUID of the news group this item belongs to
      - `assets` object[], required — List of assets mentioned in the news article
        - `id` string, uuid, required — Unique identifier for the asset
        - `type` string, required — Type of the asset (e.g., stock, bond, etf)
        - `identifier` string, required — ISIN or other unique identifier for the asset
        - `name` string, required — Display name of the asset
      - `sentiment_score` integer, nullable, required — Sentiment score of the news article (-100 = very negative, 0 = neutral, 100 = very positive)
    - `latest_item_published_at` string, date-time, required — ISO 8601 timestamp of the most recent item in the group
    - `created_at` string, date-time, required — ISO 8601 timestamp when the news group was created in our system
  - `nextCursor` object, nullable, required — Cursor for the next page of results
    - `created_at` string, date-time — ISO 8601 timestamp of the last item in the previous page
    - `published_at` string, date-time — (Legacy) ISO 8601 timestamp of the last item in the previous page. Use 'created_at' instead.
    - `id` string, uuid, required — UUID of the last item in the previous page

## Other responses

- `401` — Unauthorized - Missing or invalid API key
- `415` — Unsupported Media Type - Content-Type must be application/json

---

[API](https://skmtc.dev/elbstream/apis/elbstream-api.md) · [All operations](https://skmtc.dev/elbstream/apis/elbstream-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/elbstream/elbstream-api/revisions/21aaa5c851aa/schema)