news
Copy page
Read Feed's sports stories, sorted for fantasy and betting, in Kelly's own words with links to every outlet that reported them.
On this page
- Report a problem with a story
- Parameters
- Response
- Errors
- Example
- List news stories
- Parameters
- Response
- Errors
- Example
- List Feed's sources
- Response
- Errors
- Example
- Get a news story
- Parameters
- Response
- Errors
- Example
- List Buzz posts
- Parameters
- Response
- Errors
- Example
- Get a Buzz post
- Parameters
- Response
- Errors
- Example
- List news for you
- Parameters
- Response
- Errors
- Example
| Method | Path | Title | Access | Price | MCP tool |
|---|---|---|---|---|---|
| POST | /v1/news/{story_id}/report | Report a problem with a story | public | 0 | report_news_story |
| GET | /v1/news | List news stories | public | 1 | get_news |
| GET | /v1/news/sources | List Feed's sources | public | 1 | get_news |
| GET | /v1/news/{story_id} | Get a news story | public | 1 | get_news |
| GET | /v1/buzz | List Buzz posts | public | 1 | get_news |
| GET | /v1/buzz/{post_id} | Get a Buzz post | public | 1 | get_news |
| GET | /v1/me/news | List news for you | read:tracker | 1 | get_news |
POST /v1/news/{story_id}/report
Report a problem with a storyLink to this section
public, no key needed · 0 credits, not charged during the beta · MCP tool report_news_story · status live
Tells Kelly something is wrong with a story: a wrong fantasy or betting tag, the wrong team or player, a wrong fact, not news, or the same story as another. It goes to Kelly's review queue, and the same open report from one account is kept once. Free, with or without a credential.
ParametersLink to this section
story_idstring · pathrequiredThe story's ID (nsty_…).
pattern ^nsty_[0123456789abcdefghjkmnpqrstvwxyz]{20}$
Body, application/json (required):
reasonstringWhat is wrong: wrong_tag (the fantasy or betting tag), wrong_entity (the team or player), wrong_fact (a fact), not_news, or duplicate (the same story as another).
One of: wrong_tag, wrong_entity, wrong_fact, not_news, duplicate (open: new values may be added).
ResponseLink to this section
202 The report is in the review queue.
objectconstrequiredAlways news_report.
Always "news_report".
story_idstringrequiredThe story reported.
pattern ^nsty_[0123456789abcdefghjkmnpqrstvwxyz]{20}$
reasonstringrequiredWhat is wrong, as sent.
One of: wrong_tag, wrong_entity, wrong_fact, not_news, duplicate (open: new values may be added).
as_ofstringrequiredWhen the value was true; for a derived value, its newest input's time.
format date-time
sourcestringrequiredWho produced the value, as shown to readers.
min length 1
attributionstringnullableAttribution the source's terms require.
request_idstringrequirednullableThe request that produced this response.
live_topicsarray of stringKelly Wire topics that update this resource (API and cards only).
rg_linestringnullableThe cost line (COMP-1, D19) on every resource and result that touches wagering: one engine-computed cost fact, or the short form, plus 21+ and the helpline. Show it with the value. Null on resources that don't touch wagering.
ErrorsLink to this section
invalid_request · credential_in_url · unsupported_api_version · unauthenticated · method_not_allowed · rate_limited · internal_error · service_unavailable · payload_too_large · not_found
ExampleLink to this section
POST https://api.askkelly.ai/v1/news/nsty_rz6m1tg40v3amrktkzx7/report
Content-Type: application/json{
"reason": "wrong_fact"
}
{
"object": "news_report",
"story_id": "nsty_rz6m1tg40v3amrktkzx7",
"reason": "wrong_fact",
"as_of": "2026-10-04T17:30:00Z",
"source": "kelly",
"attribution": null,
"request_id": "req_6873eca2f618af28153e61f9",
"live_topics": [],
"rg_line": null
}- kelly · as of 2026-10-04T17:30:00Z
POST https://api.askkelly.ai/v1/news/nsty_rz6m1tg40v3amrktkzx7/report
Content-Type: application/json{
"reason": "boring"
}
{
"type": "https://docs.askkelly.ai/problems/invalid_request",
"title": "Invalid request",
"status": 400,
"code": "invalid_request",
"detail": "reason must be one of wrong_tag, wrong_entity, wrong_fact, not_news, duplicate.",
"param": "reason",
"doc_url": "https://docs.askkelly.ai/problems/invalid_request",
"request_id": "req_50375ecb97ba08ca5bf648c1",
"retryable": false,
"display_message": "Something in that request was not understood."
}GET /v1/news
List news storiesLink to this section
public, no key needed · 1 credit, not charged during the beta · MCP tool get_news · status live
Sports stories as Kelly tells them, Top (Kelly's ranking of importance, freshness and coverage) or Latest: Kelly's own headline and summary, whether it bears on fantasy, betting or both, the players, teams and game it is about, the IDs its live card streams, and each outlet that reported it with a link. Filter by type, competitions, a team, a player, words or time; counts gives each competition's stories over the last 72 hours. Keyless, like every read.
ParametersLink to this section
typestring · queryall (default), fantasy or betting.
One of: all, fantasy, betting, buzz, viral (open: new values may be added).
default "all"
competitionstring · queryOnly these competitions: up to 20 slugs, comma-separated (nfl,ncaaf).
pattern ^[a-z0-9][a-z0-9_]{0,40}(,[a-z0-9][a-z0-9_]{0,40}){0,19}$ · max length 400
teamstring · queryOnly stories about this team (tm_…).
pattern ^tm_[0123456789abcdefghjkmnpqrstvwxyz]{20}$
playerstring · queryOnly stories about this player (plr_…).
pattern ^plr_[0123456789abcdefghjkmnpqrstvwxyz]{20}$
qstring · queryOnly stories whose headline or summary match these words.
min length 2 · max length 100
sourcestring · queryOnly stories this source reported: a source_id from list_news_sources (cbs-sports, kelly).
pattern ^[a-z0-9][a-z0-9-]{0,79}$
sincestring · queryOnly stories first seen or changed at or after this time (RFC 3339, with offset).
format date-time
datestring · queryOnly stories first seen on this local day, YYYY-MM-DD. Stories are kept, so any past day reads; days before Feed began have none.
format date
tzstring · queryThe IANA time zone date and days are local to, such as Europe/London or UTC. Default: America/New_York.
pattern ^[A-Za-z][A-Za-z0-9_+\-]*(/[A-Za-z0-9_+\-]+){0,2}$ · min length 1 · max length 64 · default "America/New_York"
sortstring · querytop (default: Kelly's ranking) or latest (newest first).
One of: top, latest (open: new values may be added).
default "top"
cursorstring · querynext_cursor from the previous page, with the same filters.
min length 1 · max length 512
limitinteger · queryStories per page; default 25.
min 1 · max 100 · default 25
ResponseLink to this section
200 The stories.
objectconstrequiredAlways news_story_list.
Always "news_story_list".
storiesarray of objectrequiredThe stories, Top or Latest as asked.
Show 20 fields
story_idstringrequiredThe story's ID.
pattern ^nsty_[0123456789abcdefghjkmnpqrstvwxyz]{20}$
competitionstringrequirednullableThe competition's slug (nfl, nba, …), or null.
pattern ^[a-z0-9][a-z0-9_]{0,40}$
event_typestringrequiredWhat happened.
One of: injury, lineup, depth, transaction, trade, signing, release, suspension, line_move, weather, official, industry, picks_count, recap, feature, other (open: new values may be added).
headlinestringrequiredKelly's headline, at most 12 words.
summarystringrequirednullableKelly's summary, at most 30 words.
fantasybooleanrequiredWhether it bears on fantasy.
bettingbooleanrequiredWhether it bears on betting.
importanceintegerrequired1 (minor) to 4 (major): how much Kelly reads it to change.
min 1 · max 4
first_seen_atstringrequiredWhen Kelly first saw it (RFC 3339).
format date-time
updated_atstringrequiredWhen its fact last changed (RFC 3339).
format date-time
last_factstringrequirednullableThe latest fact in a few words, such as Status: doubtful → out.
gameone of several shapesrequiredThe game it bears on, or null.
entitiesarray of objectrequiredThe players first, then the teams.
Show 4 fields
kindstringrequiredplayer or team.
One of: player, team (open: new values may be added).
idstringrequirednullableKelly's ID (plr_ or tm_), or null when the name didn't resolve to exactly one player or team.
textstringrequiredThe name as the story gives it.
team_idstringnullableA player's team ID, when known (players only).
pattern ^tm_[0123456789abcdefghjkmnpqrstvwxyz]{20}$
cardobjectrequiredWhat the story's live card streams: Kelly IDs only, never a value. Subscribe to player:, game: and market: on Kelly Wire for the numbers.
Show 5 fields
kindstringrequiredThe card: injury, line_move, lineup, transaction, picks_count or none.
One of: injury, line_move, lineup, transaction, picks_count, none (open: new values may be added).
player_idstringThe player the card follows.
pattern ^plr_[0123456789abcdefghjkmnpqrstvwxyz]{20}$
team_idstringThe team the card follows.
pattern ^tm_[0123456789abcdefghjkmnpqrstvwxyz]{20}$
game_idstringThe game the card follows.
pattern ^gm_[0123456789abcdefghjkmnpqrstvwxyz]{20}$
market_idsarray of stringThe markets the card follows (mkt_…).
sourcesarray of objectrequiredUp to three outlets, Kelly's own report first, then the earliest.
Show 3 fields
outletstringrequiredThe publisher's name, or Official report or Kelly for Kelly's own reports.
urlstringrequirednullableThe outlet's page for the story, or null for Kelly's own reports.
format uri
source_idstringrequiredThe source's ID, as list_news_sources gives it and list_news' source takes it (kelly for Kelly's own reports).
pattern ^[a-z0-9][a-z0-9-]{0,79}$
sources_countintegerrequiredHow many outlets covered it.
min 0
mediaarray of objectrequiredUp to three social posts behind it, most travelled first (type buzz keeps the stories that have one).
Show 10 fields
platformstringrequiredWhere it was posted.
One of: tiktok, instagram, facebook, threads, reddit, snapchat, trends, kym, youtube, x, twitch (open: new values may be added).
labelstringrequiredThe platform's name (TikTok, Google Trends, …).
authorstringrequirednullableThe account's handle, without @.
urlstringrequiredThe post's page.
format uri
embed_urlstringrequirednullableThe platform's own player for the post (an iframe source), or null: show a link card.
format uri
published_atstringrequiredWhen it was posted (RFC 3339).
format date-time
viewsintegerrequirednullableThe platform's own view count as last swept, or null when it shows none.
min 0
likesintegerrequirednullableThe platform's own like (or upvote) count as last swept, or null when it shows none.
min 0
commentsintegerrequirednullableThe platform's own comment (or reply) count as last swept, or null when it shows none.
min 0
kelly_eventbooleanrequiredWhether Kelly's own data saw it first (an injury report change, a line move).
urlstringrequiredThe story's page on askkelly.ai.
format uri
has_morebooleanrequiredWhether another page follows.
next_cursorstringrequirednullablePass as cursor, with the same filters, for the next page.
countsobjectrequiredStories first seen per competition, under the type filter: in the last 72 hours, or on the chosen day with date.
daysarray of objectrequiredThe day strip: seven local days (in tz), oldest first, the chosen one (today by default) with three either side but never past today, each with its stories under every filter but date.
min items 7 · max items 7
Show 2 fields
datestringrequiredThe local day.
format date
storiesintegerrequiredStories first seen that day.
min 0
as_ofstringrequiredWhen the value was true; for a derived value, its newest input's time.
format date-time
sourcestringrequiredWho produced the value, as shown to readers.
min length 1
attributionstringnullableAttribution the source's terms require.
request_idstringrequirednullableThe request that produced this response.
live_topicsarray of stringKelly Wire topics that update this resource (API and cards only).
rg_linestringnullableThe cost line (COMP-1, D19) on every resource and result that touches wagering: one engine-computed cost fact, or the short form, plus 21+ and the helpline. Show it with the value. Null on resources that don't touch wagering.
ErrorsLink to this section
invalid_request · credential_in_url · unsupported_api_version · unauthenticated · method_not_allowed · rate_limited · internal_error · service_unavailable · quota_exhausted
ExampleLink to this section
GET https://api.askkelly.ai/v1/news?type=fantasy&competition=nfl&sort=latest{
"object": "news_story_list",
"stories": [
{
"story_id": "nsty_rz6m1tg40v3amrktkzx7",
"competition": "nfl",
"event_type": "injury",
"headline": "Example WR ruled out Sunday with a hamstring injury",
"summary": "Status: doubtful → out. He missed practice all week.",
"fantasy": true,
"betting": true,
"importance": 4,
"first_seen_at": "2026-10-04T14:30:00Z",
"updated_at": "2026-10-04T14:33:00Z",
"last_fact": "Status: doubtful → out",
"game": null,
"entities": [
{
"kind": "player",
"id": "plr_kjxy2gqd151037qxcaex",
"text": "Example WR",
"team_id": "tm_q0et25azpj0s0x1mn7kx"
},
{
"kind": "team",
"id": "tm_q0et25azpj0s0x1mn7kx",
"text": "Example Home"
}
],
"card": {
"kind": "injury",
"player_id": "plr_kjxy2gqd151037qxcaex",
"game_id": "gm_x3b02njrq190x6b8tkdf",
"market_ids": [
"mkt_11111111111111111111"
]
},
"sources": [
{
"outlet": "Official report",
"url": null,
"source_id": "kelly"
},
{
"outlet": "Example Wire",
"url": "https://example.com/a/1",
"source_id": "example-wire"
},
{
"outlet": "Sample Sports Daily",
"url": "https://example.org/b/1",
"source_id": "sample-sports-daily"
}
],
"sources_count": 3,
"media": [],
"kelly_event": true,
"url": "https://askkelly.ai/feed/nsty_rz6m1tg40v3amrktkzx7",
"share": {
"url": "https://askkelly.ai/feed/nsty_rz6m1tg40v3amrktkzx7",
"image": "https://askkelly.ai/feed/nsty_rz6m1tg40v3amrktkzx7/opengraph-image",
"title": "Example WR ruled out Sunday with a hamstring injury",
"text": "Example WR ruled out Sunday with a hamstring injury https://askkelly.ai/feed/nsty_rz6m1tg40v3amrktkzx7"
}
}
],
"next_cursor": null,
"counts": {
"nba": 1,
"nfl": 1
},
"days": [
{
"date": "2026-09-28",
"stories": 0
},
{
"date": "2026-09-29",
"stories": 0
},
{
"date": "2026-09-30",
"stories": 0
},
{
"date": "2026-10-01",
"stories": 0
},
{
"date": "2026-10-02",
"stories": 0
},
{
"date": "2026-10-03",
"stories": 0
},
{
"date": "2026-10-04",
"stories": 1
}
],
"has_more": false,
"as_of": "2026-10-04T14:33:00Z",
"source": "kelly",
"attribution": null,
"request_id": "req_e9e6c1c77b819056172d7259",
"live_topics": [],
"rg_line": null
}- kelly · as of 2026-10-04T14:33:00Z
GET https://api.askkelly.ai/v1/news?type=props{
"type": "https://docs.askkelly.ai/problems/invalid_request",
"title": "Invalid request",
"status": 400,
"code": "invalid_request",
"detail": "type: Input should be 'all', 'fantasy', 'betting', 'buzz' or 'viral'",
"param": "type",
"doc_url": "https://docs.askkelly.ai/problems/invalid_request",
"request_id": "req_866753dbfca1da40bfecbff1",
"retryable": false,
"display_message": "Something in that request was not understood."
}GET https://api.askkelly.ai/v1/news?date=2026-10-04&tz=Europe/London&limit=2{
"object": "news_story_list",
"stories": [
{
"story_id": "nsty_rz6m1tg40v3amrktkzx7",
"competition": "nfl",
"event_type": "injury",
"headline": "Example WR ruled out Sunday with a hamstring injury",
"summary": "Status: doubtful → out. He missed practice all week.",
"fantasy": true,
"betting": true,
"importance": 4,
"first_seen_at": "2026-10-04T14:30:00Z",
"updated_at": "2026-10-04T14:33:00Z",
"last_fact": "Status: doubtful → out",
"game": null,
"entities": [
{
"kind": "player",
"id": "plr_kjxy2gqd151037qxcaex",
"text": "Example WR",
"team_id": "tm_q0et25azpj0s0x1mn7kx"
},
{
"kind": "team",
"id": "tm_q0et25azpj0s0x1mn7kx",
"text": "Example Home"
}
],
"card": {
"kind": "injury",
"player_id": "plr_kjxy2gqd151037qxcaex",
"game_id": "gm_x3b02njrq190x6b8tkdf",
"market_ids": [
"mkt_11111111111111111111"
]
},
"sources": [
{
"outlet": "Official report",
"url": null,
"source_id": "kelly"
},
{
"outlet": "Example Wire",
"url": "https://example.com/a/1",
"source_id": "example-wire"
},
{
"outlet": "Sample Sports Daily",
"url": "https://example.org/b/1",
"source_id": "sample-sports-daily"
}
],
"sources_count": 3,
"media": [],
"kelly_event": true,
"url": "https://askkelly.ai/feed/nsty_rz6m1tg40v3amrktkzx7",
"share": {
"url": "https://askkelly.ai/feed/nsty_rz6m1tg40v3amrktkzx7",
"image": "https://askkelly.ai/feed/nsty_rz6m1tg40v3amrktkzx7/opengraph-image",
"title": "Example WR ruled out Sunday with a hamstring injury",
"text": "Example WR ruled out Sunday with a hamstring injury https://askkelly.ai/feed/nsty_rz6m1tg40v3amrktkzx7"
}
},
{
"story_id": "nsty_s4rbfh68svvwbyk588e8",
"competition": "nba",
"event_type": "trade",
"headline": "Example Guard traded in a three-team deal",
"summary": "The deal moves Example Guard to a contender.",
"fantasy": true,
"betting": false,
"importance": 3,
"first_seen_at": "2026-10-04T16:30:00Z",
"updated_at": "2026-10-04T16:30:00Z",
"last_fact": null,
"game": null,
"entities": [
{
"kind": "player",
"id": "plr_5eb6zhgw15ht3etv1bxh",
"text": "Example Guard",
"team_id": null
},
{
"kind": "player",
"id": null,
"text": "Example Unresolved",
"team_id": null
}
],
"card": {
"kind": "none"
},
"sources": [
{
"outlet": "Example Wire",
"url": "https://example.com/a/2",
"source_id": "example-wire"
}
],
"sources_count": 1,
"media": [],
"kelly_event": false,
"url": "https://askkelly.ai/feed/nsty_s4rbfh68svvwbyk588e8",
"share": {
"url": "https://askkelly.ai/feed/nsty_s4rbfh68svvwbyk588e8",
"image": "https://askkelly.ai/feed/nsty_s4rbfh68svvwbyk588e8/opengraph-image",
"title": "Example Guard traded in a three-team deal",
"text": "Example Guard traded in a three-team deal https://askkelly.ai/feed/nsty_s4rbfh68svvwbyk588e8"
}
}
],
"next_cursor": "eyJrIjpbIjgiLCJuc3R5X3M0cmJmaDY4c3Z2d2J5azU4OGU4Il0sImYiOiIzYzJiYjE4NTJhMTk5ZWVhIn0",
"counts": {
"nba": 1,
"nfl": 2
},
"days": [
{
"date": "2026-09-28",
"stories": 0
},
{
"date": "2026-09-29",
"stories": 0
},
{
"date": "2026-09-30",
"stories": 0
},
{
"date": "2026-10-01",
"stories": 0
},
{
"date": "2026-10-02",
"stories": 0
},
{
"date": "2026-10-03",
"stories": 0
},
{
"date": "2026-10-04",
"stories": 3
}
],
"has_more": true,
"as_of": "2026-10-04T16:30:00Z",
"source": "kelly",
"attribution": null,
"request_id": "req_84d1071debbd50261068a5a6",
"live_topics": [],
"rg_line": null
}- kelly · as of 2026-10-04T16:30:00Z
GET https://api.askkelly.ai/v1/news?source=example-wire{
"object": "news_story_list",
"stories": [
{
"story_id": "nsty_rz6m1tg40v3amrktkzx7",
"competition": "nfl",
"event_type": "injury",
"headline": "Example WR ruled out Sunday with a hamstring injury",
"summary": "Status: doubtful → out. He missed practice all week.",
"fantasy": true,
"betting": true,
"importance": 4,
"first_seen_at": "2026-10-04T14:30:00Z",
"updated_at": "2026-10-04T14:33:00Z",
"last_fact": "Status: doubtful → out",
"game": null,
"entities": [
{
"kind": "player",
"id": "plr_kjxy2gqd151037qxcaex",
"text": "Example WR",
"team_id": "tm_q0et25azpj0s0x1mn7kx"
},
{
"kind": "team",
"id": "tm_q0et25azpj0s0x1mn7kx",
"text": "Example Home"
}
],
"card": {
"kind": "injury",
"player_id": "plr_kjxy2gqd151037qxcaex",
"game_id": "gm_x3b02njrq190x6b8tkdf",
"market_ids": [
"mkt_11111111111111111111"
]
},
"sources": [
{
"outlet": "Official report",
"url": null,
"source_id": "kelly"
},
{
"outlet": "Example Wire",
"url": "https://example.com/a/1",
"source_id": "example-wire"
},
{
"outlet": "Sample Sports Daily",
"url": "https://example.org/b/1",
"source_id": "sample-sports-daily"
}
],
"sources_count": 3,
"media": [],
"kelly_event": true,
"url": "https://askkelly.ai/feed/nsty_rz6m1tg40v3amrktkzx7",
"share": {
"url": "https://askkelly.ai/feed/nsty_rz6m1tg40v3amrktkzx7",
"image": "https://askkelly.ai/feed/nsty_rz6m1tg40v3amrktkzx7/opengraph-image",
"title": "Example WR ruled out Sunday with a hamstring injury",
"text": "Example WR ruled out Sunday with a hamstring injury https://askkelly.ai/feed/nsty_rz6m1tg40v3amrktkzx7"
}
},
{
"story_id": "nsty_s4rbfh68svvwbyk588e8",
"competition": "nba",
"event_type": "trade",
"headline": "Example Guard traded in a three-team deal",
"summary": "The deal moves Example Guard to a contender.",
"fantasy": true,
"betting": false,
"importance": 3,
"first_seen_at": "2026-10-04T16:30:00Z",
"updated_at": "2026-10-04T16:30:00Z",
"last_fact": null,
"game": null,
"entities": [
{
"kind": "player",
"id": "plr_5eb6zhgw15ht3etv1bxh",
"text": "Example Guard",
"team_id": null
},
{
"kind": "player",
"id": null,
"text": "Example Unresolved",
"team_id": null
}
],
"card": {
"kind": "none"
},
"sources": [
{
"outlet": "Example Wire",
"url": "https://example.com/a/2",
"source_id": "example-wire"
}
],
"sources_count": 1,
"media": [],
"kelly_event": false,
"url": "https://askkelly.ai/feed/nsty_s4rbfh68svvwbyk588e8",
"share": {
"url": "https://askkelly.ai/feed/nsty_s4rbfh68svvwbyk588e8",
"image": "https://askkelly.ai/feed/nsty_s4rbfh68svvwbyk588e8/opengraph-image",
"title": "Example Guard traded in a three-team deal",
"text": "Example Guard traded in a three-team deal https://askkelly.ai/feed/nsty_s4rbfh68svvwbyk588e8"
}
}
],
"next_cursor": null,
"counts": {
"nba": 1,
"nfl": 2
},
"days": [
{
"date": "2026-09-28",
"stories": 0
},
{
"date": "2026-09-29",
"stories": 0
},
{
"date": "2026-09-30",
"stories": 0
},
{
"date": "2026-10-01",
"stories": 0
},
{
"date": "2026-10-02",
"stories": 0
},
{
"date": "2026-10-03",
"stories": 0
},
{
"date": "2026-10-04",
"stories": 2
}
],
"has_more": false,
"as_of": "2026-10-04T16:30:00Z",
"source": "kelly",
"attribution": null,
"request_id": "req_65b53bf7f13a28438d2a0685",
"live_topics": [],
"rg_line": null
}- kelly · as of 2026-10-04T16:30:00Z
GET https://api.askkelly.ai/v1/news?limit=2{
"object": "news_story_list",
"stories": [
{
"story_id": "nsty_rz6m1tg40v3amrktkzx7",
"competition": "nfl",
"event_type": "injury",
"headline": "Example WR ruled out Sunday with a hamstring injury",
"summary": "Status: doubtful → out. He missed practice all week.",
"fantasy": true,
"betting": true,
"importance": 4,
"first_seen_at": "2026-10-04T14:30:00Z",
"updated_at": "2026-10-04T14:33:00Z",
"last_fact": "Status: doubtful → out",
"game": null,
"entities": [
{
"kind": "player",
"id": "plr_kjxy2gqd151037qxcaex",
"text": "Example WR",
"team_id": "tm_q0et25azpj0s0x1mn7kx"
},
{
"kind": "team",
"id": "tm_q0et25azpj0s0x1mn7kx",
"text": "Example Home"
}
],
"card": {
"kind": "injury",
"player_id": "plr_kjxy2gqd151037qxcaex",
"game_id": "gm_x3b02njrq190x6b8tkdf",
"market_ids": [
"mkt_11111111111111111111"
]
},
"sources": [
{
"outlet": "Official report",
"url": null,
"source_id": "kelly"
},
{
"outlet": "Example Wire",
"url": "https://example.com/a/1",
"source_id": "example-wire"
},
{
"outlet": "Sample Sports Daily",
"url": "https://example.org/b/1",
"source_id": "sample-sports-daily"
}
],
"sources_count": 3,
"media": [],
"kelly_event": true,
"url": "https://askkelly.ai/feed/nsty_rz6m1tg40v3amrktkzx7",
"share": {
"url": "https://askkelly.ai/feed/nsty_rz6m1tg40v3amrktkzx7",
"image": "https://askkelly.ai/feed/nsty_rz6m1tg40v3amrktkzx7/opengraph-image",
"title": "Example WR ruled out Sunday with a hamstring injury",
"text": "Example WR ruled out Sunday with a hamstring injury https://askkelly.ai/feed/nsty_rz6m1tg40v3amrktkzx7"
}
},
{
"story_id": "nsty_s4rbfh68svvwbyk588e8",
"competition": "nba",
"event_type": "trade",
"headline": "Example Guard traded in a three-team deal",
"summary": "The deal moves Example Guard to a contender.",
"fantasy": true,
"betting": false,
"importance": 3,
"first_seen_at": "2026-10-04T16:30:00Z",
"updated_at": "2026-10-04T16:30:00Z",
"last_fact": null,
"game": null,
"entities": [
{
"kind": "player",
"id": "plr_5eb6zhgw15ht3etv1bxh",
"text": "Example Guard",
"team_id": null
},
{
"kind": "player",
"id": null,
"text": "Example Unresolved",
"team_id": null
}
],
"card": {
"kind": "none"
},
"sources": [
{
"outlet": "Example Wire",
"url": "https://example.com/a/2",
"source_id": "example-wire"
}
],
"sources_count": 1,
"media": [],
"kelly_event": false,
"url": "https://askkelly.ai/feed/nsty_s4rbfh68svvwbyk588e8",
"share": {
"url": "https://askkelly.ai/feed/nsty_s4rbfh68svvwbyk588e8",
"image": "https://askkelly.ai/feed/nsty_s4rbfh68svvwbyk588e8/opengraph-image",
"title": "Example Guard traded in a three-team deal",
"text": "Example Guard traded in a three-team deal https://askkelly.ai/feed/nsty_s4rbfh68svvwbyk588e8"
}
}
],
"next_cursor": "eyJrIjpbIjgiLCJuc3R5X3M0cmJmaDY4c3Z2d2J5azU4OGU4Il0sImYiOiIyYTQ1YjNhNDJkYzZlMDFhIn0",
"counts": {
"nba": 1,
"nfl": 2
},
"days": [
{
"date": "2026-09-28",
"stories": 0
},
{
"date": "2026-09-29",
"stories": 0
},
{
"date": "2026-09-30",
"stories": 0
},
{
"date": "2026-10-01",
"stories": 0
},
{
"date": "2026-10-02",
"stories": 0
},
{
"date": "2026-10-03",
"stories": 0
},
{
"date": "2026-10-04",
"stories": 3
}
],
"has_more": true,
"as_of": "2026-10-04T16:30:00Z",
"source": "kelly",
"attribution": null,
"request_id": "req_fa29e9046b512be4b7c155eb",
"live_topics": [],
"rg_line": null
}- kelly · as of 2026-10-04T16:30:00Z
GET /v1/news/sources
List Feed's sourcesLink to this section
public, no key needed · 1 credit, not charged during the beta · MCP tool get_news · status live
Every source Feed reads: each outlet (its feeds grouped as one source) and Kelly's own reports, with its competitions, its state (active, titles_only when the site blocks AI crawlers, or paused), its newest item's time and how many published stories it gave in the last 72 hours. Pass a source_id as list_news' source to keep only its stories. Keyless, like every read.
ResponseLink to this section
200 The sources.
objectconstrequiredAlways news_source_list.
Always "news_source_list".
sourcesarray of objectrequiredThe sources.
Show 10 fields
source_idstringrequiredThe source's ID: list_news' source takes it.
pattern ^[a-z0-9][a-z0-9-]{0,79}$
namestringrequiredThe outlet's name, or Kelly for Kelly's own reports.
kindstringrequiredoutlet, platform (a social platform Feed's sweeps search) or kelly.
One of: outlet, platform, kelly (open: new values may be added).
urlstringrequirednullableThe outlet's site, or null for Kelly.
format uri
competitionsarray of stringrequiredThe competitions its feeds are about (empty: every sport).
tierintegerrequired1 (a primary source) to 3.
min 1 · max 3
statestringrequiredactive; titles_only (its site blocks AI crawlers, so Kelly reads only that a story exists); or paused.
One of: active, titles_only, paused (open: new values may be added).
feedsintegerrequiredHow many of its feeds Kelly reads.
min 1
last_item_atstringrequirednullableWhen its newest item reached Kelly (RFC 3339).
format date-time
storiesintegerrequiredPublished stories it gave in the last 72 hours.
min 0
as_ofstringrequiredWhen the value was true; for a derived value, its newest input's time.
format date-time
sourcestringrequiredWho produced the value, as shown to readers.
min length 1
attributionstringnullableAttribution the source's terms require.
request_idstringrequirednullableThe request that produced this response.
live_topicsarray of stringKelly Wire topics that update this resource (API and cards only).
rg_linestringnullableThe cost line (COMP-1, D19) on every resource and result that touches wagering: one engine-computed cost fact, or the short form, plus 21+ and the helpline. Show it with the value. Null on resources that don't touch wagering.
ErrorsLink to this section
invalid_request · credential_in_url · unsupported_api_version · unauthenticated · method_not_allowed · rate_limited · internal_error · service_unavailable · quota_exhausted
ExampleLink to this section
GET https://api.askkelly.ai/v1/news/sources{
"object": "news_source_list",
"sources": [
{
"source_id": "example-wire",
"name": "Example Wire",
"kind": "outlet",
"url": "https://example.com",
"competitions": [],
"tier": 1,
"state": "active",
"feeds": 1,
"last_item_at": null,
"stories": 2
},
{
"source_id": "kelly",
"name": "Kelly",
"kind": "kelly",
"url": null,
"competitions": [],
"tier": 1,
"state": "active",
"feeds": 1,
"last_item_at": null,
"stories": 2
},
{
"source_id": "sample-sports-daily",
"name": "Sample Sports Daily",
"kind": "outlet",
"url": "https://example.org",
"competitions": [],
"tier": 1,
"state": "active",
"feeds": 1,
"last_item_at": null,
"stories": 1
}
],
"as_of": "2026-10-04T17:30:00Z",
"source": "kelly",
"attribution": null,
"request_id": "req_bb00f11cd21e41d7c1e81006",
"live_topics": [],
"rg_line": null
}- kelly · as of 2026-10-04T17:30:00Z
GET /v1/news/{story_id}
Get a news storyLink to this section
public, no key needed · 1 credit, not charged during the beta · MCP tool get_news · status live
One story as list_news returns it, with every outlet that reported it and its timeline: each fact as it changed. A story taken down is not_found.
ParametersLink to this section
story_idstring · pathrequiredThe story's ID (nsty_…).
pattern ^nsty_[0123456789abcdefghjkmnpqrstvwxyz]{20}$
ResponseLink to this section
200 The story.
objectconstrequiredAlways news_story.
Always "news_story".
story_idstringrequiredThe story's ID.
pattern ^nsty_[0123456789abcdefghjkmnpqrstvwxyz]{20}$
competitionstringrequirednullableThe competition's slug (nfl, nba, …), or null.
pattern ^[a-z0-9][a-z0-9_]{0,40}$
event_typestringrequiredWhat happened.
One of: injury, lineup, depth, transaction, trade, signing, release, suspension, line_move, weather, official, industry, picks_count, recap, feature, other (open: new values may be added).
headlinestringrequiredKelly's headline, at most 12 words.
summarystringrequirednullableKelly's summary, at most 30 words.
fantasybooleanrequiredWhether it bears on fantasy.
bettingbooleanrequiredWhether it bears on betting.
importanceintegerrequired1 (minor) to 4 (major): how much Kelly reads it to change.
min 1 · max 4
first_seen_atstringrequiredWhen Kelly first saw it (RFC 3339).
format date-time
updated_atstringrequiredWhen its fact last changed (RFC 3339).
format date-time
last_factstringrequirednullableThe latest fact in a few words, such as Status: doubtful → out.
gameone of several shapesrequiredThe game it bears on, or null.
entitiesarray of objectrequiredThe players first, then the teams.
Show 4 fields
kindstringrequiredplayer or team.
One of: player, team (open: new values may be added).
idstringrequirednullableKelly's ID (plr_ or tm_), or null when the name didn't resolve to exactly one player or team.
textstringrequiredThe name as the story gives it.
team_idstringnullableA player's team ID, when known (players only).
pattern ^tm_[0123456789abcdefghjkmnpqrstvwxyz]{20}$
cardobjectrequiredWhat the story's live card streams: Kelly IDs only, never a value. Subscribe to player:, game: and market: on Kelly Wire for the numbers.
Show 5 fields
kindstringrequiredThe card: injury, line_move, lineup, transaction, picks_count or none.
One of: injury, line_move, lineup, transaction, picks_count, none (open: new values may be added).
player_idstringThe player the card follows.
pattern ^plr_[0123456789abcdefghjkmnpqrstvwxyz]{20}$
team_idstringThe team the card follows.
pattern ^tm_[0123456789abcdefghjkmnpqrstvwxyz]{20}$
game_idstringThe game the card follows.
pattern ^gm_[0123456789abcdefghjkmnpqrstvwxyz]{20}$
market_idsarray of stringThe markets the card follows (mkt_…).
sourcesarray of objectrequiredEvery outlet, Kelly's own report first, then the earliest.
Show 3 fields
outletstringrequiredThe publisher's name, or Official report or Kelly for Kelly's own reports.
urlstringrequirednullableThe outlet's page for the story, or null for Kelly's own reports.
format uri
source_idstringrequiredThe source's ID, as list_news_sources gives it and list_news' source takes it (kelly for Kelly's own reports).
pattern ^[a-z0-9][a-z0-9-]{0,79}$
sources_countintegerrequiredHow many outlets covered it.
min 0
mediaarray of objectrequiredEvery social post behind it, most travelled first.
Show 10 fields
platformstringrequiredWhere it was posted.
One of: tiktok, instagram, facebook, threads, reddit, snapchat, trends, kym, youtube, x, twitch (open: new values may be added).
labelstringrequiredThe platform's name (TikTok, Google Trends, …).
authorstringrequirednullableThe account's handle, without @.
urlstringrequiredThe post's page.
format uri
embed_urlstringrequirednullableThe platform's own player for the post (an iframe source), or null: show a link card.
format uri
published_atstringrequiredWhen it was posted (RFC 3339).
format date-time
viewsintegerrequirednullableThe platform's own view count as last swept, or null when it shows none.
min 0
likesintegerrequirednullableThe platform's own like (or upvote) count as last swept, or null when it shows none.
min 0
commentsintegerrequirednullableThe platform's own comment (or reply) count as last swept, or null when it shows none.
min 0
kelly_eventbooleanrequiredWhether Kelly's own data saw it first (an injury report change, a line move).
urlstringrequiredThe story's page on askkelly.ai.
format uri
timelinearray of objectrequiredEach fact as it changed, oldest first.
Show 2 fields
atstringrequiredWhen (RFC 3339).
format date-time
factstringrequiredThe fact.
as_ofstringrequiredWhen the value was true; for a derived value, its newest input's time.
format date-time
sourcestringrequiredWho produced the value, as shown to readers.
min length 1
attributionstringnullableAttribution the source's terms require.
request_idstringrequirednullableThe request that produced this response.
live_topicsarray of stringKelly Wire topics that update this resource (API and cards only).
rg_linestringnullableThe cost line (COMP-1, D19) on every resource and result that touches wagering: one engine-computed cost fact, or the short form, plus 21+ and the helpline. Show it with the value. Null on resources that don't touch wagering.
ErrorsLink to this section
invalid_request · credential_in_url · unsupported_api_version · unauthenticated · method_not_allowed · rate_limited · internal_error · service_unavailable · quota_exhausted · not_found
ExampleLink to this section
GET https://api.askkelly.ai/v1/news/nsty_22222222222222222222{
"type": "https://docs.askkelly.ai/problems/not_found",
"title": "Not found",
"status": 404,
"code": "not_found",
"detail": "No published story has that ID.",
"param": "story_id",
"doc_url": "https://docs.askkelly.ai/problems/not_found",
"request_id": "req_79b659d731d4d6156405ad25",
"retryable": false,
"display_message": "That could not be found."
}GET https://api.askkelly.ai/v1/news/nsty_rz6m1tg40v3amrktkzx7{
"object": "news_story",
"story_id": "nsty_rz6m1tg40v3amrktkzx7",
"competition": "nfl",
"event_type": "injury",
"headline": "Example WR ruled out Sunday with a hamstring injury",
"summary": "Status: doubtful → out. He missed practice all week.",
"fantasy": true,
"betting": true,
"importance": 4,
"first_seen_at": "2026-10-04T14:30:00Z",
"updated_at": "2026-10-04T14:33:00Z",
"last_fact": "Status: doubtful → out",
"game": null,
"entities": [
{
"kind": "player",
"id": "plr_kjxy2gqd151037qxcaex",
"text": "Example WR",
"team_id": "tm_q0et25azpj0s0x1mn7kx"
},
{
"kind": "team",
"id": "tm_q0et25azpj0s0x1mn7kx",
"text": "Example Home"
}
],
"card": {
"kind": "injury",
"player_id": "plr_kjxy2gqd151037qxcaex",
"game_id": "gm_x3b02njrq190x6b8tkdf",
"market_ids": [
"mkt_11111111111111111111"
]
},
"sources": [
{
"outlet": "Official report",
"url": null,
"source_id": "kelly"
},
{
"outlet": "Example Wire",
"url": "https://example.com/a/1",
"source_id": "example-wire"
},
{
"outlet": "Sample Sports Daily",
"url": "https://example.org/b/1",
"source_id": "sample-sports-daily"
}
],
"sources_count": 3,
"media": [],
"kelly_event": true,
"url": "https://askkelly.ai/feed/nsty_rz6m1tg40v3amrktkzx7",
"share": {
"url": "https://askkelly.ai/feed/nsty_rz6m1tg40v3amrktkzx7",
"image": "https://askkelly.ai/feed/nsty_rz6m1tg40v3amrktkzx7/opengraph-image",
"title": "Example WR ruled out Sunday with a hamstring injury",
"text": "Example WR ruled out Sunday with a hamstring injury https://askkelly.ai/feed/nsty_rz6m1tg40v3amrktkzx7"
},
"timeline": [
{
"at": "2026-10-04T14:30:00Z",
"fact": "Status: questionable → doubtful"
},
{
"at": "2026-10-04T14:33:00Z",
"fact": "Status: doubtful → out"
}
],
"as_of": "2026-10-04T14:33:00Z",
"source": "kelly",
"attribution": null,
"request_id": "req_d3bde195554cf8780003d40e",
"live_topics": [
"player:plr_kjxy2gqd151037qxcaex",
"game:gm_x3b02njrq190x6b8tkdf",
"market:mkt_11111111111111111111"
],
"rg_line": null
}- kelly · as of 2026-10-04T14:33:00Z
GET /v1/buzz
List Buzz postsLink to this section
public, no key needed · 1 credit, not charged during the beta · MCP tool get_news · status live
The social posts fantasy players and bettors are passing around (TikTok, Instagram, Facebook, Threads, Reddit, Snapchat, Google Trends, Know Your Meme), one per row, posted in the last seven days: each post's platform, format (video, image, post or search), author, page, the platform's own embed and counts, Kelly's headline for the story it belongs to, and its askkelly.ai link to share. Top (most travelled first, by the platform's own count) or Latest; filter by competitions, platforms and format; counts gives every post in the window per competition, platform and format. Keyless, like every read.
ParametersLink to this section
competitionstring · queryOnly these competitions: up to 20 slugs, comma-separated (nfl,ncaaf).
pattern ^[a-z0-9][a-z0-9_]{0,40}(,[a-z0-9][a-z0-9_]{0,40}){0,19}$ · max length 400
platformstring · queryOnly these platforms, comma-separated (tiktok,reddit).
pattern ^(tiktok|instagram|facebook|threads|reddit|snapchat|trends|kym|youtube|x|twitch)(,(tiktok|instagram|facebook|threads|reddit|snapchat|trends|kym|youtube|x|twitch)){0,10}$ · max length 120
teamstring · queryOnly posts that name this team or its players (tm_…, from search_sports).
pattern ^tm_[0123456789abcdefghjkmnpqrstvwxyz]{20}$
playerstring · queryOnly posts that name this player (plr_…, from search_sports).
pattern ^plr_[0123456789abcdefghjkmnpqrstvwxyz]{20}$
formatstring · queryall (default), video, image, post or search.
One of: all, video, image, post, search (open: new values may be added).
default "all"
sortstring · querytop (default: fastest travelling first, platforms mixed: each post's place among its own platform's posts, then engagement, likes with comments and shares weighted higher, over its platform's typical post this week, per hour since posting) or latest (newest first).
One of: top, latest (open: new values may be added).
default "top"
cursorstring · querynext_cursor from the previous page, with the same filters.
min length 1 · max length 512
limitinteger · queryPosts per page; default 24.
min 1 · max 100 · default 24
ResponseLink to this section
200 The posts.
objectconstrequiredAlways buzz_post_list.
Always "buzz_post_list".
postsarray of objectrequiredThe posts, Top or Latest as asked.
Show 20 fields
post_idstringrequiredThe post's ID on Kelly (nitm_…).
pattern ^nitm_[0123456789abcdefghjkmnpqrstvwxyz]{20}$
formatstringrequiredvideo, image, post or search (a Google Trends search).
One of: video, image, post, search (open: new values may be added).
platformstringrequiredWhere it was posted.
One of: tiktok, instagram, facebook, threads, reddit, snapchat, trends, kym, youtube, x, twitch (open: new values may be added).
labelstringrequiredThe platform's name (TikTok, Google Trends, …).
authorstringrequirednullableThe account's handle, without @.
urlstringrequiredThe post's page on its platform.
format uri
embed_urlstringrequirednullableThe platform's own player for the post (an iframe source), or null: show a link card.
format uri
poster_urlstringrequirednullableThe post's own preview picture on the platform's image host (TikTok, YouTube), to show before its player loads; load it from there, never copy it. Null: none.
format uri
published_atstringrequiredWhen it was posted (RFC 3339).
format date-time
viewsintegerrequirednullableThe platform's own view count as last swept, or null when it shows none.
min 0
likesintegerrequirednullableThe platform's own like (or upvote) count as last swept, or null when it shows none.
min 0
commentsintegerrequirednullableThe platform's own comment (or reply) count as last swept, or null when it shows none.
min 0
competitionstringrequirednullableThe competition's slug (its story's, else what the post names), or null.
pattern ^[a-z0-9][a-z0-9_]{0,40}$
competition_confidencenumberrequirednullableHow sure Kelly is of the competition, 0 to 1, from the names, accounts, page and words in the post (news.league); null when it came from the post's words alone.
min 0 · max 1
teamsarray of stringrequiredTeams the post names or whose players it names (tm_…; get_team reads one), in its competition.
max items 10
playersarray of stringrequiredPlayers the post names in full (plr_…; get_player reads one), in its competition.
max items 10
storyobjectrequirednullableThe Feed story the post belongs to, in Kelly's words, or null: most Buzz posts are in none (ADR-K263).
Show 5 fields
story_idstringrequiredThe story's ID: get_news_story reads it.
pattern ^nsty_[0123456789abcdefghjkmnpqrstvwxyz]{20}$
headlinestringrequiredKelly's headline, at most 12 words; never the post's caption.
summarystringrequirednullableKelly's summary, at most 30 words.
competitionstringrequirednullableThe competition's slug, or null.
pattern ^[a-z0-9][a-z0-9_]{0,40}$
urlstringrequiredThe story's page on askkelly.ai.
format uri
has_morebooleanrequiredWhether another page follows.
next_cursorstringrequirednullablePass as cursor, with the same filters, for the next page.
countsobjectrequiredEvery post in the last seven days, unfiltered: the page's chips.
Show 4 fields
postsintegerrequiredAll of them.
min 0
competitionsobjectrequiredPosts per competition slug.
platformsobjectrequiredPosts per platform.
formatsobjectrequiredPosts per format.
as_ofstringrequiredWhen the value was true; for a derived value, its newest input's time.
format date-time
sourcestringrequiredWho produced the value, as shown to readers.
min length 1
attributionstringnullableAttribution the source's terms require.
request_idstringrequirednullableThe request that produced this response.
live_topicsarray of stringKelly Wire topics that update this resource (API and cards only).
rg_linestringnullableThe cost line (COMP-1, D19) on every resource and result that touches wagering: one engine-computed cost fact, or the short form, plus 21+ and the helpline. Show it with the value. Null on resources that don't touch wagering.
ErrorsLink to this section
invalid_request · credential_in_url · unsupported_api_version · unauthenticated · method_not_allowed · rate_limited · internal_error · service_unavailable · quota_exhausted
ExampleLink to this section
GET https://api.askkelly.ai/v1/buzz?platform=myspace{
"type": "https://docs.askkelly.ai/problems/invalid_request",
"title": "Invalid request",
"status": 400,
"code": "invalid_request",
"detail": "platform: Value error, platforms from tiktok, instagram, facebook, threads, reddit, snapchat, trends, kym, youtube, x, twitch, comma-separated",
"param": "platform",
"doc_url": "https://docs.askkelly.ai/problems/invalid_request",
"request_id": "req_120b78b9fa5d44ac10d6efeb",
"retryable": false,
"display_message": "Something in that request was not understood."
}GET https://api.askkelly.ai/v1/buzz{
"object": "buzz_post_list",
"posts": [
{
"post_id": "nitm_wv88n86fp6bz7j0g22rz",
"format": "post",
"platform": "reddit",
"label": "Reddit",
"author": "example_fan",
"url": "https://www.reddit.com/r/example/comments/ex1/example_post/",
"embed_url": "https://embed.reddit.com/r/example/comments/ex1/example_post/?embed=true",
"published_at": "2026-10-04T16:30:00Z",
"views": null,
"likes": 1200,
"shares": null,
"comments": 340,
"competition": "nba",
"competition_confidence": null,
"teams": [],
"players": [],
"story": null,
"poster_url": null,
"share_url": "https://askkelly.ai/buzz/nitm_wv88n86fp6bz7j0g22rz",
"share": {
"url": "https://askkelly.ai/buzz/nitm_wv88n86fp6bz7j0g22rz",
"image": "https://askkelly.ai/buzz/nitm_wv88n86fp6bz7j0g22rz/opengraph-image",
"title": "Reddit post by @example_fan",
"text": "Reddit post by @example_fan https://askkelly.ai/buzz/nitm_wv88n86fp6bz7j0g22rz"
}
}
],
"next_cursor": null,
"counts": {
"posts": 1,
"competitions": {
"nba": 1
},
"platforms": {
"reddit": 1
},
"formats": {
"post": 1
}
},
"has_more": false,
"as_of": "2026-10-04T16:30:00Z",
"source": "kelly",
"attribution": null,
"request_id": "req_b87b6d5ec42326296013208b",
"live_topics": [],
"rg_line": null
}- kelly · as of 2026-10-04T16:30:00Z
GET /v1/buzz/{post_id}
Get a Buzz postLink to this section
public, no key needed · 1 credit, not charged during the beta · MCP tool get_news · status live
One post as list_buzz returns it. A post whose story is no longer published is not_found.
ParametersLink to this section
post_idstring · pathrequiredThe post's ID (nitm_…).
pattern ^nitm_[0123456789abcdefghjkmnpqrstvwxyz]{20}$
ResponseLink to this section
200 The post.
objectconstrequiredAlways buzz_post.
Always "buzz_post".
post_idstringrequiredThe post's ID on Kelly (nitm_…).
pattern ^nitm_[0123456789abcdefghjkmnpqrstvwxyz]{20}$
formatstringrequiredvideo, image, post or search (a Google Trends search).
One of: video, image, post, search (open: new values may be added).
platformstringrequiredWhere it was posted.
One of: tiktok, instagram, facebook, threads, reddit, snapchat, trends, kym, youtube, x, twitch (open: new values may be added).
labelstringrequiredThe platform's name (TikTok, Google Trends, …).
authorstringrequirednullableThe account's handle, without @.
urlstringrequiredThe post's page on its platform.
format uri
embed_urlstringrequirednullableThe platform's own player for the post (an iframe source), or null: show a link card.
format uri
poster_urlstringrequirednullableThe post's own preview picture on the platform's image host (TikTok, YouTube), to show before its player loads; load it from there, never copy it. Null: none.
format uri
published_atstringrequiredWhen it was posted (RFC 3339).
format date-time
viewsintegerrequirednullableThe platform's own view count as last swept, or null when it shows none.
min 0
likesintegerrequirednullableThe platform's own like (or upvote) count as last swept, or null when it shows none.
min 0
commentsintegerrequirednullableThe platform's own comment (or reply) count as last swept, or null when it shows none.
min 0
competitionstringrequirednullableThe competition's slug (its story's, else what the post names), or null.
pattern ^[a-z0-9][a-z0-9_]{0,40}$
competition_confidencenumberrequirednullableHow sure Kelly is of the competition, 0 to 1, from the names, accounts, page and words in the post (news.league); null when it came from the post's words alone.
min 0 · max 1
teamsarray of stringrequiredTeams the post names or whose players it names (tm_…; get_team reads one), in its competition.
max items 10
playersarray of stringrequiredPlayers the post names in full (plr_…; get_player reads one), in its competition.
max items 10
storyobjectrequirednullableThe Feed story the post belongs to, in Kelly's words, or null: most Buzz posts are in none (ADR-K263).
Show 5 fields
story_idstringrequiredThe story's ID: get_news_story reads it.
pattern ^nsty_[0123456789abcdefghjkmnpqrstvwxyz]{20}$
headlinestringrequiredKelly's headline, at most 12 words; never the post's caption.
summarystringrequirednullableKelly's summary, at most 30 words.
competitionstringrequirednullableThe competition's slug, or null.
pattern ^[a-z0-9][a-z0-9_]{0,40}$
urlstringrequiredThe story's page on askkelly.ai.
format uri
as_ofstringrequiredWhen the value was true; for a derived value, its newest input's time.
format date-time
sourcestringrequiredWho produced the value, as shown to readers.
min length 1
attributionstringnullableAttribution the source's terms require.
request_idstringrequirednullableThe request that produced this response.
live_topicsarray of stringKelly Wire topics that update this resource (API and cards only).
rg_linestringnullableThe cost line (COMP-1, D19) on every resource and result that touches wagering: one engine-computed cost fact, or the short form, plus 21+ and the helpline. Show it with the value. Null on resources that don't touch wagering.
ErrorsLink to this section
invalid_request · credential_in_url · unsupported_api_version · unauthenticated · method_not_allowed · rate_limited · internal_error · service_unavailable · quota_exhausted · not_found
ExampleLink to this section
GET https://api.askkelly.ai/v1/buzz/nitm_22222222222222222222{
"type": "https://docs.askkelly.ai/problems/not_found",
"title": "Not found",
"status": 404,
"code": "not_found",
"detail": "No Buzz post has that ID.",
"param": "post_id",
"doc_url": "https://docs.askkelly.ai/problems/not_found",
"request_id": "req_3b923def35f437242e581985",
"retryable": false,
"display_message": "That could not be found."
}GET https://api.askkelly.ai/v1/buzz/nitm_wv88n86fp6bz7j0g22rz{
"object": "buzz_post",
"post_id": "nitm_wv88n86fp6bz7j0g22rz",
"format": "post",
"platform": "reddit",
"label": "Reddit",
"author": "example_fan",
"url": "https://www.reddit.com/r/example/comments/ex1/example_post/",
"embed_url": "https://embed.reddit.com/r/example/comments/ex1/example_post/?embed=true",
"published_at": "2026-10-04T16:30:00Z",
"views": null,
"likes": 1200,
"shares": null,
"comments": 340,
"competition": "nba",
"competition_confidence": null,
"teams": [],
"players": [],
"story": null,
"poster_url": null,
"share_url": "https://askkelly.ai/buzz/nitm_wv88n86fp6bz7j0g22rz",
"share": {
"url": "https://askkelly.ai/buzz/nitm_wv88n86fp6bz7j0g22rz",
"image": "https://askkelly.ai/buzz/nitm_wv88n86fp6bz7j0g22rz/opengraph-image",
"title": "Reddit post by @example_fan",
"text": "Reddit post by @example_fan https://askkelly.ai/buzz/nitm_wv88n86fp6bz7j0g22rz"
},
"as_of": "2026-10-04T16:30:00Z",
"source": "kelly",
"attribution": null,
"request_id": "req_07a3ca253f3b2cb018ef3001",
"live_topics": [],
"rg_line": null
}- kelly · as of 2026-10-04T16:30:00Z
GET /v1/me/news
List news for youLink to this section
scope read:tracker · 1 credit, not charged during the beta · MCP tool get_news · status live
list_news for your Kelly account: Top puts stories about the teams and competitions you follow and the players on your league teams first, and scope keeps only those (following) or only your league players (leagues).
ParametersLink to this section
typestring · queryall (default), fantasy or betting.
One of: all, fantasy, betting, buzz, viral (open: new values may be added).
default "all"
competitionstring · queryOnly these competitions: up to 20 slugs, comma-separated (nfl,ncaaf).
pattern ^[a-z0-9][a-z0-9_]{0,40}(,[a-z0-9][a-z0-9_]{0,40}){0,19}$ · max length 400
teamstring · queryOnly stories about this team (tm_…).
pattern ^tm_[0123456789abcdefghjkmnpqrstvwxyz]{20}$
playerstring · queryOnly stories about this player (plr_…).
pattern ^plr_[0123456789abcdefghjkmnpqrstvwxyz]{20}$
qstring · queryOnly stories whose headline or summary match these words.
min length 2 · max length 100
sourcestring · queryOnly stories this source reported: a source_id from list_news_sources (cbs-sports, kelly).
pattern ^[a-z0-9][a-z0-9-]{0,79}$
sincestring · queryOnly stories first seen or changed at or after this time (RFC 3339, with offset).
format date-time
datestring · queryOnly stories first seen on this local day, YYYY-MM-DD. Stories are kept, so any past day reads; days before Feed began have none.
format date
tzstring · queryThe IANA time zone date and days are local to, such as Europe/London or UTC. Default: America/New_York.
pattern ^[A-Za-z][A-Za-z0-9_+\-]*(/[A-Za-z0-9_+\-]+){0,2}$ · min length 1 · max length 64 · default "America/New_York"
sortstring · querytop (default: Kelly's ranking) or latest (newest first).
One of: top, latest (open: new values may be added).
default "top"
cursorstring · querynext_cursor from the previous page, with the same filters.
min length 1 · max length 512
limitinteger · queryStories per page; default 25.
min 1 · max 100 · default 25
scopestring · queryfollowing: only stories about the teams and competitions you follow; leagues: only stories about the players on your league teams. Without it, every story, yours first under Top.
One of: following, leagues (open: new values may be added).
ResponseLink to this section
200 The stories.
objectconstrequiredAlways news_story_list.
Always "news_story_list".
storiesarray of objectrequiredThe stories, Top or Latest as asked.
Show 20 fields
story_idstringrequiredThe story's ID.
pattern ^nsty_[0123456789abcdefghjkmnpqrstvwxyz]{20}$
competitionstringrequirednullableThe competition's slug (nfl, nba, …), or null.
pattern ^[a-z0-9][a-z0-9_]{0,40}$
event_typestringrequiredWhat happened.
One of: injury, lineup, depth, transaction, trade, signing, release, suspension, line_move, weather, official, industry, picks_count, recap, feature, other (open: new values may be added).
headlinestringrequiredKelly's headline, at most 12 words.
summarystringrequirednullableKelly's summary, at most 30 words.
fantasybooleanrequiredWhether it bears on fantasy.
bettingbooleanrequiredWhether it bears on betting.
importanceintegerrequired1 (minor) to 4 (major): how much Kelly reads it to change.
min 1 · max 4
first_seen_atstringrequiredWhen Kelly first saw it (RFC 3339).
format date-time
updated_atstringrequiredWhen its fact last changed (RFC 3339).
format date-time
last_factstringrequirednullableThe latest fact in a few words, such as Status: doubtful → out.
gameone of several shapesrequiredThe game it bears on, or null.
entitiesarray of objectrequiredThe players first, then the teams.
Show 4 fields
kindstringrequiredplayer or team.
One of: player, team (open: new values may be added).
idstringrequirednullableKelly's ID (plr_ or tm_), or null when the name didn't resolve to exactly one player or team.
textstringrequiredThe name as the story gives it.
team_idstringnullableA player's team ID, when known (players only).
pattern ^tm_[0123456789abcdefghjkmnpqrstvwxyz]{20}$
cardobjectrequiredWhat the story's live card streams: Kelly IDs only, never a value. Subscribe to player:, game: and market: on Kelly Wire for the numbers.
Show 5 fields
kindstringrequiredThe card: injury, line_move, lineup, transaction, picks_count or none.
One of: injury, line_move, lineup, transaction, picks_count, none (open: new values may be added).
player_idstringThe player the card follows.
pattern ^plr_[0123456789abcdefghjkmnpqrstvwxyz]{20}$
team_idstringThe team the card follows.
pattern ^tm_[0123456789abcdefghjkmnpqrstvwxyz]{20}$
game_idstringThe game the card follows.
pattern ^gm_[0123456789abcdefghjkmnpqrstvwxyz]{20}$
market_idsarray of stringThe markets the card follows (mkt_…).
sourcesarray of objectrequiredUp to three outlets, Kelly's own report first, then the earliest.
Show 3 fields
outletstringrequiredThe publisher's name, or Official report or Kelly for Kelly's own reports.
urlstringrequirednullableThe outlet's page for the story, or null for Kelly's own reports.
format uri
source_idstringrequiredThe source's ID, as list_news_sources gives it and list_news' source takes it (kelly for Kelly's own reports).
pattern ^[a-z0-9][a-z0-9-]{0,79}$
sources_countintegerrequiredHow many outlets covered it.
min 0
mediaarray of objectrequiredUp to three social posts behind it, most travelled first (type buzz keeps the stories that have one).
Show 10 fields
platformstringrequiredWhere it was posted.
One of: tiktok, instagram, facebook, threads, reddit, snapchat, trends, kym, youtube, x, twitch (open: new values may be added).
labelstringrequiredThe platform's name (TikTok, Google Trends, …).
authorstringrequirednullableThe account's handle, without @.
urlstringrequiredThe post's page.
format uri
embed_urlstringrequirednullableThe platform's own player for the post (an iframe source), or null: show a link card.
format uri
published_atstringrequiredWhen it was posted (RFC 3339).
format date-time
viewsintegerrequirednullableThe platform's own view count as last swept, or null when it shows none.
min 0
likesintegerrequirednullableThe platform's own like (or upvote) count as last swept, or null when it shows none.
min 0
commentsintegerrequirednullableThe platform's own comment (or reply) count as last swept, or null when it shows none.
min 0
kelly_eventbooleanrequiredWhether Kelly's own data saw it first (an injury report change, a line move).
urlstringrequiredThe story's page on askkelly.ai.
format uri
has_morebooleanrequiredWhether another page follows.
next_cursorstringrequirednullablePass as cursor, with the same filters, for the next page.
countsobjectrequiredStories first seen per competition, under the type filter: in the last 72 hours, or on the chosen day with date.
daysarray of objectrequiredThe day strip: seven local days (in tz), oldest first, the chosen one (today by default) with three either side but never past today, each with its stories under every filter but date.
min items 7 · max items 7
Show 2 fields
datestringrequiredThe local day.
format date
storiesintegerrequiredStories first seen that day.
min 0
as_ofstringrequiredWhen the value was true; for a derived value, its newest input's time.
format date-time
sourcestringrequiredWho produced the value, as shown to readers.
min length 1
attributionstringnullableAttribution the source's terms require.
request_idstringrequirednullableThe request that produced this response.
live_topicsarray of stringKelly Wire topics that update this resource (API and cards only).
rg_linestringnullableThe cost line (COMP-1, D19) on every resource and result that touches wagering: one engine-computed cost fact, or the short form, plus 21+ and the helpline. Show it with the value. Null on resources that don't touch wagering.
ErrorsLink to this section
invalid_request · credential_in_url · unsupported_api_version · unauthenticated · method_not_allowed · rate_limited · internal_error · service_unavailable · insufficient_scope · not_entitled
ExampleLink to this section
GET https://api.askkelly.ai/v1/me/news
Authorization: Bearer $KELLY_API_KEY{
"type": "https://docs.askkelly.ai/problems/insufficient_scope",
"title": "Insufficient scope",
"status": 403,
"code": "insufficient_scope",
"detail": "This needs the read:tracker scope.",
"param": "read:tracker",
"doc_url": "https://docs.askkelly.ai/problems/insufficient_scope",
"request_id": "req_948ff2651791043e6c76bcc1",
"retryable": false,
"display_message": "This app needs one more permission to do that."
}GET https://api.askkelly.ai/v1/me/news
Authorization: Bearer $KELLY_API_KEY{
"object": "news_story_list",
"stories": [
{
"story_id": "nsty_rz6m1tg40v3amrktkzx7",
"competition": "nfl",
"event_type": "injury",
"headline": "Example WR ruled out Sunday with a hamstring injury",
"summary": "Status: doubtful → out. He missed practice all week.",
"fantasy": true,
"betting": true,
"importance": 4,
"first_seen_at": "2026-10-04T14:30:00Z",
"updated_at": "2026-10-04T14:33:00Z",
"last_fact": "Status: doubtful → out",
"game": null,
"entities": [
{
"kind": "player",
"id": "plr_kjxy2gqd151037qxcaex",
"text": "Example WR",
"team_id": "tm_q0et25azpj0s0x1mn7kx"
},
{
"kind": "team",
"id": "tm_q0et25azpj0s0x1mn7kx",
"text": "Example Home"
}
],
"card": {
"kind": "injury",
"player_id": "plr_kjxy2gqd151037qxcaex",
"game_id": "gm_x3b02njrq190x6b8tkdf",
"market_ids": [
"mkt_11111111111111111111"
]
},
"sources": [
{
"outlet": "Official report",
"url": null,
"source_id": "kelly"
},
{
"outlet": "Example Wire",
"url": "https://example.com/a/1",
"source_id": "example-wire"
},
{
"outlet": "Sample Sports Daily",
"url": "https://example.org/b/1",
"source_id": "sample-sports-daily"
}
],
"sources_count": 3,
"media": [],
"kelly_event": true,
"url": "https://askkelly.ai/feed/nsty_rz6m1tg40v3amrktkzx7",
"share": {
"url": "https://askkelly.ai/feed/nsty_rz6m1tg40v3amrktkzx7",
"image": "https://askkelly.ai/feed/nsty_rz6m1tg40v3amrktkzx7/opengraph-image",
"title": "Example WR ruled out Sunday with a hamstring injury",
"text": "Example WR ruled out Sunday with a hamstring injury https://askkelly.ai/feed/nsty_rz6m1tg40v3amrktkzx7"
}
},
{
"story_id": "nsty_s4rbfh68svvwbyk588e8",
"competition": "nba",
"event_type": "trade",
"headline": "Example Guard traded in a three-team deal",
"summary": "The deal moves Example Guard to a contender.",
"fantasy": true,
"betting": false,
"importance": 3,
"first_seen_at": "2026-10-04T16:30:00Z",
"updated_at": "2026-10-04T16:30:00Z",
"last_fact": null,
"game": null,
"entities": [
{
"kind": "player",
"id": "plr_5eb6zhgw15ht3etv1bxh",
"text": "Example Guard",
"team_id": null
},
{
"kind": "player",
"id": null,
"text": "Example Unresolved",
"team_id": null
}
],
"card": {
"kind": "none"
},
"sources": [
{
"outlet": "Example Wire",
"url": "https://example.com/a/2",
"source_id": "example-wire"
}
],
"sources_count": 1,
"media": [],
"kelly_event": false,
"url": "https://askkelly.ai/feed/nsty_s4rbfh68svvwbyk588e8",
"share": {
"url": "https://askkelly.ai/feed/nsty_s4rbfh68svvwbyk588e8",
"image": "https://askkelly.ai/feed/nsty_s4rbfh68svvwbyk588e8/opengraph-image",
"title": "Example Guard traded in a three-team deal",
"text": "Example Guard traded in a three-team deal https://askkelly.ai/feed/nsty_s4rbfh68svvwbyk588e8"
}
},
{
"story_id": "nsty_1dfb41w7de063grj4jht",
"competition": "nfl",
"event_type": "line_move",
"headline": "Example Home spread moves past a key number",
"summary": null,
"fantasy": false,
"betting": true,
"importance": 3,
"first_seen_at": "2026-10-04T15:30:00Z",
"updated_at": "2026-10-04T15:30:00Z",
"last_fact": null,
"game": null,
"entities": [
{
"kind": "team",
"id": "tm_q0et25azpj0s0x1mn7kx",
"text": "Example Home"
}
],
"card": {
"kind": "line_move",
"game_id": "gm_x3b02njrq190x6b8tkdf",
"market_ids": [
"mkt_11111111111111111111"
]
},
"sources": [
{
"outlet": "Official report",
"url": null,
"source_id": "kelly"
}
],
"sources_count": 1,
"media": [],
"kelly_event": true,
"url": "https://askkelly.ai/feed/nsty_1dfb41w7de063grj4jht",
"share": {
"url": "https://askkelly.ai/feed/nsty_1dfb41w7de063grj4jht",
"image": "https://askkelly.ai/feed/nsty_1dfb41w7de063grj4jht/opengraph-image",
"title": "Example Home spread moves past a key number",
"text": "Example Home spread moves past a key number https://askkelly.ai/feed/nsty_1dfb41w7de063grj4jht"
}
},
{
"story_id": "nsty_tkwf582ntkt8enkrm6nm",
"competition": "nfl",
"event_type": "picks_count",
"headline": "New analyst picks today",
"summary": null,
"fantasy": false,
"betting": true,
"importance": 1,
"first_seen_at": "2026-10-04T17:00:00Z",
"updated_at": "2026-10-04T17:00:00Z",
"last_fact": null,
"game": null,
"entities": [],
"card": {
"kind": "picks_count"
},
"sources": [],
"sources_count": 1,
"media": [],
"kelly_event": false,
"url": "https://askkelly.ai/feed/nsty_tkwf582ntkt8enkrm6nm",
"share": {
"url": "https://askkelly.ai/feed/nsty_tkwf582ntkt8enkrm6nm",
"image": "https://askkelly.ai/feed/nsty_tkwf582ntkt8enkrm6nm/opengraph-image",
"title": "New analyst picks today",
"text": "New analyst picks today https://askkelly.ai/feed/nsty_tkwf582ntkt8enkrm6nm"
}
}
],
"next_cursor": null,
"counts": {
"nba": 1,
"nfl": 3
},
"days": [
{
"date": "2026-09-28",
"stories": 0
},
{
"date": "2026-09-29",
"stories": 0
},
{
"date": "2026-09-30",
"stories": 0
},
{
"date": "2026-10-01",
"stories": 0
},
{
"date": "2026-10-02",
"stories": 0
},
{
"date": "2026-10-03",
"stories": 0
},
{
"date": "2026-10-04",
"stories": 4
}
],
"has_more": false,
"as_of": "2026-10-04T17:00:00Z",
"source": "kelly",
"attribution": null,
"request_id": "req_8ca3b0ebb01de8f2a8b54120",
"live_topics": [],
"rg_line": null
}- kelly · as of 2026-10-04T17:00:00Z
Generated from Kelly API 2026-10-05.