News

Parameters#

instrument_idsstringoptional · query

Filter by stable instrument IDs. IDs and symbols may not be combined.

symbolsstringoptional · query

Convenience lookup for exchange-listed instruments as MIC:TICKER or a bare ticker, which resolves to the exchange listing that ticker; resolves at symbol_at. The MIC and the ticker are case-insensitive, and two spellings of one listing (AAPL and XNAS:AAPL) count as a repeated value. A bare ticker that names no listing as written is also read in the common vendor spellings: with an exchange suffix (RY.TO, SHEL.L, VOD.LSE, BHP.AX), ^GSPC for INDEX:GSPC, and EURUSD=X or EURUSD for FOREX:EUR-USD. A ticker may contain a space (BAC PRL) but not start or end with one. A request in which no symbol resolves returns 404 symbol-not-resolved; otherwise each symbol that does not resolve, or resolves to a listing with no rows for the request (no-data), is an entry of meta.errors. IDs and symbols may not be combined.

symbol_atstringoptional · query

Resolve symbols as they were assigned at the end of this UTC date (YYYY-MM-DD); defaults to as_of. Only listings the security master holds resolve: it was built in September 2026 and records delistings from then on, so most issuers delisted earlier, such as TWTR or SIVB, resolve at no date. Only valid with symbols.

fromstringoptional · query

First UTC date (YYYY-MM-DD, inclusive) of published_at.

tostringoptional · query

Last UTC date (YYYY-MM-DD, inclusive) of published_at; on or after from.

qstringoptional · query

Indexed word-prefix search across title and summary: 1 to 10 whitespace-separated words of at least 3 letters or digits each, at most 256 characters in all. Punctuation, shorter words and more than 10 words return 422. Every word must match. No provider query language.

topicsstringoptional · query

Topics, matched exactly and case-sensitively against each article's topics, which are the publisher's own tags (an open set, such as earnings). Each is 1 to 100 characters without leading or trailing whitespace; anything else returns 422.

languagesstringoptional · query

Article languages as ISO 639-1 two-letter codes, such as en; case-insensitive. und selects articles whose language was not determined, which is most articles published before early July 2026, so add it to include them (languages=en,und). A value that is not an ISO 639-1 code or und returns 422.

as_ofstringoptional · query

Knowledge cutoff as a UTC date (YYYY-MM-DD): the response reflects what was known by the end of that day. Defaults to now; cannot be in the future. A date from before the dataset's knowledge history returns 422 point-in-time-unavailable naming the earliest one, which GET /v1/datasets lists as earliest_as_of.

known_fromstringoptional · query

First UTC date (YYYY-MM-DD, inclusive) on which a revision became known.

known_tostringoptional · query

Last UTC date (YYYY-MM-DD, inclusive) on which a revision became known; on or after known_from.

orderstringoptional · query

Direction on published_at; ties use ID ascending.

ascdesc

Default: desc

limitintegeroptional · query

Maximum records per page.Default: 100

cursorstringoptional · query

Opaque cursor, expires after one hour; binds filters, order, resolved as_of, account/key and entitlement. Repeat the original query unchanged.

formatstringoptional · query

Response format. csv returns the data rows with a header row, for spreadsheet functions such as IMPORTDATA; nested fields become dotted columns and lists one JSON array cell, the next page cursor is returned in X-Next-Cursor and meta.errors in X-Meta-Errors. A result without rows is the header row alone, listing the documented fields of a row. Default json, or csv when format is omitted and the Accept header ranks text/csv above JSON; a format the Accept header does not admit returns 406 not-acceptable.

jsoncsv

Response fields#

Returns data as an array of records. All example values are illustrative.

idstring

Record identifier, stable across revisions.

titlestring

Headline.

summarystring · null

Summary the source supplies and licenses for republication: an official publisher's feed description, or the teaser a paywalled article arrived as (is_paywalled). Null otherwise, including articles delivered with their full text; no summary is generated.

contentstring · null

Licensed article text. Null when unavailable under the source agreement, when the source delivered a paywall notice or teaser instead (is_paywalled), and for articles published more than 90 days ago except each instrument's ten newest.

is_paywalledboolean

True when the source delivered a subscription notice or a teaser ("Continue Reading") in place of the article text; content is then null and the teaser, if any, is in summary.

urlstring

Link to the full article on the publisher's site.

publisherobject

Outlet that published the article.

published_atstring

published at

updated_atstring · null

Instant the publisher last updated the article. The connected sources do not report it: always null.

languagestring

BCP 47 primary language subtag: the feed's declared language, else detected from the headline and text (English, German, French, Spanish, Italian, Portuguese or Dutch). und when it cannot be determined: short or mixed text, another language, and articles published before early July 2026, whose text was no longer held when detection began. Over 99% of articles with a determined language are English.

authorsarray

Author names. The connected sources do not report them: always empty.

topicsarray

topics

instrumentsarray

Listings the article is tagged to, among the markets OHLC covers. Empty for general market and macro news and for articles about companies listed only elsewhere (about one article in ten).

sentimentobject

sentiment

Response metadata#

Responses include meta.timezone. Dataset responses include next_cursor; health and exports have their own metadata. Request tracing uses the X-Request-ID header.

When something goes wrong#

An empty data: [] is a successful query with no matching records. Invalid symbols, permissions and malformed parameters produce an RFC 9457 problem with an actionable detail.

Plans#

Requires news.read. Access, recency and history depth come from the plan definitions the API enforces.

History is how far back a plan may request. How far records actually go for a symbol is history_from in dataset coverage. Nothing is real-time. Compare plans