# GDELT, free: News API

> We are incredibly excited to announce today the debut of the new GDELT 2.0 DOC API, which is our full text search API.

GDELT's news API on its Free plan. It costs $0.00 per 1,000 searches. It returns 2 of the 6 key fields we check: Date, Image.
You get as many calls as you like.
Half of the 584 plans we rank by price cost $1.00 per 1,000 searches or less. This plan and 2 others tie for the lowest price per 1,000 searches of the 584 plans.
[Scrappa](https://datacircle.dev/news-apis/scrappa/25-pack/llms.txt), [ReefAPI](https://datacircle.dev/news-apis/reefapi/450-quarterly-enterprise-quarterly-post-news-article-v1-news-search/llms.txt) and [ScrapeUnblocker](https://datacircle.dev/news-apis/scrapeunblocker/299-monthly/llms.txt) are the best news API providers in our benchmark.

- This page: https://datacircle.dev/news-apis/gdelt/free
- [Best news API in 2026: providers compared](https://datacircle.dev/best-news-api.txt)
- Get it: https://www.gdeltproject.org/about.html?utm_source=datacircle.dev&utm_medium=referral&utm_campaign=news-api-pricing
- Request: `GET https://api.gdeltproject.org/api/v2/doc/doc`
- API key: not needed
- Its API docs: https://blog.gdeltproject.org/gdelt-doc-2-0-api-debuts/?utm_source=datacircle.dev&utm_medium=referral&utm_campaign=news-api-pricing
- Sold by: GDELT (https://www.gdeltproject.org?utm_source=datacircle.dev&utm_medium=referral&utm_campaign=news-api-pricing)
- Checked: 2026-11-01

## In the answer

- Completeness: 33%
- Date: ✓
- Image: ✓

## Score

- Overall score: 60.8
- Price score: 100
- Accuracy score: 41
- Cost to get started score: 100
- Bundle score: 0
- Performance score: 3

## Price

- $ per 1,000 searches: $0.00
- Per: call
- Billing: free

## Charges

- Most per search: 250
- Also pays for: nothing else

## Not found

- $ per 1,000: $0.00

## In their words

- Their pitch: We are incredibly excited to announce today the debut of the new GDELT 2.0 DOC API, which is our full text search API.

## Data

- Freshness: 15 minutes
- Keep data: no limit
- Use data: The GDELT Project is an open platform for research and analysis of global society and thus all datasets released by the GDELT Project are available for unlimited and unrestricted use for any academic, commercial, or governmental use of any kind without fee. [...] You may redistribute, rehost, republish, and mirror any of the GDELT datasets in any form. However, any use or redistribution of the data must include a citation to the GDELT Project and a link to this website (https://www.gdeltproject.org/).

## Plan

- Pay: $0
- Enough for: no limit

## Rate limit

- Batch: 1

## Speed

- Answer: in the call
- Median: 7.46 s

## The call

- You send: query, mode "ArtList", format "json". Optional: maxrecords, timespan, startdatetime, enddatetime, sort
- Method: GET
- Path: /api/v2/doc/doc

## About the plan

- Plan: Free
- Who can get it: anyone

## The 6 fields the plan's answer can hold

title, URL, image URL, source country, language, published date

## GDELT's plans (1)

- [GDELT, free](https://datacircle.dev/news-apis/gdelt/free/llms.txt): $0.00 per 1,000, 33% complete, 15 minutes

## GDELT's calls (1)

- `GET /api/v2/doc/doc`: [GDELT, free](https://datacircle.dev/news-apis/gdelt/free/llms.txt)

## GDELT's APIs (1)

- [GDELT: news API pricing, 1 plan](https://datacircle.dev/news-apis/gdelt/free/llms.txt)

## GDELT: news API alternatives

- [Scrappa, free, GET /api/google/news](https://datacircle.dev/news-apis/scrappa/free/llms.txt): $0.00 per 1,000, 67% complete, live
- [ReefAPI, free, POST /news-intel/v1/search](https://datacircle.dev/news-apis/reefapi/free-post-news-intel-v1-search/llms.txt): $0.00 per 1,000, 67% complete, live
- [ScrapeUnblocker, free](https://datacircle.dev/news-apis/scrapeunblocker/free/llms.txt): $0.00 per 1,000, 67% complete, live
- [PerceptLayer, free](https://datacircle.dev/news-apis/perceptlayer/free/llms.txt): $0.00 per 1,000, 67% complete, live

## Sources

From each provider's own pricing page and docs, and from what providers tell us. We read this row from these pages on 2026-11-01.

- https://blog.gdeltproject.org/gdelt-doc-2-0-api-debuts/?utm_source=datacircle.dev&utm_medium=referral&utm_campaign=news-api-pricing
- https://www.gdeltproject.org?utm_source=datacircle.dev&utm_medium=referral&utm_campaign=news-api-pricing
- https://www.gdeltproject.org/about.html?utm_source=datacircle.dev&utm_medium=referral&utm_campaign=news-api-pricing