Get News

GET/v1/news

Retrieves news items with optional filtering by security IDs, time range, publisher, type, and text query.

Query ParametersExpand Collapse

exclude_publishers: optional string

Comma-separated list of publishers to exclude (mutually exclusive with include_publishers).

from: optional string

Inclusive start timestamp. Accepts YYYY-MM-DD or RFC3339 datetime.

include_publishers: optional string

Comma-separated list of publishers to include (mutually exclusive with exclude_publishers).

instrument_ids: optional array of string

Comma-delimited OEMS instrument UUIDs to filter by.

news_type: optional "NEWS" or "PRESS_RELEASE"

Filter by news type.

One of the following:

"NEWS"

"PRESS_RELEASE"

page_size: optional number

The number of items to return per page. Only used when page_token is not provided.

formatint64

maximum1000

minimum1

page_token: optional string

Token for retrieving the next or previous page of results. Contains encoded pagination state; when provided, page_size is ignored.

formatbyte

search_query: optional string

Free-text query matched against title/text and associated security IDs.

sectors: optional array of "BASIC_MATERIALS" or "COMMUNICATION_SERVICES" or "CONSUMER_CYCLICAL" or 8 more

Comma-separated sector values to filter by.

One of the following:

"BASIC_MATERIALS"

"COMMUNICATION_SERVICES"

"CONSUMER_CYCLICAL"

"CONSUMER_DEFENSIVE"

"ENERGY"

"FINANCIAL_SERVICES"

"HEALTHCARE"

"INDUSTRIALS"

"REAL_ESTATE"

"TECHNOLOGY"

"UTILITIES"

to: optional string

Inclusive end timestamp. Accepts YYYY-MM-DD or RFC3339 datetime.

ReturnsExpand Collapse

data: NewsItemList { instruments, news_type, published_at, 6 more }

instruments: array of NewsInstrument { instrument_id, name, symbol }

Instruments associated with this news item.

instrument_id: string

OEMS instrument UUID.

formatuuid

name: optional string

Instrument name/description, if available from instrument cache enrichment.

symbol: optional string

Trading symbol, if available from instrument cache enrichment.

news_type: NewsType

Classification of the item.

One of the following:

"NEWS"

"PRESS_RELEASE"

published_at: string

The published date/time of the article in UTC.

formatdate-time

publisher: string

The publisher or newswire source.

title: string

The headline/title of the article.

url: string

Canonical URL to the full article.

image_url: optional string

URL of an associated image if provided by the source.

site: optional string

The primary domain/site of the publisher.

text: optional string

The full or excerpted article body.

Get News

curl https://api.clearstreet.com/v1/news \
    -H "Authorization: Bearer $API_KEY"

{
  "data": [
    {
      "instruments": [
        {
          "instrument_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
          "name": "Apple Inc.",
          "symbol": "AAPL"
        }
      ],
      "news_type": "NEWS",
      "published_at": "2025-10-31T14:30:00.000000000Z",
      "publisher": "Reuters",
      "site": "reuters.com",
      "title": "Apple announces new hardware lineup",
      "url": "https://example.com/news/1"
    }
  ],
  "error": null,
  "metadata": {
    "next_page_token": "cGFnZT0yJmxhc3Rfc3ltYm9sPVRTM0E",
    "page_number": 1,
    "request_id": "0f1a2b3c-4d5e-6f78-9012-3a4b5c6d7e8f",
    "total_items": 25,
    "total_pages": 3
  }
}

{
  "error": {
    "code": 400,
    "message": "Failed to deserialize query string: from: invalid date or datetime '123': expected YYYY-MM-DD or RFC3339 (e.g. 2025-01-30T14:30:00Z)"
  },
  "metadata": {
    "request_id": "d706b33d-ef0c-484d-a5e5-2f8b68ecb203"
  }
}

Returns Examples

{
  "data": [
    {
      "instruments": [
        {
          "instrument_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
          "name": "Apple Inc.",
          "symbol": "AAPL"
        }
      ],
      "news_type": "NEWS",
      "published_at": "2025-10-31T14:30:00.000000000Z",
      "publisher": "Reuters",
      "site": "reuters.com",
      "title": "Apple announces new hardware lineup",
      "url": "https://example.com/news/1"
    }
  ],
  "error": null,
  "metadata": {
    "next_page_token": "cGFnZT0yJmxhc3Rfc3ltYm9sPVRTM0E",
    "page_number": 1,
    "request_id": "0f1a2b3c-4d5e-6f78-9012-3a4b5c6d7e8f",
    "total_items": 25,
    "total_pages": 3
  }
}

{
  "error": {
    "code": 400,
    "message": "Failed to deserialize query string: from: invalid date or datetime '123': expected YYYY-MM-DD or RFC3339 (e.g. 2025-01-30T14:30:00Z)"
  },
  "metadata": {
    "request_id": "d706b33d-ef0c-484d-a5e5-2f8b68ecb203"
  }
}