GDELT Global News Monitor

Search worldwide news coverage through the official GDELT Project DOC 2.0 API - the largest open news-monitoring database on earth. Articles from every country, machine-translated across 65+ languages, updated every 15 minutes. No login, no API key, no scraping.

Why GDELT

Google News shows you a slice; GDELT shows you the planet. It watches the world's news media in over 65 languages and records who is covering what, where, in what tone - which makes it the standard open source for crisis monitoring, geopolitical research, brand tracking across languages, and media-analysis pipelines. This Actor packages it for agents: one call in, clean article rows out.

What you get per article

• title, url, domain
• language, sourceCountry
• seenAt - when GDELT first saw the article
• image - social image when available

Inputs

Field	Required	Description
query	yes	GDELT query syntax: "exact phrase", OR, domain:reuters.com, sourcelang:spanish, sourcecountry:US
timespan	no	24h, 7d (default), 1w, 3m - used when no start date is set
startDate / endDate	no	Exact date range; overrides timespan
sort	no	datedesc (default), hybridrel, tonedesc, toneasc
sourceLang	no	Restrict to a language
sourceCountry	no	Restrict to a source country
maxResults	no	Default 100, max 1000

Examples

Global coverage of an election, last 24 hours:

{ "query": "\"presidential election\"", "timespan": "24h", "maxResults": 500 }

What the French press writes about AI regulation:

{ "query": "\"AI regulation\"", "sourcelang": "french", "timespan": "7d" }

FAQ

Is this an official source? Yes - the GDELT Project's own API. GDELT is an open academic project (Google Jigsaw-backed origins) designed exactly for this kind of analysis.

Do I need an API key? No.

How fresh is the data? GDELT updates every 15 minutes, around the clock.

Why does this Actor route through a proxy? GDELT throttles datacenter IPs hard; the Actor uses Apify residential proxy sessions and rotates them per request for reliability. The tiny proxy cost is absorbed in pricing.

What does it cost? Pay-per-event: $2 per 1,000 articles.

Can I go beyond 250 results? Yes - the Actor walks the timeline backward automatically with dedupe, up to your maxResults.

Pipeline patterns

Global brand radar. A standing query on your brand, product and executive names across all languages, scheduled hourly or daily. GDELT sees coverage you would never catch in English-only monitoring - local press, trade journals, broadcast transcripts.

Crisis and event tracking. During a developing situation, timespan=24h with sort=datedesc gives you the freshest worldwide reporting every run; dedupe on url.

Narrative and tone analysis. sort=tonedesc/toneasc surfaces the most positive or most negative coverage first - a quick way to sample framing differences across countries.

Competitor and market intelligence. Track product names, regulation topics, or entire industries ("artificial intelligence" OR "machine learning") and let an LLM cluster the weekly output.

Field notes

seenAt is when GDELT first detected the article, not necessarily its publication time - usually within an hour. language and sourceCountry describe the publisher, so a Spanish-language story from Argentina and one from Spain are distinguishable. GDELT dedupes aggressively at ingest, but syndicated wire stories still appear under multiple domains - cluster on title similarity downstream if that matters for your counts.

More FAQ

How much history? GDELT DOC 2.0 reaches back to 2017. Set startDate/endDate for historical ranges.

Why did a run return few or no articles? Narrow queries genuinely have few hits in a short timespan; widen timespan or relax quoted phrases. GDELT also rate-limits bursts - the Actor retries and rotates proxies automatically.

Broadcast and print too? GDELT covers online news and some broadcast transcripts; it is not a full social-media or print archive.

Can I combine filters in the query itself? Yes - the query field accepts GDELT's native operators, so domain: and sourcelang: can be embedded directly for power use.

What languages can I query in? Any - GDELT translates; query in English to match translations, or in the native language.

Why proxy costs? Covered in the per-article price; you are not billed separately for the proxy.

More official-API Actors from SlanLabs

• App Store Reviews (Official Apple Feeds) - every public review for any iOS app, any country
• App Store Top Charts (Official Apple Feeds) - live top free, paid and grossing charts for apps, books, podcasts and music
• Bluesky Scraper - Posts, Profiles, Search - posts, profiles, search and threads via the open AT Protocol
• SEC EDGAR Filings Search & Monitor - full-text search and company feeds from the SEC's official APIs
• Hacker News Search & Monitor - every story and comment since 2006, plus the live front page
• US Government Spending & Contracts (USASpending) - federal contracts, grants and loans by keyword, agency, NAICS or recipient