Under maintenance

Pricing

Pay per usage

Try for free

Go to Apify Store

GDELT Global News & Event Graph Fetcher

Under maintenance

Try for free

Fetch real-time global news articles and event-graph analytics from the GDELT Project 2.0 API. Supports article list mode (per-article billing) and GKG graph mode (per-entity-event billing). No API key required.

Pricing

Pay per usage

Rating

0.0

(0)

Developer

Bruno Finger

Actor stats

Bookmarked

Total users

Monthly active users

3 days ago

Last modified

Data Source

API: GDELT Project 2.0 API (https://api.gdeltproject.org/api/v2/doc/doc)
Coverage: Real-time global news from 65+ languages, 100+ countries
Authentication: None required (keyless public API)
Rate Limits: Designed for public access, generous limits

Features

Article List Mode (artlist): Fetch news articles with URLs, titles, domains, publication dates, languages, countries, and social images
Event Graph Mode (graph): Fetch GKG (Global Knowledge Graph) entity/event nodes with relationships
Time Chart Mode (timechart): Get historical time-series counts for a query
HTML Render Mode (htmlrender): Get rendered HTML visualization
Flexible filtering by language, domain, source country, and time windows
Per-article or per-graph-node pay-per-event billing

Input Parameters

Parameter	Type	Required	Description
`query`	string	Yes	Search query for GDELT (keywords, phrases, or GDELT syntax)
`mode`	string	No	Fetch mode: `artlist`, `graph`, `timechart`, `htmlrender` (default: `artlist`)
`maxRecords`	integer	No	Maximum records to return (default 100, max 250)
`startDatetime`	string	No	Start datetime UTC: `YYYYMMDDHHMMSS`
`endDatetime`	string	No	End datetime UTC: `YYYYMMDDHHMMSS`
`timespan`	string	No	Relative time span: `1H`, `6H`, `12H`, `24H`, `3D`, `1W`, `1M`
`format`	string	No	Response format: `json`, `csv`, `html` (default: `json`)
`lang`	string	No	Language filter (e.g., `English`, `Spanish`, `French`)
`domain`	string	No	Domain filter (e.g., `nytimes.com`, `bbc.com`)
`sourceCountry`	string	No	Source country filter (e.g., `United States`, `United Kingdom`)

Output Fields

Field	Type	Description
`url`	string	Article URL (artlist mode)
`title`	string	Article headline/title
`domain`	string	Source domain
`seendate`	string	When GDELT first saw the article (YYYYMMDDTHHMMSSZ)
`language`	string	Article language
`sourcecountry`	string	Source country
`socialimage`	string	Social media preview image URL
`mode`	string	Fetch mode used
`url_mobile`	string	Mobile-optimized URL (if available)
`error`	string	Error message (if any)

Pricing

Model: Pay-per-event
Article Fetched: $0.001 per article (artlist mode)
Graph Node Fetched: $0.001 per graph node (graph mode)
Category: NEWS / MONITORING

Example Usage

Article list (artlist mode):

{
  "query": "climate change",
  "mode": "artlist",
  "maxRecords": 50,
  "lang": "English",
  "timespan": "24H"
}

Event graph (graph mode):

{
  "query": "election fraud",
  "mode": "graph",
  "maxRecords": 100,
  "sourceCountry": "United States"
}

Time series (timechart mode):

{
  "query": "covid-19 vaccine",
  "mode": "timechart",
  "timespan": "1M"
}

Local Development

cd gdelt-news-event-graph-fetcher
python3 -m venv .venv
.venv/bin/pip install -r requirements.txt
echo '{"query": "llm", "mode": "artlist", "maxRecords": 5}' > INPUT.json
.venv/bin/python -m src --input-file INPUT.json

Docker

docker build -t gdelt-news-event-graph-fetcher .actor/
docker run --rm -v $(pwd)/storage:/usr/src/app/storage gdelt-news-event-graph-fetcher

References

GDELT News Data Enrichment Pipeline

visita/gdelt-news

This actor is the central intelligence hub for a multi-pipeline news aggregation system. Its primary role is to fetch, unify, cleanse, and analyze raw news data from multiple Apify news pipeline actors, preparing a structured dataset of topical trends for downstream AI services.

Visita Intelligence

GDELT News Scraper — Articles, Timeline & Images

logiover/gdelt-news-scraper

Scrape GDELT Project by keyword, topic, or GDELT query. Extract article titles, URLs, domains, dates, languages, countries, images, and tone for news monitoring, media analysis, and research. No API key, no login.

Logiover

Google News Scraper - Real URL & Source Metadata

api-empire/google-news-scraper

Automate Google News scraping for large topics or keyword lists. Retrieve headlines, summaries, sources, and publication timestamps in structured form. Useful for tracking industry updates, global events, or competitive news trends.

API Empire

Brand & News Monitor 📰 (Google News alerts to Slack & API)

tagadanar/brand-news-monitor

Google Alerts as an API: brand and competitor mentions from Google News, GDELT and Hacker News as structured JSON, deduplicated so you only ever pay for new mentions, with a Slack digest built in. $8 per 1,000 mentions, platform usage included.

Tagada Data

VC Database & Investor Watchlist — Owler-powered

foxlabs/vc-investor-watchlist

Owler-powered investor data — VC, PE, corporate VC & sovereign wealth firms. Returns firmographics, recent deals, M&A history, leadership, funding rounds & news as clean JSON. Public-source feed; pay-as-you-go; no login. Not a substitute for paid VC databases (IRR/DPI not included).

Berkan Kaplan

Scout — Lead Enrichment + OSINT

logical_vivacity/scout

Email finder + lead enrichment + OSINT from public sources. Pass any fragment — name, email, or domain — get a verified dossier: 700+ identity sites, SMTP-validated emails, document mining, sanctions screen, domain→team discovery. $0.05 person, $0.15 domain. No API keys

Logical Vivacity

246

Company News & Announcement Finder

coregent/company-news-announcement-finder

Find recent public company news, press releases, newsroom posts, blog announcements, product launches, funding updates, partnerships, and expansion signals. One flat, CSV-ready row per announcement. No login or cookies.

Delowar Munna

Crypto Intel

fiery_dream/crypto-intel

Enterprise-grade cryptocurrency and DeFi market intelligence agent.

Cody Churchwell

AP News Articles Scraper

automation-lab/ap-news-articles-scraper

Search AP News and export complete public articles with headlines, URLs, bylines, dates, images, sections, summaries, keywords, and full body text.

Stas Persiianenko

AP News Scraper — Breaking News Headlines & Links

nexgendata/ap-news-scraper

Scrape breaking-news headlines from AP News (Associated Press). Returns each story as clean JSON — headline, article URL, source, and capture time — ready for news monitoring, media dashboards, alerting, and feeding current-events context to AI agents. No login required. No API key. Pay per record.

NexGenData

Facebook Search Scraper & Public Events

scraper-engine/facebook-search-scraper

🔍 Collect public data from Facebook search results based on your keywords. This Apify actor extracts page names, posts, links, and basic engagement data. Useful for research, trend tracking, and competitor analysis with clean, structured output ready to export.