GDELT DOC 2.0 API
by blog.gdeltproject.org
News feeds and APIs
Added on November 1st, 2026
Checked and working on November 1st, 2026
Visit blog.gdeltproject.org →
What it does
The GDELT DOC 2.0 API searches worldwide online news monitored by the GDELT Project, in 65 languages machine-translated so you can search in English. Get lists of matching articles, timelines of coverage volume or tone, or image collages, for example to track how a topic is reported across countries. Results come as JSON, CSV, RSS or HTML from a simple GET URL; the default search window is the last three months. Free, no key needed; limit requests to one every five seconds.
At a glance
- API key
- Not needed · More APIs with no key
- Pricing
- Free, no key needed; limit requests to one every five seconds.
- From the browser
- Yes (CORS)
- Formats
- JSON, CSV, RSS
- Interface
- HTTP-GET
- Provider
- blog.gdeltproject.org
- Last checked
- Working on November 1st, 2026
More information: https://blog.gdeltproject.org/gdelt-doc-2-0-api-debuts/
Is this your service? Show that it is listed
Put this badge on your website or in your README; it links to this page. About the badge
Example request
curl
curl 'https://api.gdeltproject.org/api/v2/doc/doc?query=london&mode=artlist&maxrecords=5&format=json'JavaScript
const response = await fetch("https://api.gdeltproject.org/api/v2/doc/doc?query=london&mode=artlist&maxrecords=5&format=json");
const data = await response.json();
console.log(data);Python
import requests
response = requests.get(
"https://api.gdeltproject.org/api/v2/doc/doc?query=london&mode=artlist&maxrecords=5&format=json",
timeout=30,
)
print(response.json())The JavaScript works in a web page as well as in Node.js 18 or newer.