Sugra News direction

Global news and event signal - 42 curated feeds on a 5-minute cadence, plus the world's events.

Sugra News covers three layers of the news cycle: what was just published (curated headline feeds), what the world's media is talking about and how (GDELT events and media analytics), and what readers are paying attention to (Wikipedia pageview analytics). All of it behind the one x-api-key header, on every plan.

What data lives here

The direction maps to the Global News and Media category in the API reference (26 endpoints) in three modules:

Module	Base path	Endpoints	What it is
Sugra News curated feeds	`/api/v1/news/*`	~7	Unified headline digest from 42 curated feeds, refreshed every 5 minutes. Filter by region (`us`, `europe`, `asia`, `mideast`, `china`, `india`, `latam`, `africa`, `oceania`, `russia`, `global`), category (`news`, `defense`, `business`, `tech`, `science`, `energy`, `disasters`), or individual feed slug. Keyword search across all feeds.
GDELT events and media analytics	`/api/v1/gdelt/*`	~11	Global article search across 100+ languages and 250K+ sources, coverage-volume and tone timelines, sentiment histograms, sentence-level context search, TV news transcripts, plus a Sugra-ingested live event stream (recent events, trending themes, events, and entities) updated every 15 minutes.
Wikipedia attention	`/api/v1/news/wikipedia/*`	~8	Wikimedia pageview analytics (CC0): per-article view time series, daily top charts, top by country, unique devices, editor activity, cross-language comparison. A clean proxy for public attention to a topic.

One adjacent endpoint lives under the Equities Indices category: GET /api/v1/equities/{symbol}/news-sentiment composes GDELT tone and the first-party feed ingest into a per-ticker news-flow sentiment and attention series. It is a screening signal, not investment advice.

Flagship endpoints

Endpoint	Returns
`GET /api/v1/news/latest`	Latest headlines across all feeds, filterable by region, category, source
`GET /api/v1/news/search`	Keyword search over headlines and descriptions of all 42 feeds
`GET /api/v1/gdelt/articles`	Global article search with sentiment, domain, country, language filters
`GET /api/v1/gdelt/themes/trending`	Trending GDELT GKG themes over a 1h/6h/24h window, with share of total
`GET /api/v1/news/wikipedia/pageviews/top`	Top Wikipedia articles by views on a given date

Latest business headlines

{
  "data": {
    "total": 10,
    "count": 2,
    "items": [
      {
        "title": "The World Cup-winning side will make $50 million - and the IRS gets a cut",
        "link": "https://www.marketwatch.com/story/the-world-cupwinning-side-will-make-50-million...",
        "published": "2026-07-18T18:32:00Z",
        "source": "marketwatch",
        "region": "us",
        "category": "business"
      }
    ]
  },
  "meta": {
    "endpoint": "/api/v1/news/latest",
    "data_time": "2026-07-18T18:32:00Z",
    "source": "news_rss"
  }
}

(Second item and per-item description / source_name fields truncated.) GET /api/v1/news/search?q=... returns the same item shape; GET /api/v1/news/sources lists all feed slugs.

What the world's media is talking about

{
  "data": {
    "themes": [
      { "theme": "TAX_FNCACT", "count": 13181, "share": 0.0297 },
      { "theme": "CRISISLEX_CRISISLEXREC", "count": 6162, "share": 0.0139 },
      { "theme": "EPU_POLICY", "count": 6039, "share": 0.0136 }
    ],
    "total": 444097,
    "window_end": "2026-07-18T18:45:00Z",
    "stale": false,
    "partial": false
  },
  "meta": { "endpoint": "/api/v1/gdelt/themes/trending", "source": "gdelt_live" }
}

The stale and partial flags report ingest freshness and window completeness, so a consuming agent can decide whether to trust the aggregate.

What readers are paying attention to

{
  "data": {
    "project": "en.wikipedia",
    "date": "2026-07-16",
    "articles": [
      { "article": "Main_Page", "views": 7952344, "rank": 1 },
      { "article": "Special:Search", "views": 1231720, "rank": 2 },
      { "article": "Wikipedia:Featured_pictures", "views": 690696, "rank": 3 }
    ]
  },
  "meta": { "endpoint": "/api/v1/news/wikipedia/pageviews/top", "source": "wikipedia" }
}

Who uses it

AI agents that need a current-events context window. One call to /news/latest or /news/search grounds an agent in what happened in the last hours; /gdelt/context adds sentence-level evidence with surrounding text.

Monitoring and research desks. Track coverage volume and tone for a topic with /gdelt/timeline (modes timelinevol, timelinetone), then drill into the articles behind a spike with /gdelt/articles.

Signal builders. Combine /equities/{symbol}/news-sentiment with Wikipedia pageview series to separate media supply (coverage) from reader demand (attention) for a company or theme.

Where to go next

News and media sources - upstream catalog for this direction: GDELT and Wikimedia (CC0), plus the Sugra News curated feed set.

API reference: the Global News and Media group holds all endpoints on this page; the per-ticker sentiment endpoint sits in Equities Indices.

Quickstart - key setup, envelope shape, and rate-limit headers apply here unchanged.

Sugra News direction

What data lives here#

Flagship endpoints#

Latest business headlines#

What the world's media is talking about#

What readers are paying attention to#

Who uses it#