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). The three modules below are 25 of those routes. The other route is per-symbol market headlines, which carries this tag and is listed with Sugra Finance.

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/*`	10	News cards, tone and coverage from the GDELT files Sugra stores (English article search, 24 hour window), sentiment histograms, stored quotations, an explicit empty television response, plus the ingested event stream (recent events, trending themes, events, and entities) updated every 15 minutes. lang on recent, by-country and trending reads stored translation events for one of 15 source languages.
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`	News cards from the stored files: title, source, time, link, tone, quantities. English by default, including en, eng and english. Fifteen stored source languages via lang, and the matching two-letter code. Window at most 24 hours.
`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 returns quotations stored from the files.

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#