Reading the news
Copy page
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 storyLink to this section
| 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 LatestLink to this section
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.
BuzzLink to this section
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.
SourcesLink to this section
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 youLink to this section
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.
PagingLink to this section
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.
LiveLink to this section
Subscribe to news:{competition} (news:nfl) or news:all on Kelly Wire. 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 appLink to this section
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 problemLink to this section
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.
ErrorsLink to this section
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.