Get News
Retrieves news items with optional filtering by security IDs, time range, publisher, type, and text query.
Pagination metadata does not include total_items or total_pages for this endpoint. Use next_page_token to detect whether more results exist.
Request
- Base URLhttps://api.clearstreet.com
- AuthHTTP bearer
Query parameters
The number of items to return per page. Only used when page_token is not provided.
Base64URL-encoded pagination token
Token for retrieving the next or previous page of results. Contains encoded pagination state; when provided, page_size is ignored.
Inclusive start timestamp. Accepts YYYY-MM-DD or RFC3339 datetime.
Inclusive end timestamp. Accepts YYYY-MM-DD or RFC3339 datetime.
Comma-separated list of publishers to include (mutually exclusive with exclude_publishers).
Comma-separated list of publishers to exclude (mutually exclusive with include_publishers).
News item classification.
Filter by news type.
Free-text query matched against title/text and associated security IDs.
Comma-delimited instrument identifiers to filter by.
Comma-separated sector values to filter by.
Response
News items
Example response
{
"error": {
"code": 400,
"message": "Order quantity must be greater than zero"
},
"metadata": {
"page_number": 1,
"total_items": 42,
"total_pages": 5
},
"data": [
{
"image_url": "https://images.financialmodelingprep.com/news/apple-reports-first-quarter-results-20250130.jpg",
"instruments": [
{
"instrument_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
"name": "Apple Inc.",
"symbol": "AAPL"
}
],
"news_type": "NEWS",
"published_at": "2025-01-30T16:30:00.000000000Z",
"publisher": "Business Wire",
"site": "businesswire.com",
"text": "CUPERTINO, Calif.--(BUSINESS WIRE)--Apple today announced financial results...",
"title": "Apple reports first quarter results",
"url": "https://www.businesswire.com/news/home/20250130261281/en/Apple-reports-first-quarter-results/"
}
]
}Changes
No recorded changes to this operation across all 62 revisions of this API.