This API provides an easy to use schema for breaking news, so you can build apps that perform in-depth data mining and robust visualizations.
Global news coverage. See all articles revolving around geopolitics, big tech news, and cultural discourse.
Machine learning topic modeling. Every batch of articles is run through the model to identify the top breaking stories.
Accurate, sanitized data. Our data pipeline cleans and transforms the raw data from GDELT to make it easy to use and salient.
Hundreds of thousands of categorized keywords. Search for themes, people, organizations, or anything else.
Geographical locations tied to each article. Pinpoint breaking stories to locations with coordinates, tags, and country codes.
Updated every 15 minutes. As close to real-time as you can get with this vast range of sources.
We import news article metadata from thousands of local and national sources around the world through the GDELT project, the largest database of online news media in the world.
The data is abstracted by transforming, cleaning, and tokenizing the raw entries to provide titles, urls, sentiments, the latest trending stories, 1,000s of locations, 100,000s of new searchable keywords, and more.
All data is transformed to comply with ISO standards, reduce duplication, and maximize salience.
GET /batches/latest
to recognize updates to the data. Once you see a new batch come in:GET /stories/latest
and GET /articles/latest
to get stories and articles.withKeywords
or withLocations
flags.401 - Forbidden
400 - [{{validation_error_string}}]
404 - No {{object}} with id {{id}}
404 - Not Found
500 - Something went wrong
View the full documentation at: https://docs.tidalwaves.io