GDELT News Monitor - Keyword News Tracking API
Pricing
from $1.25 / 1,000 article delivereds
GDELT News Monitor - Keyword News Tracking API
Monitor global news coverage for one or more keywords via the keyless GDELT 2.0 DOC API. Returns matching articles with title, source, URL and publication timestamp.
Pricing
from $1.25 / 1,000 article delivereds
Rating
0.0
(0)
Developer
Karl Sundström
Maintained by CommunityActor stats
0
Bookmarked
1
Total users
0
Monthly active users
5 minutes ago
Last modified
Categories
Share
GDELT News Monitor (keyless)
Apify actor that monitors global news via the GDELT 2.0 DOC API
(https://api.gdeltproject.org/api/v2/doc/doc) — no API key required.
Verification date: 2026-09-25. The parameter set below was verified with live calls to the API on that date:
Verified parameter set
| Parameter | Value | Notes |
|---|---|---|
query | keywords + filters | required; see query syntax below |
mode | ArtList | article list mode |
format | json | returns {"articles": [...]} |
sort | DateDesc | newest first |
maxrecords | 75 | API caps a single request at 75 |
timespan | e.g. 24h, 7d | rolling window; alternative to datetime range |
startdatetime / enddatetime | YYYYMMDDHHMMSS | explicit UTC window |
domain:<d> | optional query suffix | e.g. domain:reuters.com |
sourcecountry:<c> | optional query suffix | lowercase code; uppercase SK was rejected live with "Invalid/Unsupported Country" |
Query syntax (verified)
- Multiple keywords must be OR'd as a quoted, parenthesized group:
("renewable energy" OR "solar power"). Unparenthesized OR groups are rejected by the API ("Queries containing OR'd terms must be surrounded by ()"). - The actor quotes multi-word keywords and builds the parenthesized OR group automatically from comma-separated input.
- Rate limit: GDELT allows ~1 request / 5 s per IP. The actor retries throttled responses (up to 5 times, 6 s apart).
Input
{"keywords": "renewable energy, solar power","timespan": "7d","maxItems": 10}
Optional: startDateTime/endDateTime (YYYYMMDDHHMMSS), domain
(comma-separated), sourceCountry (comma-separated lowercase codes).
Output
One item per article, deduplicated by URL:
{"url": "...","title": "...","seendate": "20260925T094500Z","domain": "example.com","language": "English","sourcecountry": "United States","queryMatch": "(\"renewable energy\" OR \"solar power\")"}
Pricing (pay-per-event)
actor-start: $0.05 (once per run)result-found: $0.00125 per article- max total charge: $5.00 per run