GDELT News Monitor - Keyword News Tracking API avatar

GDELT News Monitor - Keyword News Tracking API

Pricing

from $1.25 / 1,000 article delivereds

Go to Apify Store
GDELT News Monitor - Keyword News Tracking API

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

Karl Sundström

Maintained by Community

Actor stats

0

Bookmarked

1

Total users

0

Monthly active users

5 minutes ago

Last modified

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

ParameterValueNotes
querykeywords + filtersrequired; see query syntax below
modeArtListarticle list mode
formatjsonreturns {"articles": [...]}
sortDateDescnewest first
maxrecords75API caps a single request at 75
timespane.g. 24h, 7drolling window; alternative to datetime range
startdatetime / enddatetimeYYYYMMDDHHMMSSexplicit UTC window
domain:<d>optional query suffixe.g. domain:reuters.com
sourcecountry:<c>optional query suffixlowercase 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