# Reading the news

How Feed's stories reach you on the API, Kelly Wire and Kelly MCP, how Top and Latest sort them, and how to page and follow them live.

Feed is Kelly's sports news: each story is one event (an injury, a trade, a line move, a lineup change) that one or more outlets reported, written once in Kelly's own words and linked to every outlet that carried it. The same story view comes from `GET /v1/news`, from Kelly MCP's `get_news` and from the `news:` topics on Kelly Wire, so no two surfaces disagree.

## A story

| Member | What it is |
| --- | --- |
| `story_id` | `nsty_…`, stable for the story's life. |
| `headline`, `summary` | Kelly's own words. An outlet's title and text never appear. |
| `event_type` | `injury`, `transaction`, `trade`, `line_move`, `lineup` and more: an open list, so accept values you don't know. Analyst picks are no longer counted in Feed: they are on `GET /v1/analyst-picks`, and an old picks count's ID answers 404 with a `Location` on Wire. |
| `fantasy`, `betting` | Which readers the story matters to. Both can be true. |
| `tags` | The players, teams and competition, each with Kelly's ID when Kelly knows it. Players come first. |
| `game` | The game the story is about, with its ID and teams, or null. |
| `card` | The live card's kind and the IDs it streams (`player_id`, `game_id`, `market_ids`). Live numbers are never in the story: follow them on `player:`, `game:` and `market:`. |
| `sources` | Each outlet's name, link and `source_id`, Kelly's own report first. A list carries the first three; `GET /v1/news/{story_id}` carries every one, plus the `timeline` of what changed. |
| `media` | The social posts behind the story, most travelled first: each post's `platform` (`tiktok`, `instagram`, `facebook`, `threads`, `reddit`, `snapchat`, `trends` for Google Trends, `kym` for Know Your Meme, `youtube` for YouTube Shorts, `x`, `twitch` for Twitch clips), `label`, `author`, `url`, `published_at`, the platform's own `views`, `likes`, `shares` and `comments` as Kelly last saw them (null when the platform shows none), and `embed_url`, the platform's own player for the post, or null where you show a link instead. A list carries three; the story read carries every one. A post's caption never appears. |

Analyst-pick counts ("new analyst picks today") reach signed-in readers only, and never go on Kelly Wire.

## Top and Latest

`sort=top` (the default) orders stories by Kelly's score for each story, which weighs how much the event matters, how many outlets reported it and how recent it is. `sort=latest` is newest first. `type` keeps `fantasy` or `betting` stories, or `buzz`: stories with at least one social post in `media` (`viral`, its first name, still works); `competition` takes up to 20 slugs, comma-separated (`nfl,ncaaf`), because Kelly refuses a repeated query parameter. `team`, `player`, `source` (one outlet's `source_id`), `q` (words in the headline and summary) and `since` narrow further. `date` (YYYY-MM-DD) keeps one day's stories, the day local to `tz` (an IANA zone, `America/New_York` by default): Kelly keeps every story, so any past day reads, and days before Feed began have none. `counts` gives each competition's stories over the last 72 hours, or on the chosen day, for your type filter. `days` is a day strip: seven days around `date` (today by default, never past today), oldest first, each with its stories under every filter but `date`. Following a team adds its league in Settings, so `scope=following` and the personal order read such a league as that team's stories; a league followed with no team reads whole.

## Buzz

`GET /v1/buzz` is the shareable side of sports, one post per row: the clips, memes and posts fantasy players and bettors are passing around, as askkelly.ai/buzz shows them. News is Feed's: a post that reads as an injury, trade, signing, release, suspension, lineup or industry item, or comes from a news account, is not in Buzz. Each post has its `format` (`video`, `image`, `post` or `search` for a Google Trends search), its platform and author, its page (`url`), `embed_url` (the platform's own player, or null for a link), when it was posted, the platform's own `views`, `likes`, `shares` and `comments` (null when the platform shows none), its `competition`, the Feed `story` it belongs to in Kelly's words (null for most posts, which belong to none), and `share_url`, its page on askkelly.ai, which plays the post first. Kelly never serves a post's caption or a copy of its media.

Posts posted in the last seven days are listed. `sort=top` (the default) puts the fastest travelling first: each post's engagement (likes, with comments and shares weighted higher; views when a platform gives none of those) over its platform's typical post this week, per hour since it was posted, so a post that's big for Reddit can rank above an average TikTok. Platforms are mixed: posts are ordered first by their place among their own platform's posts, so every platform's hottest post leads and no platform fills the page; `sort=latest` is newest first. `competition` (up to 20 slugs), `platform` (comma-separated) and `format` narrow it. `counts` gives every post in the window per competition, platform and format, unfiltered, for chips. Pages follow `next_cursor`; a post arriving while you page can appear on two pages, and none is skipped. `GET /v1/buzz/{post_id}` reads one post, and is `not_found` once its story is hidden or removed. In an AI app, `get_news` with `buzz: true` returns the same list and `post_id` one post.

## Sources

Feed also searches social platforms for the posts fantasy and betting fans share: TikTok and Instagram hashtags, sports and betting pages on Facebook, Threads and Snapchat searches, fantasy and betting subreddits, Google Trends' trending sports searches and Know Your Meme's newest entries. A post joins the story it is about, and the most travelled ones start stories of their own, so `media` shows where a story is spreading. These platforms are sources too, with `kind` `platform` on the list below.

`GET /v1/news/sources` lists every source Feed reads: each outlet once, with all its feeds grouped (CBS Sports' NFL, NBA and college feeds are one source, `cbs-sports`), and Kelly's own reports (injury report changes and line moves) as `kelly`. Each carries its name and site, the competitions its feeds cover (empty when it covers every sport), its `tier` (1 for a primary source), its `state` and how many published stories it gave in the last 72 hours. `state` is `active`, `titles_only` (the outlet's site blocks AI crawlers, so Kelly only notes that a story exists) or `paused`. Pass a `source_id` as `source` on `GET /v1/news` to read one outlet's stories. The list is keyless and costs one credit.

## For you

`GET /v1/me/news` takes the same filters for your Kelly account and needs `read:tracker`. Top puts the teams and sports you follow and the players on your connected league teams first. `scope=following` keeps only what you follow; `scope=leagues` keeps only your league players.

## Paging

Each page carries `next_cursor` until the last. Send it back with the same filters for the next page: a story that arrives while you page never repeats or skips one. A cursor sent with different filters is `invalid_request`.

## Live

Subscribe to `news:{competition}` (`news:nfl`) or `news:all` on [Kelly Wire](/concepts/streaming). The snapshot is the latest story; each delta is `story.created`, `story.updated` (a new fact or rewritten headline) or `story.removed` (drop it). Both topics are free and need no plan. Paint from `GET /v1/news`, then apply deltas.

## In an AI app

Kelly MCP's `get_news` takes the same filters, or `story_id` for one story with its timeline, or `sources: true` for the list of sources. On a signed-in connection its Top list leans toward what you follow, and `scope` works as on the API.

## Reporting a problem

`POST /v1/news/{story_id}/report` with `{"reason": …}` tells Kelly something is wrong with a story: `wrong_tag` (the fantasy or betting tag), `wrong_entity` (the team or player), `wrong_fact`, `not_news` or `duplicate` (the same story as another). It answers `202` with `object: news_report` once the report is in Kelly's review queue. It is free and works with or without a credential; with one, the same open report from your account is kept once. Kelly MCP's `report_news_story` does the same on the premium paths, and the "Something's wrong" control on a story's page on askkelly.ai sends the same report.

## Errors

The routes answer `invalid_request` for a bad filter, cursor or reason, `not_found` for a story that isn't published, and `service_unavailable` while Feed is off. See [errors](/concepts/errors).

---

Last updated October 26, 2026

Support: support@askkelly.ai · Security and disclosure: https://docs.askkelly.ai/security

Data is the edge. Odds are information, not advice · 21+ · Get help
