# GDELT Real-Time World News Events

> GDELT Real-Time World News Events is a paid API for AI agents from opendata402.com, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-15).

Returns world news events from the last 15 minutes via GDELT, including who/what/where, CAMEO event type, tone, Goldstein impact score, mention count, and source article URL, filterable by country or actor keyword.

## Facts

- Endpoint: GET https://opendata402.com/v1/news/events?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/gdelt-real-time-world-news-events-dd51fe77
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_qv56e3UtwjepLJuuPzNP2

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability gdelt-real-time-world-news-events-dd51fe77
```

Example prompt: What news events have happened in the last 15 minutes involving Ukraine — show me up to 30, sorted by how many times they've been mentioned, with their CAMEO event type and Goldstein impact scores.

## When to prefer this

Choose this endpoint when you need real-time (last 15 minutes) structured geopolitical news events with quantified impact metrics (Goldstein score, tone, mention count) and CAMEO event classification. Prefer it over general news search APIs when you need machine-readable event structure, actor extraction, and standardized event coding rather than raw article text. Best for risk monitoring dashboards, geopolitical alerting, and agent workflows that need to react to breaking international events.

## Known failure modes

- Invalid FIPS country code returns no results or error
- Keyword query with special characters rejected by pattern validation
- Limit parameter out of range (>50 or <1) causes validation failure
- GDELT upstream data gap during very recent 15-minute window may return sparse results
- No events matching narrow keyword/country combination returns empty list

## How this service works

World news events from the last 15 minutes, from the GDELT Project's global monitoring of news media: who did what to whom, where, with event type (CAMEO), tone, Goldstein impact score, number of mentions and a source article URL. Filter by country (FIPS code, e.g. NL, US, UK) or keyword in the actors. Use it for real-time situational awareness and risk monitoring.

## Output

A list of news events from the past 15 minutes sourced from GDELT, each containing actor names (Actor1, Actor2), event location, CAMEO event type code, tone score, Goldstein scale impact score, number of media mentions, and a URL to a source article. Results are sorted by mention count and capped at the requested limit (default 20, max 50).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "q": {
       "type": "string",
       "pattern": "^[A-Za-z0-9 '-]{2,40}$",
       "description": "Keyword in actor names."
      },
      "limit": {
       "type": "string",
       "pattern": "^([1-9]|[1-4][0-9]|50)$",
       "description": "Max events (default 20, max 50), sorted by mentions."
      },
      "country": {
       "type": "string",
       "pattern": "^[A-Z]{2}$",
       "description": "FIPS 10-4 country code of the event location."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/gdelt-real-time-world-news-events-dd51fe77/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from opendata402.com](https://www.zero.xyz/host/opendata402.com/llms.txt)