--- title: "Feed health statistics" method: GET path: "/api/v1/news/stats" tags: ["Global News and Media"] --- # Feed health statistics `GET /api/v1/news/stats` Items per region/category, active/failed feeds, last refresh time. ## Response `200` News feed health with items per region, category, and active or failed feed counts. - EnvelopeNewsStatsData - `data` NewsStatsData, required - `last_refresh` string, nullable — Timestamp of the last feed refresh (ISO 8601). - `total_items` union — Total items currently cached across all feeds. - integer - number - `total_feeds` union — Total number of configured feeds. - integer - number - `active_feeds` union — Number of feeds currently healthy. - integer - number - `failed_feeds` union — Number of feeds currently failing. - integer - number - `items_by_region` ItemsByRegion - `global` union — Item count for global region. - integer - number - `russia` union — Item count for Russia region. - integer - number - `asia` union — Item count for Asia region. - integer - number - `us` union — Item count for United States region. - integer - number - `europe` union — Item count for Europe region. - integer - number - `mideast` union — Item count for Middle East region. - integer - number - `india` union — Item count for India region. - integer - number - `oceania` union — Item count for Oceania region. - integer - number - `latam` union — Item count for Latin America region. - integer - number - `africa` union — Item count for Africa region. - integer - number - `china` union — Item count for China region. - integer - number - `items_by_category` ItemsByCategory - `news` union — Item count for general news category. - integer - number - `energy` union — Item count for energy category. - integer - number - `business` union — Item count for business category. - integer - number - `tech` union — Item count for technology category. - integer - number - `defense` union — Item count for defense category. - integer - number - `disasters` union — Item count for disasters category. - integer - number - `science` union — Item count for science category. - integer - number - `feeds` Feeds - `bbc` AbcAu - `name` string, nullable — Entity or record name. - `items` union — Number of items retrieved from this feed. - integer - number - `ok` boolean, nullable — Flag: feed fetched successfully. - `nyt` AbcAu - `name` string, nullable — Entity or record name. - `items` union — Number of items retrieved from this feed. - integer - number - `ok` boolean, nullable — Flag: feed fetched successfully. - `aljazeera` AbcAu - `name` string, nullable — Entity or record name. - `items` union — Number of items retrieved from this feed. - integer - number - `ok` boolean, nullable — Flag: feed fetched successfully. - `guardian` AbcAu - `name` string, nullable — Entity or record name. - `items` union — Number of items retrieved from this feed. - integer - number - `ok` boolean, nullable — Flag: feed fetched successfully. - `reuters` AbcAu - `name` string, nullable — Entity or record name. - `items` union — Number of items retrieved from this feed. - integer - number - `ok` boolean, nullable — Flag: feed fetched successfully. - `ap` AbcAu - `name` string, nullable — Entity or record name. - `items` union — Number of items retrieved from this feed. - integer - number - `ok` boolean, nullable — Flag: feed fetched successfully. - `france24` AbcAu - `name` string, nullable — Entity or record name. - `items` union — Number of items retrieved from this feed. - integer - number - `ok` boolean, nullable — Flag: feed fetched successfully. - `dw` AbcAu - `name` string, nullable — Entity or record name. - `items` union — Number of items retrieved from this feed. - integer - number - `ok` boolean, nullable — Flag: feed fetched successfully. - `bellingcat` AbcAu - `name` string, nullable — Entity or record name. - `items` union — Number of items retrieved from this feed. - integer - number - `ok` boolean, nullable — Flag: feed fetched successfully. - `scmp` AbcAu - `name` string, nullable — Entity or record name. - `items` union — Number of items retrieved from this feed. - integer - number - `ok` boolean, nullable — Flag: feed fetched successfully. - `yonhap` AbcAu - `name` string, nullable — Entity or record name. - `items` union — Number of items retrieved from this feed. - integer - number - `ok` boolean, nullable — Flag: feed fetched successfully. - `japantimes` AbcAu - `name` string, nullable — Entity or record name. - `items` union — Number of items retrieved from this feed. - integer - number - `ok` boolean, nullable — Flag: feed fetched successfully. - `diplomat` AbcAu - `name` string, nullable — Entity or record name. - `items` union — Number of items retrieved from this feed. - integer - number - `ok` boolean, nullable — Flag: feed fetched successfully. - `asiatimes` AbcAu - `name` string, nullable — Entity or record name. - `items` union — Number of items retrieved from this feed. - integer - number - `ok` boolean, nullable — Flag: feed fetched successfully. - `cna` AbcAu - `name` string, nullable — Entity or record name. - `items` union — Number of items retrieved from this feed. - integer - number - `ok` boolean, nullable — Flag: feed fetched successfully. - `jpost` AbcAu - `name` string, nullable — Entity or record name. - `items` union — Number of items retrieved from this feed. - integer - number - `ok` boolean, nullable — Flag: feed fetched successfully. - `tehrantimes` AbcAu - `name` string, nullable — Entity or record name. - `items` union — Number of items retrieved from this feed. - integer - number - `ok` boolean, nullable — Flag: feed fetched successfully. - `dailysabah` AbcAu - `name` string, nullable — Entity or record name. - `items` union — Number of items retrieved from this feed. - integer - number - `ok` boolean, nullable — Flag: feed fetched successfully. - `tass` AbcAu - `name` string, nullable — Entity or record name. - `items` union — Number of items retrieved from this feed. - integer - number - `ok` boolean, nullable — Flag: feed fetched successfully. - `xinhua` AbcAu - `name` string, nullable — Entity or record name. - `items` union — Number of items retrieved from this feed. - integer - number - `ok` boolean, nullable — Flag: feed fetched successfully. - `hindustan` AbcAu - `name` string, nullable — Entity or record name. - `items` union — Number of items retrieved from this feed. - integer - number - `ok` boolean, nullable — Flag: feed fetched successfully. - `dawn` AbcAu - `name` string, nullable — Entity or record name. - `items` union — Number of items retrieved from this feed. - integer - number - `ok` boolean, nullable — Flag: feed fetched successfully. - `batimes` AbcAu - `name` string, nullable — Entity or record name. - `items` union — Number of items retrieved from this feed. - integer - number - `ok` boolean, nullable — Flag: feed fetched successfully. - `brazilwire` AbcAu - `name` string, nullable — Entity or record name. - `items` union — Number of items retrieved from this feed. - integer - number - `ok` boolean, nullable — Flag: feed fetched successfully. - `mexnews` AbcAu - `name` string, nullable — Entity or record name. - `items` union — Number of items retrieved from this feed. - integer - number - `ok` boolean, nullable — Flag: feed fetched successfully. - `allafrica` AbcAu - `name` string, nullable — Entity or record name. - `items` union — Number of items retrieved from this feed. - integer - number - `ok` boolean, nullable — Flag: feed fetched successfully. - `abc_au` AbcAu - `name` string, nullable — Entity or record name. - `items` union — Number of items retrieved from this feed. - integer - number - `ok` boolean, nullable — Flag: feed fetched successfully. - `npr` AbcAu - `name` string, nullable — Entity or record name. - `items` union — Number of items retrieved from this feed. - integer - number - `ok` boolean, nullable — Flag: feed fetched successfully. - `pbs` AbcAu - `name` string, nullable — Entity or record name. - `items` union — Number of items retrieved from this feed. - integer - number - `ok` boolean, nullable — Flag: feed fetched successfully. - `defensenews` AbcAu - `name` string, nullable — Entity or record name. - `items` union — Number of items retrieved from this feed. - integer - number - `ok` boolean, nullable — Flag: feed fetched successfully. - `warzone` AbcAu - `name` string, nullable — Entity or record name. - `items` union — Number of items retrieved from this feed. - integer - number - `ok` boolean, nullable — Flag: feed fetched successfully. - `ft` AbcAu - `name` string, nullable — Entity or record name. - `items` union — Number of items retrieved from this feed. - integer - number - `ok` boolean, nullable — Flag: feed fetched successfully. - `bloomberg` AbcAu - `name` string, nullable — Entity or record name. - `items` union — Number of items retrieved from this feed. - integer - number - `ok` boolean, nullable — Flag: feed fetched successfully. - `marketwatch` AbcAu - `name` string, nullable — Entity or record name. - `items` union — Number of items retrieved from this feed. - integer - number - `ok` boolean, nullable — Flag: feed fetched successfully. - `techcrunch` AbcAu - `name` string, nullable — Entity or record name. - `items` union — Number of items retrieved from this feed. - integer - number - `ok` boolean, nullable — Flag: feed fetched successfully. - `arstechnica` AbcAu - `name` string, nullable — Entity or record name. - `items` union — Number of items retrieved from this feed. - integer - number - `ok` boolean, nullable — Flag: feed fetched successfully. - `wired` AbcAu - `name` string, nullable — Entity or record name. - `items` union — Number of items retrieved from this feed. - integer - number - `ok` boolean, nullable — Flag: feed fetched successfully. - `nature` AbcAu - `name` string, nullable — Entity or record name. - `items` union — Number of items retrieved from this feed. - integer - number - `ok` boolean, nullable — Flag: feed fetched successfully. - `sciencedaily` AbcAu - `name` string, nullable — Entity or record name. - `items` union — Number of items retrieved from this feed. - integer - number - `ok` boolean, nullable — Flag: feed fetched successfully. - `oilprice` AbcAu - `name` string, nullable — Entity or record name. - `items` union — Number of items retrieved from this feed. - integer - number - `ok` boolean, nullable — Flag: feed fetched successfully. - `gdacs_rss` AbcAu - `name` string, nullable — Entity or record name. - `items` union — Number of items retrieved from this feed. - integer - number - `ok` boolean, nullable — Flag: feed fetched successfully. - `csm` AbcAu - `name` string, nullable — Entity or record name. - `items` union — Number of items retrieved from this feed. - integer - number - `ok` boolean, nullable — Flag: feed fetched successfully. - `meta` SugraMeta, required — Metadata attached to every /api/v1/* response envelope. - `endpoint` string, required — Requested endpoint path. - `data_time` string, required — ISO 8601 UTC timestamp of the source data, not of the request. - `response_time` string, required — ISO 8601 UTC timestamp when this response was produced. - `provider` string, required — API name and version. - `source` string, nullable — Identifier of the primary upstream source used for this response. - `attribution` string, nullable — Human-readable attribution mandated by an upstream source (e.g. a securities regulator or self-regulatory organization). Present only on responses whose source requires the owner and source to be clearly identified. Do not remove or alter it when using the response. - `fallback_used` boolean, nullable — True when the primary source failed and a fallback produced the data. - `fallback_chain` string[], nullable — Ordered list of sources attempted, in the order they were tried. - `cached` boolean, nullable — True when this response was served from the internal cache. - `stale` boolean, nullable — True when the cached response was returned after the upstream rate-limited or errored. Clients can use this to detect degraded data. ## Other responses - `401` — Missing or invalid `x-api-key` header. JSON body with a stable `code` distinguishing `missing_api_key` (no header sent) from `invalid_api_key` (header sent, key not accepted); any other 401 source carries the generic `unauthorized` with its detail as `reason`. Plus `hint`. `plan` is always null on 401 - an unauthenticated request has no plan; quota exhaustion is 429, not 401. - `429` — Daily rate limit exceeded. Check `X-RateLimit-Reset` for the next window. - `503` — Upstream source is temporarily unavailable. Retry after a short delay. ## Changes - **2026-08-28** `560e8847c7b3` — 76 breaking, 3 info - the response property `data/active_feeds` became optional for the status `200` - the response property `data/failed_feeds` became optional for the status `200` - the response property `data/feeds` became optional for the status `200` - the response property `data/items_by_category` became optional for the status `200` - …75 more - **2026-08-08** `4c4530760ba1` — 12 info - added the optional property `code` to the response with the `401` status - added the optional property `code` to the response with the `429` status - added the optional property `code` to the response with the `503` status - added the optional property `hint` to the response with the `401` status - …8 more - **2026-08-03** `585ab97d5753` — 1 breaking, 1 info - removed the required property `data/feeds/timesofisrael` from the response with the `200` status - added the required property `data/feeds/jpost` to the response with the `200` status [Change history](https://skmtc.dev/sugra/apis/sugra-api/changes/api/v1/news/stats/get.md) --- [API](https://skmtc.dev/sugra/apis/sugra-api.md) · [All operations](https://skmtc.dev/sugra/apis/sugra-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/sugra/sugra-api/revisions/87582f2e0110/schema)