Sign in

v5

latestOpenAPI 3.1.0Proprietary2026-08-031,5423,1505.5 MB
Global News and Media

Media coverage timeline

Coverage volume or sentiment over time for a topic. Modes: timelinevol, timelinevolraw, timelinetone, timelinelang.

get/api/v1/gdelt/timeline

Query parameters

qstring required

Free-text search query.

Free-text search query.

timespanstring

Time window identifier.

Time window identifier.

modestring

GDELT visualization mode (timelinevol, timelinevolraw, timelinetone, timelinelang).

GDELT visualization mode (timelinevol, timelinevolraw, timelinetone, timelinelang).

countrystring

Source country filter.

Source country filter.

Response

Media coverage time series for the query in the selected mode.

dataStubData required

Response shape not yet documented; fields are returned as-is.

Example response

{
  "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",
    "source": "sugra_crypto",
    "attribution": "Short interest and Reg SHO daily short volume data is owned by and sourced from FINRA (Financial Industry Regulatory Authority).",
    "fallback_chain": [
      "sugra_crypto",
      "sugra_finance"
    ]
  }
}