News
GET
/v2/reference/news
Retrieve the most recent news articles related to a specified ticker, along with summaries, source details, and sentiment analysis. This endpoint consolidates relevant financial news in one place, extracting associated tickers, assigning sentiment, and providing direct links to the original sources. By incorporating publisher information, article metadata, and sentiment reasoning, users can quickly gauge market sentiment, stay informed on company developments, and integrate news insights into their trading or research workflows.
Use Cases: Market sentiment analysis, investment research, automated monitoring, and portfolio strategy refinement.
Query Parameters
ticker
string
Specify a case-sensitive ticker symbol. For example, AAPL represents Apple Inc.
published_utc
string (date-time, date)
Return results published on, before, or after this date.
order
enum (string)
Order results based on the `sort` field.
limit
integer
Limit the number of results returned, default is 10 and max is 1000.
sort
enum (string)
Sort field used for ordering.
Response Attributes
count
integer
optional
The total number of results for this request.
next_url
string
optional
If present, this value can be used to fetch the next page of data.
request_id
string
optional
A request id assigned by the server.
results
array (object)
optional
An array of results containing the requested data.
amp_url
string
optional
The mobile friendly Accelerated Mobile Page (AMP) URL.
article_url
string
A link to the news article.
author
string
The article's author.
description
string
optional
A description of the article.
id
string
Unique identifier for the article.
image_url
string
optional
The article's image URL.
insights
array (object)
optional
The insights related to the article.
keywords
array (string)
optional
The keywords associated with the article (which will vary depending on
the publishing source).
published_utc
string
The UTC date and time when the article was published, formatted in RFC3339 standard (e.g. YYYY-MM-DDTHH:MM:SSZ).
publisher
object
Details the source of the news article, including the publisher's name, logo, and homepage URLs. This information helps users identify and access the original source of news content.
tickers
array (string)
The ticker symbols associated with the article.
title
string
The title of the news article.
status
string
optional
The status of this request's response.