Global News and Media

Media coverage timeline

Changed on

Article counts or mean tone over the stored file window. Modes: timelinevol, timelinevolraw, timelinetone, timelinelang. The served window is at most 24 hours.

get/api/v1/gdelt/timeline

Request

  • Base URL: https://sugra.ai
  • URL: https://sugra.ai/api/v1/gdelt/timeline
  • Auth: API key in header x-api-key

Query parameters

qstring required

Free-text search query. Only uppercase OR starts a new group.

timespanstring

Time window. Longer than 24h is capped and marked.

modestring

timelinevol, timelinevolraw, timelinetone, or timelinelang.

countrystring

Country named in the article (ISO code).

Response

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

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",
    "data_age_days": 8.532,
    "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"
    ],
    "stale_since": "2026-09-08T12:00:00Z",
    "period": "2026-Q1",
    "notes": "the UKMTO report behind these counts is dated 2026-08-21 and is 11 days old"
  }
}

Changes