# GDELT News Scraper - World News in 65+ Languages

One of the tools on damistudio.io. Index of all of them: https://damistudio.io/llms.txt

URL: https://damistudio.io/tools/gdelt-news-scraper/
Run: https://apify.com/dami_studio/gdelt-news-scraper?fpr=wcqem0
Category: News & Finance Data
Pricing: $0.002 per article ($2 per 1,000) on Apify's Free plan, read on 5 November 2026.
Apify name: dami_studio/gdelt-news-scraper
Latest version: 0.1.33, updated 27 October 2026
From an AI chat: add Apify's connector (https://mcp.apify.com/), sign in with your Apify account, then ask:
  Use the GDELT News Scraper (dami_studio/gdelt-news-scraper) to find news articles about "artificial intelligence", and return one row per article: headline, link, outlet domain, outlet country, language, publish time, share image.
Preset address for apps that take one: https://mcp.apify.com?tools=dami_studio/gdelt-news-scraper (runs go on your own Apify account)

GDELT news scraper: search world news in 65+ languages. Each row holds the headline, link, outlet domain, outlet country, language, publish time and share image. Filter by country, language or time window. 250 articles per query, about three months back.

Inputs:
- `query` (string): Keywords to search worldwide news for. Wrap phrases in quotes (e.g. "climate change"). Combine with OR, or operators like domain:reuters.com. Very short or very common single words may be rejected by GDELT, add a second word or quote a phrase.
- `timespan` (string): Only return articles from the last N units of time, e.g. 1d, 3d, 1w, 1m, 3m. Leave empty for GDELT's default window. GDELT only covers roughly the last 3 months.
- `sourceCountry` (string): Limit to articles from a given source country, appended to the query as sourcecountry:{code}. Use GDELT country codes (e.g. US, UK, FR, DE, IN). Leave empty for all countries.
- `sourceLang` (string): Limit to articles in a given language, appended to the query as sourcelang:{code} (e.g. english, french, spanish, german). Leave empty for all languages.
- `sort` (string): How to order results: DateDesc (newest first), DateAsc (oldest first), or HybridRel (by relevance to the query).
- `maxItems` (integer): Maximum number of articles to return. GDELT hard-caps a single request at 250, higher values are automatically capped at 250.
- `notionConnector` (string): Optional. Write each article as a page into your Notion when the run finishes. Authorize a Notion connector once in Settings → API & Integrations → MCP connectors, then pick it here. Leave empty to skip (default), results are always saved to the dataset regardless.
- `notionParentId` (string): Optional. The Notion data source ID of the database to write into (only used if a Notion connector is set). Leave empty to create the pages privately in your workspace instead.

Documentation:

Type a few words and get the matching news articles from outlets around the world, in more than 65 languages: one row per article with the headline, the link, the outlet, the outlet's country, the language and the time it was published. Narrow it to one country, one language, or the last day, week or month. It searches GDELT's open index of recent world coverage, so it suits what's being published now.

## Who follows world news this way

- **Comms teams watching a name abroad.** A run every morning with `timespan` at one day shows where it came up overnight, and in which languages.
- **Researchers comparing coverage between countries.** Run the same query twice with a different `sourceCountry` and compare the counts.
- **Building a list of who covers a topic.** A few hundred rows grouped by `domain` show which outlets keep coming back to it.

## A worked example

On 4 November we searched for "artificial intelligence", newest first, with no country or language filter, and kept five.

The first three were in Spanish, Portuguese and Russian: one from an outlet in the United States, one from Russia, and one whose country GDELT had no record of, which comes through as `null`. All three were stamped within the same quarter of an hour, and an English query found every one of them.

You pay per article.

## What a row looks like

| Field | What it tells you |
|---|---|
| `title` | The headline, in the language it was published in |
| `url`, `domain` | The article's address and the outlet it's on |
| `sourceCountry` | Where the outlet is based, or `null` when GDELT doesn't say |
| `language` | The language the article is written in |
| `publishedAt` | When GDELT recorded it |
| `socialImage` | The share picture the outlet set, when there is one |

Each row is the article's details, not its text: the `url` takes you to the article itself.

## When it's the wrong tool

- **You want background on the subject rather than today's coverage.** [Wikipedia Scraper](https://damistudio.io/tools/wikipedia-scraper/) returns the articles' text.
- **You want what a company filed, not what was written about it.** That's [SEC EDGAR Scraper](https://damistudio.io/tools/sec-edgar-scraper/).
- **You want scholarly papers on the topic.** [Crossref Scraper](https://damistudio.io/tools/crossref-scraper/) searches published research.
- It is not an official GDELT tool. Dami's Studio is independent and is not affiliated with or endorsed by GDELT, or by any other company named on this page.

## Questions people ask

### Is this a news API?

You can use it as one: start it from Apify's API with a query and read the articles back as JSON. It searches GDELT's open index, so there's no news API key of your own to set up.

### What is GDELT?

An open project that watches news outlets worldwide and indexes what they publish, in dozens of languages. This tool searches that index and gives you the matching articles as rows.

### Can I search news in other languages?

Yes. Leave `sourceLang` empty for every language, or set one to keep only articles written in it. An English query also finds coverage written in other languages.

### How do I follow a story every day?

Schedule a daily run with `timespan` set to `1d` and keep the rows. An article that turns up in two runs has the same `url` in both.

### What does GDELT News Scraper do?

GDELT news scraper: search world news in 65+ languages. Each row holds the headline, link, outlet domain, outlet country, language, publish time and share image. Filter by country, language or time window. 250 articles per query, about three months back.

### What do I give GDELT News Scraper?

A search query, optionally narrowed by country, language and time window.

### What do I get back from GDELT News Scraper?

One row per article: headline, link, outlet domain, outlet country, language, publish time, share image.

### How much does GDELT News Scraper cost?

$0.002 per article ($2 per 1,000) on Apify's Free plan. Paid plans pay a little less. It is billed on your own Apify account.

### Can I run GDELT News Scraper from my AI chat?

Yes, from any app that supports MCP connectors. Add Apify's connector (https://mcp.apify.com/), sign in with your Apify account, and ask for dami_studio/gdelt-news-scraper. The steps are on the Use with AI page. Each run goes on your own Apify account, at the prices on its Apify page.

### Do I need to write code to use GDELT News Scraper?

No. Open it on Apify, fill in the form, click Run and download the results.
