GDELT World Events

Keyless world-events monitor on the GDELT 2.0 raw event feed (no key). Each 15-minute global batch of world events, filterable by keyword, country, CAMEO event-root and mention count. One JSON item per event (url, country, location, event_root, goldstein, mentions), capped by limit.

What you get

Every run writes a dataset with one row per record:

{
  "gdelt_id": "1323900317",
  "batch_ts": "20260920004500",
  "event_date": "20260920",
  "date_added": "20260920004500",
  "event_code": "173",
  "event_base": "173",
  "event_root": "17",
  "event_type": null,
  "quad_class": 4,
  "quad_label": "Material Conflict",
  "goldstein": -5.0,
  "actor1": {
    "code": null,
    "name": null,
    "country_code": null
  },
  "actor2": {
    "code": "COP",
    "name": "POLICE",
    "country_code": null
  },
  "actor1_geo": "North Olmsted, Ohio, United States",
  "actor2_geo": "North Olmsted, Ohio, United States",
  "action_geo": null,
  "action_country": null,
  "avg_tone": 10.0,
  "mentions": 10,
  "articles": 1,
  "url": "https://www.cleveland19.com/2026/09/19/north-olmsted-police-investigating-shooting-that-left-1-dead-1-hospitalized/",
  "title": "POLICE -> 173",
  "domain": "www.cleveland19.com",
  "severity": 70.7,
  "severity_label": "high",
  "query": null,
  "source": "gdelt-v2-raw",
  "is_new": null,
  "new_since_last_run": null,
  "tone_shift": null,
  "prev_run_ts": null
}

Input

{
  "country": "US",
  "limit": 20
}

Field	Type	Description
country	string	Country: the country parameter. Default: "US".
limit	integer	Limit: the limit parameter. Default: 20.

Use cases

• Monitor on a schedule — run this Actor on a timer and get a fresh, normalized snapshot every time; diff the datasets to see what changed.
• Feed a dashboard or model — clean, one-JSON-item-per-record output is ready to pipe into a spreadsheet, database, or LLM prompt without any post-processing.
• Research & due diligence — pull a structured set of records for a topic, name, or window without scraping the public source by hand.

Limits & notes

• No API key, no login: it only reads public endpoints/feeds. If the upstream source is degraded, the run still succeeds and returns an honest status item instead of failing.
• Results reflect what the public source returned at run time (top-N windows, newest-first where applicable).
• Pay-per-event via synthetic events: each default-dataset item is billed through apify-default-dataset-item ($0.001 per item), plus apify-actor-start.
• Free to try on the free plan; PPE pricing applies to paid-plan users.

Categories

NEWS, LEAD_GENERATION