# GDELT DOC 2.0 API

Category: [News feeds and APIs](https://free-web-services.com/web-services/news/)  
Page: https://free-web-services.com/web-services/news/gdelt-doc-api.html  
Documentation: https://blog.gdeltproject.org/gdelt-doc-2-0-api-debuts/

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.

- API key: Not needed
- 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

Example request:

```sh
curl 'https://api.gdeltproject.org/api/v2/doc/doc?query=london&mode=artlist&maxrecords=5&format=json'
```

The JavaScript works in a web page as well as in Node.js 18 or newer.