v5

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

Trending entities (people and companies)

People and organizations recognized in the news by the GDELT Global Entity Graph (Google NL API), ranked by how many distinct articles mention them in the window (DATA-13). Each carries its type, Google Knowledge Graph MID (when available), max salience, last seen, and sample article URLs. Optional name= returns one entity's recent articles. period=1h reads the rolling window; 6h/24h merge daily shards.

get/api/v1/gdelt/entities/trending

Query parameters

periodstring

Lookback window.

Lookback window.

limitinteger

Top-N entities to return.

Top-N entities to return.

namestring nullable

Optional: return only this entity (by name) and its recent articles.

Optional: return only this entity (by name) and its recent articles.

Response

Top-N entities by article count with recognition metadata and freshness flags.

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"
    ]
  }
}