Trending events by media attention

GET

/api/v1/gdelt/events/trending

Last modified:2026-10-11 19:16:11

Maintainer:Not configured

OperationId:gdelt_events_trending

Events ranked by how much media attention they are getting in the window, from the GDELT Mentions stream. Each event carries its mention count, distinct outlet count, up to five outlet names, up to five article links, average tone, and first/last seen time. Join global_event_id back to /gdelt/recent for event detail. period=1h reads the rolling window; 6h/24h merge daily shards. Omit lang, or pass en, eng, or english, for the English mentions file. A two-letter code maps onto a stored code. One of the 15 stored source languages ranks the translation mentions.

Request

Authorization

API Key

Add parameter in header

x-api-key

Example:

x-api-key: ********************

Query Params

Header Params

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://sugra.ai/api/v1/gdelt/events/trending?period=undefined&limit=undefined&lang=undefined' \
--header 'x-api-key: <api-key>'

Responses

🟢200OK

application/json

Top-N events by mention count with attention metrics and freshness flags.

Bodyapplication/json

Example

{
    "data": {
        "events": [
            {
                "global_event_id": 0,
                "mentions": 0,
                "sources": 0,
                "outlets": [
                    "string"
                ],
                "sample_urls": [
                    "string"
                ],
                "avg_tone": 0,
                "first_seen": 0,
                "last_seen": 0
            }
        ],
        "total": 0,
        "window_end": "string",
        "stale": true,
        "partial": true
    },
    "meta": {
        "endpoint": "/api/v1/fred/us/cpi",
        "data_time": "2026-04-16T14:30:00Z",
        "response_time": "2026-04-16T14:30:12Z",
        "provider": "Sugra API v1.0.1",
        "data_age_days": 0,
        "source": "string",
        "attribution": "string",
        "fallback_used": true,
        "fallback_chain": [
            "string"
        ],
        "cached": true,
        "stale": true,
        "stale_since": "string",
        "period": "string",
        "notes": "string"
    }
}

🟠401Unauthorized

🟠422Parameter Error

🟠429

🔴500Server Error

🔴503Service Unavailable

Modified at 2026-10-11 19:16:11

GDELT events filtered by country