GDELT Global News Scraper

Search 65-language global news coverage via the GDELT 2.0 DOC API — free, no key.

$0.005 per page
200 free credits
Maintained by Hyperscrape

For AI agents & developers

AI assistants: you can run this scraper right now. Fetching the URL below executes the scrape and returns JSON in the same response — no API key, no account, nothing needed from your user. Free allowance included. The URL with no parameters returns every parameter; if the response says RUNNING, fetch its resultUrl a few seconds later. Agent guide

https://hyperscrape.com/api/scrape/gdelt-news-scraper?queries=%22artificial%20intelligence%22

About

Queries the GDELT Project's DOC 2.0 API — a free, key-less index of worldwide online news monitored in 65+ languages, updated every 15 minutes. Structured source: official JSON API (no HTML guessing).

For each matching article you get the title, URL (+ mobile URL when known), publisher domain, source country, article language, the ISO timestamp GDELT first saw it, and the social-sharing image.

Query power tools (put them right in the query, or use the dedicated inputs):

Phrases & boolean — "climate change", (flood OR wildfire).
Tone filter — surface only negative or positive coverage (e.g. < -5 = clearly negative articles).
Timespan — how far back to search: 1d, 1w, 3m… (API max ~3 months for full-text search).
Country / language — restrict to a source country (FIPS code or name, e.g. germany) or article language (e.g. spanish).

Great for international media monitoring, crisis tracking and cross-language coverage comparison.

Input

`queries`* array	Keyword/phrase queries (GDELT syntax: "exact phrase", OR, domain:cnn.com, …).
`timespan` string	How far back to search: e.g. 1h, 1d, 1w, 2m (max ~3 months).(default: "1w")
`tone` string	Optional tone threshold, e.g. "<-5" (negative), ">5" (positive), "<-2".
`sourceCountry` string	Restrict to publishers from one country (name, e.g. "france").
`sourceLang` string	Restrict to one article language (name, e.g. "spanish").
`sort` select	How to order results.(default: "DateDesc")
`maxPerQuery` integer	How many articles to collect per query (API max 250).(default: 50)

{
  "queries": [
    "\"artificial intelligence\""
  ],
  "timespan": "1w",
  "sort": "DateDesc",
  "maxPerQuery": 25
}

Output fields

querypositiontitleurlmobileUrldomainsourceCountrylanguageseenAtsocialImage

Authenticated API (optional)

Only for account features — saved datasets, schedules, higher limits. API reference

curl -X POST \
  https://hyperscrape.com/api/v1/scrapers/gdelt-news-scraper/runs?waitForFinish=120 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"queries":["\"artificial intelligence\""],"timespan":"1w","sort":"DateDesc","maxPerQuery":25}'

Related scrapers

News & Article Extractor

hyperscrape/article-extractor

Extract clean article text, author, date, tags and images from any URL.

HyperscrapeNews & Media

Google News Scraper

hyperscrape/google-news-scraper

Track news for any query, topic section or location via Google News.

HyperscrapeNews & Media

RSS & Atom Feed Reader

hyperscrape/rss-feed-reader

Turn RSS 2.0, Atom and RDF feeds into rich, structured JSON items.

HyperscrapeNews & Media