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.

limitinteger

Top-N entities to return.

namestring nullable

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

Changes

Changed in 1 of the 21 revisions of this API.12

Aug 8, 20264c4530760ba112See the full diff
- ○
  added the optional property code to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property code to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property code to the response with the 503 status
  response-optional-property-added
- ○
  added the optional property hint to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property hint to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property hint to the response with the 503 status
  response-optional-property-added
- ○
  added the optional property plan to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property plan to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property plan to the response with the 503 status
  response-optional-property-added
- ○
  added the optional property reason to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property reason to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property reason to the response with the 503 status
  response-optional-property-added

Full history