REST Endpoints
# News Data Endpoint
https://api.tiingo.com/tiingo/news

Just remember, you will need your token in order to connect. Keep it safe.

.

2.2 REST - News

2.2.1 Overview

Tiingo's news feeds are some of the most comprehensive news feeds available. We not only incorporate financial news sites, but also financial blogs - including those of small-time reputable bloggers, and tag them using the latest algos our team has been developing for over a decade. We bring these powerful feeds to you.

On a typical day, Tiingo adds over 8,000-12,000 articles a day.

You can find out about the full product offering on the Product - News page.

2.2 REST - News

2.2.2 News Endpoint

To request news data, use the following REST endpoints.
# For the latest news
https://api.tiingo.com/tiingo/news

# For the latest news for specific tickers
https://api.tiingo.com/tiingo/news?tickers=aapl,googl

# For the latest news for specific tags/countries/topics/tc
https://api.tiingo.com/tiingo/news?tags=election,argentina
Field Name
JSON Field
Data Type
Description
Article ID
id
int32
Unique identifier specific to the news article.
Title
title
string
Title of the news article.
URL
url
string
URL of the news article.
Description
description
string
Long-form descripton of the news story.
Published Date
publishedDate
datetime
The datetime the news story was published in UTC. This is usually reported by the news source and not by Tiingo. If the news source does not declare a published date, Tiingo will use the time the news story was discovered by our crawler farm.
Crawl Date
crawlDate
datetime
The datetime the news story was added to our database in UTC. This is always recorded by Tiingo and the news source has no input on this date. If you note a large gap between crawlDate and publishedDate, it means the news article was backfilled, which usually happens when we add a new data source or gain access to historical data archives.
News Source
source
string
The domain the news source is from.
Tickers
tickers
string[]
What tickers are mentioned in the news story using Tiingo's proprietary tagging algo.
Tags
tags
string[]
Tags that are mapped and discovered by Tiingo using Tiingo's proprietary tagging algo.
2.2 REST - News

2.2.3 Bulk Download

To download the entire database, use the following REST endpoints. An "incremental" batchType file is added every evening. At 12am EST a batch process runs saving down all news articles for the past 24 hours.

Note: Bulk Download can only be opened up to our institutional clients.

To download the entire database, use the following REST endpoints.
# For a list of all the bulk download files
https://api.tiingo.com/tiingo/news/bulk_download

# To download a specific batch file
https://api.tiingo.com/tiingo/news/bulk_download/{id}
Field Name
JSON Field
Data Type
Description
File ID
id
int32
Unique identifier specific to the bulk download file. Used to select which file to download.
URL
url
string
A url you can use to directly download the batch file. NOTE: This url contains your Auth Token and is meant to be a "copy/paste" url for your convenience
Filename
filename
string
The filename of the batch file.
Batch Type
batchType
string
Describes what kind of batch file this is. The value will either be: "base" or "incremental". base is an entire dump of the data and incremental is a partial dump of the data. This should be used in conjunction with the startDate and endDate parameters to identify the bounds of the data dump.
Start Date
startDate
date
The start date that was used to select the News objects to generate the batch file. This is inclusive. publishedDate >= startDate.
End Date
startDate
date
The end date that was used to select the News objects to generate the batch file. This is not inclusive. publishedDate < endDate.
Compressed file size
fileSizeCompressed
int64
The size of the file in bytes compressed using gzip.
Uncompressed file size
fileSizeUncompressed
int64
The size of the file in bytes uncompressed.