Historical News #
Access 6+ years of historical stock market and crypto news through a REST API.
Get News #
GET /v1beta1/news
Returns latest news articles across stocks and crypto. By default returns latest 10 news articles.
Parameters #
Query Parameters #
Attribute | Type | Requirement | Notes |
---|---|---|---|
symbols |
string | Optional |
List of symbols to obtain news |
start |
timestamp (RFC 3339) | Optional |
(Default: 01-01-2015) Start date to obtain news |
end |
timestamp (RFC 3339) | Optional |
(Default: now) End date to obtain news |
limit |
string | Optional |
(Default: 10, Max: 50) Limit of news items to be returned for given page |
sort |
string | Optional |
(Default: DESC ) Sort articles by updated date. Options: DESC , ASC |
include_content |
boolean | Optional |
(Default: false) Boolean whether to include content for news articles |
exclude_contentless |
boolean | Optional |
(Default: false) Exclude news articles that do not contain content (just headline and summary) |
page_token |
string | Optional |
Pagination token to continue to next page |
Request #
Example request #
curl --location --request GET 'https://data.alpaca.markets/v1beta1/news?start=2021-12-28T00:00:00Z&end=2021-12-31T11:59:59Z&symbols=AAPL,TSLA' \
--header 'Apca-Api-Key-Id: <KEY>' \
--header 'Apca-Api-Secret-Key: <SECRET>'
Response #
A list news objects.
Example response #
{
"news": [
{
"id": 24843171,
"headline": "Apple Leader in Phone Sales in China for Second Straight Month in November With 23.6% Share, According to Market Research Data",
"author": "Charles Gross",
"created_at": "2021-12-31T11:08:42Z",
"updated_at": "2021-12-31T11:08:43Z",
"summary": "",
"url": "https://www.benzinga.com/news/21/12/24843171/apple-leader-in-phone-sales-in-china-for-second-straight-month-in-november-with-23-6-share-according",
"images": [],
"symbols": [
"AAPL"
],
"source": "benzinga"
}
],
"next_page_token": "MTY0MDk0ODkyMzAwMDAwMDAwMHwyNDg0MzE3MQ=="
}
Errors #
403 - Forbidden
Unauthorized
422 - Bad Request
Unprocessable Entity
429 - Too many requests
Rate limit exceeded
News Model #
Example news object #
{
"id": 24803233,
"headline": "Benzinga's Top 5 Articles For 2021 — Or 'Who Let The Dog Out?'",
"author": "Sue Strachan",
"created_at": "2021-12-29T15:11:03Z",
"updated_at": "2021-12-30T20:37:41Z",
"summary": "2021 may have been the Year of the Ox in the Chinese calendar, but for Benzinga, it was the Year of the Dog, or should we say, Year of the Dogecoin (CRYPTO: DOGE).",
"content": "<p>2021 may have been the Year of the Ox in the Chinese calendar, but for Benzinga, it was the Year of the Dog, or should we say, Year of the <strong>Dogecoin</strong> (CRYPTO: <a class=\"ticker\" href=\"https://www.benzinga.com/quote/doge/usd\">DOGE</a>).</p>\r\n\r\n<p>The memecoin created in 2013....",
"images": [
{
"size": "large",
"url": "https://cdn.benzinga.com/files/imagecache/2048x1536xUP/images/story/2012/doge_12.jpg"
},
{
"size": "small",
"url": "https://cdn.benzinga.com/files/imagecache/1024x768xUP/images/story/2012/doge_12.jpg"
},
{
"size": "thumb",
"url": "https://cdn.benzinga.com/files/imagecache/250x187xUP/images/story/2012/doge_12.jpg"
}
],
"symbols": [
"AMZN",
"BTCUSD",
"COIN",
"DOGEUSD",
"SPCE",
"TSLA",
"TWTR"
],
"source": "benzinga"
}
Properties #
Attribute | Type | Notes |
---|---|---|
headline |
string | Headline or title of the article |
created_at |
string (RFC 3339) | Date article was created |
updated_at |
string (RFC 3339) | Date article was updated |
author |
string | Original author of news article |
summary |
string | Summary text for the article (may be first sentence of content) |
content |
string | Content of the news article (might contain HTML) |
images |
object | List of images (URLs) related to given article (may be empty) |
url |
string | URL of article (if applicable) |
symbols |
string[] | List of related or mentioned symbols |
source |
string | Source where the news originated from (e.g. Benzinga) |
id |
int | News article ID |
If object contains images, this will be an object of three items with the size
of the image and a URL. Possible values for size
are thumb
, small
and large
.