# news

Read Feed's sports stories, sorted for fantasy and betting, in Kelly's own words with links to every outlet that reported them.

| Method | Path | Title | Access | Price | MCP tool |
| --- | --- | --- | --- | --- | --- |
| POST | [`/v1/news/{story_id}/report`](#report-news-story) | Report a problem with a story | public | 0 | `report_news_story` |
| GET | [`/v1/news`](#list-news) | List news stories | public | 1 | `get_news` |
| GET | [`/v1/news/sources`](#list-news-sources) | List Feed's sources | public | 1 | `get_news` |
| GET | [`/v1/news/{story_id}`](#get-news-story) | Get a news story | public | 1 | `get_news` |
| GET | [`/v1/buzz`](#list-buzz) | List Buzz posts | public | 1 | `get_news` |
| GET | [`/v1/buzz/{post_id}`](#get-buzz-post) | Get a Buzz post | public | 1 | `get_news` |
| GET | [`/v1/me/news`](#list-my-news) | List news for you | `read:tracker` | 1 | `get_news` |

`POST /v1/news/{story_id}/report`

## Report a problem with a story
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.

### Parameters
- `story_id` string · path · required  
  The story's ID (nsty_…).  
  pattern ^nsty_[0123456789abcdefghjkmnpqrstvwxyz]{20}$

Body, `application/json` (required):

- `reason` string  
  What 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).

### Response
`202` The report is in the review queue.

- `object` const · required  
  Always news_report.  
  Always `"news_report"`.
- `story_id` string · required  
  The story reported.  
  pattern ^nsty_[0123456789abcdefghjkmnpqrstvwxyz]{20}$
- `reason` string · required  
  What is wrong, as sent.  
  One of: `wrong_tag`, `wrong_entity`, `wrong_fact`, `not_news`, `duplicate` (open: new values may be added).
- `as_of` string · required  
  When the value was true; for a derived value, its newest input's time.  
  format date-time
- `source` string · required  
  Who produced the value, as shown to readers.  
  min length 1
- `attribution` string · nullable  
  Attribution the source's terms require.
- `request_id` string · required · nullable  
  The request that produced this response.
- `live_topics` array of string  
  Kelly Wire topics that update this resource (API and cards only).
- `rg_line` string · nullable  
  The 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.

### Errors
[`invalid_request`](/problems/invalid_request) · [`credential_in_url`](/problems/credential_in_url) · [`unsupported_api_version`](/problems/unsupported_api_version) · [`unauthenticated`](/problems/unauthenticated) · [`method_not_allowed`](/problems/method_not_allowed) · [`rate_limited`](/problems/rate_limited) · [`internal_error`](/problems/internal_error) · [`service_unavailable`](/problems/service_unavailable) · [`payload_too_large`](/problems/payload_too_large) · [`not_found`](/problems/not_found)

### Example
```http
POST https://api.askkelly.ai/v1/news/nsty_rz6m1tg40v3amrktkzx7/report
Content-Type: application/json

{
  "reason": "wrong_fact"
}
```

```json
{
  "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
}
```

Where each value comes from:

1. kelly · as of 2026-10-04T17:30:00Z

```http
POST https://api.askkelly.ai/v1/news/nsty_rz6m1tg40v3amrktkzx7/report
Content-Type: application/json

{
  "reason": "boring"
}
```

```json
{
  "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 stories
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.

### Parameters
- `type` string · query  
  all (default), fantasy or betting.  
  One of: `all`, `fantasy`, `betting`, `buzz`, `viral` (open: new values may be added).  
  default "all"
- `competition` string · query  
  Only 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
- `team` string · query  
  Only stories about this team (tm_…).  
  pattern ^tm_[0123456789abcdefghjkmnpqrstvwxyz]{20}$
- `player` string · query  
  Only stories about this player (plr_…).  
  pattern ^plr_[0123456789abcdefghjkmnpqrstvwxyz]{20}$
- `q` string · query  
  Only stories whose headline or summary match these words.  
  min length 2 · max length 100
- `source` string · query  
  Only stories this source reported: a source_id from list_news_sources (cbs-sports, kelly).  
  pattern ^[a-z0-9][a-z0-9-]{0,79}$
- `since` string · query  
  Only stories first seen or changed at or after this time (RFC 3339, with offset).  
  format date-time
- `date` string · query  
  Only 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
- `tz` string · query  
  The 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"
- `sort` string · query  
  top (default: Kelly's ranking) or latest (newest first).  
  One of: `top`, `latest` (open: new values may be added).  
  default "top"
- `cursor` string · query  
  next_cursor from the previous page, with the same filters.  
  min length 1 · max length 512
- `limit` integer · query  
  Stories per page; default 25.  
  min 1 · max 100 · default 25

### Response
`200` The stories.

- `object` const · required  
  Always news_story_list.  
  Always `"news_story_list"`.
- `stories` array of object · required  
  The stories, Top or Latest as asked.
  - `story_id` string · required  
    The story's ID.  
    pattern ^nsty_[0123456789abcdefghjkmnpqrstvwxyz]{20}$
  - `competition` string · required · nullable  
    The competition's slug (nfl, nba, …), or null.  
    pattern ^[a-z0-9][a-z0-9_]{0,40}$
  - `event_type` string · required  
    What 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).
  - `headline` string · required  
    Kelly's headline, at most 12 words.
  - `summary` string · required · nullable  
    Kelly's summary, at most 30 words.
  - `fantasy` boolean · required  
    Whether it bears on fantasy.
  - `betting` boolean · required  
    Whether it bears on betting.
  - `importance` integer · required  
    1 (minor) to 4 (major): how much Kelly reads it to change.  
    min 1 · max 4
  - `first_seen_at` string · required  
    When Kelly first saw it (RFC 3339).  
    format date-time
  - `updated_at` string · required  
    When its fact last changed (RFC 3339).  
    format date-time
  - `last_fact` string · required · nullable  
    The latest fact in a few words, such as Status: doubtful → out.
  - `game` one of several shapes · required  
    The game it bears on, or null.
  - `entities` array of object · required  
    The players first, then the teams.
    - `kind` string · required  
      player or team.  
      One of: `player`, `team` (open: new values may be added).
    - `id` string · required · nullable  
      Kelly's ID (plr_ or tm_), or null when the name didn't resolve to exactly one player or team.
    - `text` string · required  
      The name as the story gives it.
    - `team_id` string · nullable  
      A player's team ID, when known (players only).  
      pattern ^tm_[0123456789abcdefghjkmnpqrstvwxyz]{20}$
  - `card` object · required  
    What the story's live card streams: Kelly IDs only, never a value. Subscribe to player:, game: and market: on Kelly Wire for the numbers.
    - `kind` string · required  
      The 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_id` string  
      The player the card follows.  
      pattern ^plr_[0123456789abcdefghjkmnpqrstvwxyz]{20}$
    - `team_id` string  
      The team the card follows.  
      pattern ^tm_[0123456789abcdefghjkmnpqrstvwxyz]{20}$
    - `game_id` string  
      The game the card follows.  
      pattern ^gm_[0123456789abcdefghjkmnpqrstvwxyz]{20}$
    - `market_ids` array of string  
      The markets the card follows (mkt_…).
  - `sources` array of object · required  
    Up to three outlets, Kelly's own report first, then the earliest.
    - `outlet` string · required  
      The publisher's name, or Official report or Kelly for Kelly's own reports.
    - `url` string · required · nullable  
      The outlet's page for the story, or null for Kelly's own reports.  
      format uri
    - `source_id` string · required  
      The 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_count` integer · required  
    How many outlets covered it.  
    min 0
  - `media` array of object · required  
    Up to three social posts behind it, most travelled first (type buzz keeps the stories that have one).
    - `platform` string · required  
      Where it was posted.  
      One of: `tiktok`, `instagram`, `facebook`, `threads`, `reddit`, `snapchat`, `trends`, `kym`, `youtube`, `x`, `twitch` (open: new values may be added).
    - `label` string · required  
      The platform's name (TikTok, Google Trends, …).
    - `author` string · required · nullable  
      The account's handle, without @.
    - `url` string · required  
      The post's page.  
      format uri
    - `embed_url` string · required · nullable  
      The platform's own player for the post (an iframe source), or null: show a link card.  
      format uri
    - `published_at` string · required  
      When it was posted (RFC 3339).  
      format date-time
    - `views` integer · required · nullable  
      The platform's own view count as last swept, or null when it shows none.  
      min 0
    - `likes` integer · required · nullable  
      The platform's own like (or upvote) count as last swept, or null when it shows none.  
      min 0
    - `shares` integer · required · nullable  
      The platform's own share (or repost) count as last swept, or null when it shows none.  
      min 0
    - `comments` integer · required · nullable  
      The platform's own comment (or reply) count as last swept, or null when it shows none.  
      min 0
  - `kelly_event` boolean · required  
    Whether Kelly's own data saw it first (an injury report change, a line move).
  - `url` string · required  
    The story's page on askkelly.ai.  
    format uri
  - `share` object · required  
    How to share the story: its link on askkelly.ai and the card that link shows in iMessage, Slack, X, WhatsApp and the rest. Send `url` (or `text`), never a copy of the card.
    - `url` string · required  
      The link to the story's page.  
      format uri
    - `image` string · required  
      The share card's image (1200×630 PNG or JPEG), drawn live from the same data when fetched.  
      format uri
    - `title` string · required  
      The title the link carries.
    - `text` string · required  
      A message ready to send: the title, then the link.
- `has_more` boolean · required  
  Whether another page follows.
- `next_cursor` string · required · nullable  
  Pass as cursor, with the same filters, for the next page.
- `counts` object · required  
  Stories first seen per competition, under the type filter: in the last 72 hours, or on the chosen day with date.
- `days` array of object · required  
  The 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
  - `date` string · required  
    The local day.  
    format date
  - `stories` integer · required  
    Stories first seen that day.  
    min 0
- `as_of` string · required  
  When the value was true; for a derived value, its newest input's time.  
  format date-time
- `source` string · required  
  Who produced the value, as shown to readers.  
  min length 1
- `attribution` string · nullable  
  Attribution the source's terms require.
- `request_id` string · required · nullable  
  The request that produced this response.
- `live_topics` array of string  
  Kelly Wire topics that update this resource (API and cards only).
- `rg_line` string · nullable  
  The 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.

### Errors
[`invalid_request`](/problems/invalid_request) · [`credential_in_url`](/problems/credential_in_url) · [`unsupported_api_version`](/problems/unsupported_api_version) · [`unauthenticated`](/problems/unauthenticated) · [`method_not_allowed`](/problems/method_not_allowed) · [`rate_limited`](/problems/rate_limited) · [`internal_error`](/problems/internal_error) · [`service_unavailable`](/problems/service_unavailable) · [`quota_exhausted`](/problems/quota_exhausted)

### Example
```http
GET https://api.askkelly.ai/v1/news?type=fantasy&competition=nfl&sort=latest
```

```json
{
  "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
}
```

Where each value comes from:

1. kelly · as of 2026-10-04T14:33:00Z

```http
GET https://api.askkelly.ai/v1/news?type=props
```

```json
{
  "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."
}
```

```http
GET https://api.askkelly.ai/v1/news?date=2026-10-04&tz=Europe/London&limit=2
```

```json
{
  "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
}
```

Where each value comes from:

1. kelly · as of 2026-10-04T16:30:00Z

```http
GET https://api.askkelly.ai/v1/news?source=example-wire
```

```json
{
  "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
}
```

Where each value comes from:

1. kelly · as of 2026-10-04T16:30:00Z

```http
GET https://api.askkelly.ai/v1/news?limit=2
```

```json
{
  "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
}
```

Where each value comes from:

1. kelly · as of 2026-10-04T16:30:00Z

`GET /v1/news/sources`

## List Feed's sources
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.

### Response
`200` The sources.

- `object` const · required  
  Always news_source_list.  
  Always `"news_source_list"`.
- `sources` array of object · required  
  The sources.
  - `source_id` string · required  
    The source's ID: list_news' source takes it.  
    pattern ^[a-z0-9][a-z0-9-]{0,79}$
  - `name` string · required  
    The outlet's name, or Kelly for Kelly's own reports.
  - `kind` string · required  
    outlet, platform (a social platform Feed's sweeps search) or kelly.  
    One of: `outlet`, `platform`, `kelly` (open: new values may be added).
  - `url` string · required · nullable  
    The outlet's site, or null for Kelly.  
    format uri
  - `competitions` array of string · required  
    The competitions its feeds are about (empty: every sport).
  - `tier` integer · required  
    1 (a primary source) to 3.  
    min 1 · max 3
  - `state` string · required  
    active; 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).
  - `feeds` integer · required  
    How many of its feeds Kelly reads.  
    min 1
  - `last_item_at` string · required · nullable  
    When its newest item reached Kelly (RFC 3339).  
    format date-time
  - `stories` integer · required  
    Published stories it gave in the last 72 hours.  
    min 0
- `as_of` string · required  
  When the value was true; for a derived value, its newest input's time.  
  format date-time
- `source` string · required  
  Who produced the value, as shown to readers.  
  min length 1
- `attribution` string · nullable  
  Attribution the source's terms require.
- `request_id` string · required · nullable  
  The request that produced this response.
- `live_topics` array of string  
  Kelly Wire topics that update this resource (API and cards only).
- `rg_line` string · nullable  
  The 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.

### Errors
[`invalid_request`](/problems/invalid_request) · [`credential_in_url`](/problems/credential_in_url) · [`unsupported_api_version`](/problems/unsupported_api_version) · [`unauthenticated`](/problems/unauthenticated) · [`method_not_allowed`](/problems/method_not_allowed) · [`rate_limited`](/problems/rate_limited) · [`internal_error`](/problems/internal_error) · [`service_unavailable`](/problems/service_unavailable) · [`quota_exhausted`](/problems/quota_exhausted)

### Example
```http
GET https://api.askkelly.ai/v1/news/sources
```

```json
{
  "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
}
```

Where each value comes from:

1. kelly · as of 2026-10-04T17:30:00Z

`GET /v1/news/{story_id}`

## Get a news story
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.

### Parameters
- `story_id` string · path · required  
  The story's ID (nsty_…).  
  pattern ^nsty_[0123456789abcdefghjkmnpqrstvwxyz]{20}$

### Response
`200` The story.

- `object` const · required  
  Always news_story.  
  Always `"news_story"`.
- `story_id` string · required  
  The story's ID.  
  pattern ^nsty_[0123456789abcdefghjkmnpqrstvwxyz]{20}$
- `competition` string · required · nullable  
  The competition's slug (nfl, nba, …), or null.  
  pattern ^[a-z0-9][a-z0-9_]{0,40}$
- `event_type` string · required  
  What 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).
- `headline` string · required  
  Kelly's headline, at most 12 words.
- `summary` string · required · nullable  
  Kelly's summary, at most 30 words.
- `fantasy` boolean · required  
  Whether it bears on fantasy.
- `betting` boolean · required  
  Whether it bears on betting.
- `importance` integer · required  
  1 (minor) to 4 (major): how much Kelly reads it to change.  
  min 1 · max 4
- `first_seen_at` string · required  
  When Kelly first saw it (RFC 3339).  
  format date-time
- `updated_at` string · required  
  When its fact last changed (RFC 3339).  
  format date-time
- `last_fact` string · required · nullable  
  The latest fact in a few words, such as Status: doubtful → out.
- `game` one of several shapes · required  
  The game it bears on, or null.
- `entities` array of object · required  
  The players first, then the teams.
  - `kind` string · required  
    player or team.  
    One of: `player`, `team` (open: new values may be added).
  - `id` string · required · nullable  
    Kelly's ID (plr_ or tm_), or null when the name didn't resolve to exactly one player or team.
  - `text` string · required  
    The name as the story gives it.
  - `team_id` string · nullable  
    A player's team ID, when known (players only).  
    pattern ^tm_[0123456789abcdefghjkmnpqrstvwxyz]{20}$
- `card` object · required  
  What the story's live card streams: Kelly IDs only, never a value. Subscribe to player:, game: and market: on Kelly Wire for the numbers.
  - `kind` string · required  
    The 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_id` string  
    The player the card follows.  
    pattern ^plr_[0123456789abcdefghjkmnpqrstvwxyz]{20}$
  - `team_id` string  
    The team the card follows.  
    pattern ^tm_[0123456789abcdefghjkmnpqrstvwxyz]{20}$
  - `game_id` string  
    The game the card follows.  
    pattern ^gm_[0123456789abcdefghjkmnpqrstvwxyz]{20}$
  - `market_ids` array of string  
    The markets the card follows (mkt_…).
- `sources` array of object · required  
  Every outlet, Kelly's own report first, then the earliest.
  - `outlet` string · required  
    The publisher's name, or Official report or Kelly for Kelly's own reports.
  - `url` string · required · nullable  
    The outlet's page for the story, or null for Kelly's own reports.  
    format uri
  - `source_id` string · required  
    The 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_count` integer · required  
  How many outlets covered it.  
  min 0
- `media` array of object · required  
  Every social post behind it, most travelled first.
  - `platform` string · required  
    Where it was posted.  
    One of: `tiktok`, `instagram`, `facebook`, `threads`, `reddit`, `snapchat`, `trends`, `kym`, `youtube`, `x`, `twitch` (open: new values may be added).
  - `label` string · required  
    The platform's name (TikTok, Google Trends, …).
  - `author` string · required · nullable  
    The account's handle, without @.
  - `url` string · required  
    The post's page.  
    format uri
  - `embed_url` string · required · nullable  
    The platform's own player for the post (an iframe source), or null: show a link card.  
    format uri
  - `published_at` string · required  
    When it was posted (RFC 3339).  
    format date-time
  - `views` integer · required · nullable  
    The platform's own view count as last swept, or null when it shows none.  
    min 0
  - `likes` integer · required · nullable  
    The platform's own like (or upvote) count as last swept, or null when it shows none.  
    min 0
  - `shares` integer · required · nullable  
    The platform's own share (or repost) count as last swept, or null when it shows none.  
    min 0
  - `comments` integer · required · nullable  
    The platform's own comment (or reply) count as last swept, or null when it shows none.  
    min 0
- `kelly_event` boolean · required  
  Whether Kelly's own data saw it first (an injury report change, a line move).
- `url` string · required  
  The story's page on askkelly.ai.  
  format uri
- `share` object · required  
  How to share the story: its link on askkelly.ai and the card that link shows in iMessage, Slack, X, WhatsApp and the rest. Send `url` (or `text`), never a copy of the card.
  - `url` string · required  
    The link to the story's page.  
    format uri
  - `image` string · required  
    The share card's image (1200×630 PNG or JPEG), drawn live from the same data when fetched.  
    format uri
  - `title` string · required  
    The title the link carries.
  - `text` string · required  
    A message ready to send: the title, then the link.
- `timeline` array of object · required  
  Each fact as it changed, oldest first.
  - `at` string · required  
    When (RFC 3339).  
    format date-time
  - `fact` string · required  
    The fact.
- `as_of` string · required  
  When the value was true; for a derived value, its newest input's time.  
  format date-time
- `source` string · required  
  Who produced the value, as shown to readers.  
  min length 1
- `attribution` string · nullable  
  Attribution the source's terms require.
- `request_id` string · required · nullable  
  The request that produced this response.
- `live_topics` array of string  
  Kelly Wire topics that update this resource (API and cards only).
- `rg_line` string · nullable  
  The 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.

### Errors
[`invalid_request`](/problems/invalid_request) · [`credential_in_url`](/problems/credential_in_url) · [`unsupported_api_version`](/problems/unsupported_api_version) · [`unauthenticated`](/problems/unauthenticated) · [`method_not_allowed`](/problems/method_not_allowed) · [`rate_limited`](/problems/rate_limited) · [`internal_error`](/problems/internal_error) · [`service_unavailable`](/problems/service_unavailable) · [`quota_exhausted`](/problems/quota_exhausted) · [`not_found`](/problems/not_found)

### Example
```http
GET https://api.askkelly.ai/v1/news/nsty_22222222222222222222
```

```json
{
  "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."
}
```

```http
GET https://api.askkelly.ai/v1/news/nsty_rz6m1tg40v3amrktkzx7
```

```json
{
  "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
}
```

Where each value comes from:

1. kelly · as of 2026-10-04T14:33:00Z

`GET /v1/buzz`

## List Buzz posts
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.

### Parameters
- `competition` string · query  
  Only 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
- `platform` string · query  
  Only 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
- `team` string · query  
  Only posts that name this team or its players (tm_…, from search_sports).  
  pattern ^tm_[0123456789abcdefghjkmnpqrstvwxyz]{20}$
- `player` string · query  
  Only posts that name this player (plr_…, from search_sports).  
  pattern ^plr_[0123456789abcdefghjkmnpqrstvwxyz]{20}$
- `format` string · query  
  all (default), video, image, post or search.  
  One of: `all`, `video`, `image`, `post`, `search` (open: new values may be added).  
  default "all"
- `sort` string · query  
  top (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"
- `cursor` string · query  
  next_cursor from the previous page, with the same filters.  
  min length 1 · max length 512
- `limit` integer · query  
  Posts per page; default 24.  
  min 1 · max 100 · default 24

### Response
`200` The posts.

- `object` const · required  
  Always buzz_post_list.  
  Always `"buzz_post_list"`.
- `posts` array of object · required  
  The posts, Top or Latest as asked.
  - `post_id` string · required  
    The post's ID on Kelly (nitm_…).  
    pattern ^nitm_[0123456789abcdefghjkmnpqrstvwxyz]{20}$
  - `format` string · required  
    video, image, post or search (a Google Trends search).  
    One of: `video`, `image`, `post`, `search` (open: new values may be added).
  - `platform` string · required  
    Where it was posted.  
    One of: `tiktok`, `instagram`, `facebook`, `threads`, `reddit`, `snapchat`, `trends`, `kym`, `youtube`, `x`, `twitch` (open: new values may be added).
  - `label` string · required  
    The platform's name (TikTok, Google Trends, …).
  - `author` string · required · nullable  
    The account's handle, without @.
  - `url` string · required  
    The post's page on its platform.  
    format uri
  - `embed_url` string · required · nullable  
    The platform's own player for the post (an iframe source), or null: show a link card.  
    format uri
  - `poster_url` string · required · nullable  
    The 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_at` string · required  
    When it was posted (RFC 3339).  
    format date-time
  - `views` integer · required · nullable  
    The platform's own view count as last swept, or null when it shows none.  
    min 0
  - `likes` integer · required · nullable  
    The platform's own like (or upvote) count as last swept, or null when it shows none.  
    min 0
  - `shares` integer · required · nullable  
    The platform's own share (or repost) count as last swept, or null when it shows none.  
    min 0
  - `comments` integer · required · nullable  
    The platform's own comment (or reply) count as last swept, or null when it shows none.  
    min 0
  - `competition` string · required · nullable  
    The competition's slug (its story's, else what the post names), or null.  
    pattern ^[a-z0-9][a-z0-9_]{0,40}$
  - `competition_confidence` number · required · nullable  
    How 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
  - `teams` array of string · required  
    Teams the post names or whose players it names (tm_…; get_team reads one), in its competition.  
    max items 10
  - `players` array of string · required  
    Players the post names in full (plr_…; get_player reads one), in its competition.  
    max items 10
  - `story` object · required · nullable  
    The Feed story the post belongs to, in Kelly's words, or null: most Buzz posts are in none (ADR-K263).
    - `story_id` string · required  
      The story's ID: get_news_story reads it.  
      pattern ^nsty_[0123456789abcdefghjkmnpqrstvwxyz]{20}$
    - `headline` string · required  
      Kelly's headline, at most 12 words; never the post's caption.
    - `summary` string · required · nullable  
      Kelly's summary, at most 30 words.
    - `competition` string · required · nullable  
      The competition's slug, or null.  
      pattern ^[a-z0-9][a-z0-9_]{0,40}$
    - `url` string · required  
      The story's page on askkelly.ai.  
      format uri
  - `share_url` string · required  
    The post's page on askkelly.ai: the link to share.  
    format uri
  - `share` object · required  
    How to share the post: its link on askkelly.ai and the card that link shows in iMessage, Slack, X, WhatsApp and the rest. Send `url` (or `text`), never a copy of the card.
    - `url` string · required  
      The link to the post's page.  
      format uri
    - `image` string · required  
      The share card's image (1200×630 PNG or JPEG), drawn live from the same data when fetched.  
      format uri
    - `title` string · required  
      The title the link carries.
    - `text` string · required  
      A message ready to send: the title, then the link.
- `has_more` boolean · required  
  Whether another page follows.
- `next_cursor` string · required · nullable  
  Pass as cursor, with the same filters, for the next page.
- `counts` object · required  
  Every post in the last seven days, unfiltered: the page's chips.
  - `posts` integer · required  
    All of them.  
    min 0
  - `competitions` object · required  
    Posts per competition slug.
  - `platforms` object · required  
    Posts per platform.
  - `formats` object · required  
    Posts per format.
- `as_of` string · required  
  When the value was true; for a derived value, its newest input's time.  
  format date-time
- `source` string · required  
  Who produced the value, as shown to readers.  
  min length 1
- `attribution` string · nullable  
  Attribution the source's terms require.
- `request_id` string · required · nullable  
  The request that produced this response.
- `live_topics` array of string  
  Kelly Wire topics that update this resource (API and cards only).
- `rg_line` string · nullable  
  The 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.

### Errors
[`invalid_request`](/problems/invalid_request) · [`credential_in_url`](/problems/credential_in_url) · [`unsupported_api_version`](/problems/unsupported_api_version) · [`unauthenticated`](/problems/unauthenticated) · [`method_not_allowed`](/problems/method_not_allowed) · [`rate_limited`](/problems/rate_limited) · [`internal_error`](/problems/internal_error) · [`service_unavailable`](/problems/service_unavailable) · [`quota_exhausted`](/problems/quota_exhausted)

### Example
```http
GET https://api.askkelly.ai/v1/buzz?platform=myspace
```

```json
{
  "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."
}
```

```http
GET https://api.askkelly.ai/v1/buzz
```

```json
{
  "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
}
```

Where each value comes from:

1. kelly · as of 2026-10-04T16:30:00Z

`GET /v1/buzz/{post_id}`

## Get a Buzz post
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.

### Parameters
- `post_id` string · path · required  
  The post's ID (nitm_…).  
  pattern ^nitm_[0123456789abcdefghjkmnpqrstvwxyz]{20}$

### Response
`200` The post.

- `object` const · required  
  Always buzz_post.  
  Always `"buzz_post"`.
- `post_id` string · required  
  The post's ID on Kelly (nitm_…).  
  pattern ^nitm_[0123456789abcdefghjkmnpqrstvwxyz]{20}$
- `format` string · required  
  video, image, post or search (a Google Trends search).  
  One of: `video`, `image`, `post`, `search` (open: new values may be added).
- `platform` string · required  
  Where it was posted.  
  One of: `tiktok`, `instagram`, `facebook`, `threads`, `reddit`, `snapchat`, `trends`, `kym`, `youtube`, `x`, `twitch` (open: new values may be added).
- `label` string · required  
  The platform's name (TikTok, Google Trends, …).
- `author` string · required · nullable  
  The account's handle, without @.
- `url` string · required  
  The post's page on its platform.  
  format uri
- `embed_url` string · required · nullable  
  The platform's own player for the post (an iframe source), or null: show a link card.  
  format uri
- `poster_url` string · required · nullable  
  The 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_at` string · required  
  When it was posted (RFC 3339).  
  format date-time
- `views` integer · required · nullable  
  The platform's own view count as last swept, or null when it shows none.  
  min 0
- `likes` integer · required · nullable  
  The platform's own like (or upvote) count as last swept, or null when it shows none.  
  min 0
- `shares` integer · required · nullable  
  The platform's own share (or repost) count as last swept, or null when it shows none.  
  min 0
- `comments` integer · required · nullable  
  The platform's own comment (or reply) count as last swept, or null when it shows none.  
  min 0
- `competition` string · required · nullable  
  The competition's slug (its story's, else what the post names), or null.  
  pattern ^[a-z0-9][a-z0-9_]{0,40}$
- `competition_confidence` number · required · nullable  
  How 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
- `teams` array of string · required  
  Teams the post names or whose players it names (tm_…; get_team reads one), in its competition.  
  max items 10
- `players` array of string · required  
  Players the post names in full (plr_…; get_player reads one), in its competition.  
  max items 10
- `story` object · required · nullable  
  The Feed story the post belongs to, in Kelly's words, or null: most Buzz posts are in none (ADR-K263).
  - `story_id` string · required  
    The story's ID: get_news_story reads it.  
    pattern ^nsty_[0123456789abcdefghjkmnpqrstvwxyz]{20}$
  - `headline` string · required  
    Kelly's headline, at most 12 words; never the post's caption.
  - `summary` string · required · nullable  
    Kelly's summary, at most 30 words.
  - `competition` string · required · nullable  
    The competition's slug, or null.  
    pattern ^[a-z0-9][a-z0-9_]{0,40}$
  - `url` string · required  
    The story's page on askkelly.ai.  
    format uri
- `share_url` string · required  
  The post's page on askkelly.ai: the link to share.  
  format uri
- `share` object · required  
  How to share the post: its link on askkelly.ai and the card that link shows in iMessage, Slack, X, WhatsApp and the rest. Send `url` (or `text`), never a copy of the card.
  - `url` string · required  
    The link to the post's page.  
    format uri
  - `image` string · required  
    The share card's image (1200×630 PNG or JPEG), drawn live from the same data when fetched.  
    format uri
  - `title` string · required  
    The title the link carries.
  - `text` string · required  
    A message ready to send: the title, then the link.
- `as_of` string · required  
  When the value was true; for a derived value, its newest input's time.  
  format date-time
- `source` string · required  
  Who produced the value, as shown to readers.  
  min length 1
- `attribution` string · nullable  
  Attribution the source's terms require.
- `request_id` string · required · nullable  
  The request that produced this response.
- `live_topics` array of string  
  Kelly Wire topics that update this resource (API and cards only).
- `rg_line` string · nullable  
  The 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.

### Errors
[`invalid_request`](/problems/invalid_request) · [`credential_in_url`](/problems/credential_in_url) · [`unsupported_api_version`](/problems/unsupported_api_version) · [`unauthenticated`](/problems/unauthenticated) · [`method_not_allowed`](/problems/method_not_allowed) · [`rate_limited`](/problems/rate_limited) · [`internal_error`](/problems/internal_error) · [`service_unavailable`](/problems/service_unavailable) · [`quota_exhausted`](/problems/quota_exhausted) · [`not_found`](/problems/not_found)

### Example
```http
GET https://api.askkelly.ai/v1/buzz/nitm_22222222222222222222
```

```json
{
  "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."
}
```

```http
GET https://api.askkelly.ai/v1/buzz/nitm_wv88n86fp6bz7j0g22rz
```

```json
{
  "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
}
```

Where each value comes from:

1. kelly · as of 2026-10-04T16:30:00Z

`GET /v1/me/news`

## List news for you
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).

### Parameters
- `type` string · query  
  all (default), fantasy or betting.  
  One of: `all`, `fantasy`, `betting`, `buzz`, `viral` (open: new values may be added).  
  default "all"
- `competition` string · query  
  Only 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
- `team` string · query  
  Only stories about this team (tm_…).  
  pattern ^tm_[0123456789abcdefghjkmnpqrstvwxyz]{20}$
- `player` string · query  
  Only stories about this player (plr_…).  
  pattern ^plr_[0123456789abcdefghjkmnpqrstvwxyz]{20}$
- `q` string · query  
  Only stories whose headline or summary match these words.  
  min length 2 · max length 100
- `source` string · query  
  Only stories this source reported: a source_id from list_news_sources (cbs-sports, kelly).  
  pattern ^[a-z0-9][a-z0-9-]{0,79}$
- `since` string · query  
  Only stories first seen or changed at or after this time (RFC 3339, with offset).  
  format date-time
- `date` string · query  
  Only 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
- `tz` string · query  
  The 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"
- `sort` string · query  
  top (default: Kelly's ranking) or latest (newest first).  
  One of: `top`, `latest` (open: new values may be added).  
  default "top"
- `cursor` string · query  
  next_cursor from the previous page, with the same filters.  
  min length 1 · max length 512
- `limit` integer · query  
  Stories per page; default 25.  
  min 1 · max 100 · default 25
- `scope` string · query  
  following: 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).

### Response
`200` The stories.

- `object` const · required  
  Always news_story_list.  
  Always `"news_story_list"`.
- `stories` array of object · required  
  The stories, Top or Latest as asked.
  - `story_id` string · required  
    The story's ID.  
    pattern ^nsty_[0123456789abcdefghjkmnpqrstvwxyz]{20}$
  - `competition` string · required · nullable  
    The competition's slug (nfl, nba, …), or null.  
    pattern ^[a-z0-9][a-z0-9_]{0,40}$
  - `event_type` string · required  
    What 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).
  - `headline` string · required  
    Kelly's headline, at most 12 words.
  - `summary` string · required · nullable  
    Kelly's summary, at most 30 words.
  - `fantasy` boolean · required  
    Whether it bears on fantasy.
  - `betting` boolean · required  
    Whether it bears on betting.
  - `importance` integer · required  
    1 (minor) to 4 (major): how much Kelly reads it to change.  
    min 1 · max 4
  - `first_seen_at` string · required  
    When Kelly first saw it (RFC 3339).  
    format date-time
  - `updated_at` string · required  
    When its fact last changed (RFC 3339).  
    format date-time
  - `last_fact` string · required · nullable  
    The latest fact in a few words, such as Status: doubtful → out.
  - `game` one of several shapes · required  
    The game it bears on, or null.
  - `entities` array of object · required  
    The players first, then the teams.
    - `kind` string · required  
      player or team.  
      One of: `player`, `team` (open: new values may be added).
    - `id` string · required · nullable  
      Kelly's ID (plr_ or tm_), or null when the name didn't resolve to exactly one player or team.
    - `text` string · required  
      The name as the story gives it.
    - `team_id` string · nullable  
      A player's team ID, when known (players only).  
      pattern ^tm_[0123456789abcdefghjkmnpqrstvwxyz]{20}$
  - `card` object · required  
    What the story's live card streams: Kelly IDs only, never a value. Subscribe to player:, game: and market: on Kelly Wire for the numbers.
    - `kind` string · required  
      The 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_id` string  
      The player the card follows.  
      pattern ^plr_[0123456789abcdefghjkmnpqrstvwxyz]{20}$
    - `team_id` string  
      The team the card follows.  
      pattern ^tm_[0123456789abcdefghjkmnpqrstvwxyz]{20}$
    - `game_id` string  
      The game the card follows.  
      pattern ^gm_[0123456789abcdefghjkmnpqrstvwxyz]{20}$
    - `market_ids` array of string  
      The markets the card follows (mkt_…).
  - `sources` array of object · required  
    Up to three outlets, Kelly's own report first, then the earliest.
    - `outlet` string · required  
      The publisher's name, or Official report or Kelly for Kelly's own reports.
    - `url` string · required · nullable  
      The outlet's page for the story, or null for Kelly's own reports.  
      format uri
    - `source_id` string · required  
      The 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_count` integer · required  
    How many outlets covered it.  
    min 0
  - `media` array of object · required  
    Up to three social posts behind it, most travelled first (type buzz keeps the stories that have one).
    - `platform` string · required  
      Where it was posted.  
      One of: `tiktok`, `instagram`, `facebook`, `threads`, `reddit`, `snapchat`, `trends`, `kym`, `youtube`, `x`, `twitch` (open: new values may be added).
    - `label` string · required  
      The platform's name (TikTok, Google Trends, …).
    - `author` string · required · nullable  
      The account's handle, without @.
    - `url` string · required  
      The post's page.  
      format uri
    - `embed_url` string · required · nullable  
      The platform's own player for the post (an iframe source), or null: show a link card.  
      format uri
    - `published_at` string · required  
      When it was posted (RFC 3339).  
      format date-time
    - `views` integer · required · nullable  
      The platform's own view count as last swept, or null when it shows none.  
      min 0
    - `likes` integer · required · nullable  
      The platform's own like (or upvote) count as last swept, or null when it shows none.  
      min 0
    - `shares` integer · required · nullable  
      The platform's own share (or repost) count as last swept, or null when it shows none.  
      min 0
    - `comments` integer · required · nullable  
      The platform's own comment (or reply) count as last swept, or null when it shows none.  
      min 0
  - `kelly_event` boolean · required  
    Whether Kelly's own data saw it first (an injury report change, a line move).
  - `url` string · required  
    The story's page on askkelly.ai.  
    format uri
  - `share` object · required  
    How to share the story: its link on askkelly.ai and the card that link shows in iMessage, Slack, X, WhatsApp and the rest. Send `url` (or `text`), never a copy of the card.
    - `url` string · required  
      The link to the story's page.  
      format uri
    - `image` string · required  
      The share card's image (1200×630 PNG or JPEG), drawn live from the same data when fetched.  
      format uri
    - `title` string · required  
      The title the link carries.
    - `text` string · required  
      A message ready to send: the title, then the link.
- `has_more` boolean · required  
  Whether another page follows.
- `next_cursor` string · required · nullable  
  Pass as cursor, with the same filters, for the next page.
- `counts` object · required  
  Stories first seen per competition, under the type filter: in the last 72 hours, or on the chosen day with date.
- `days` array of object · required  
  The 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
  - `date` string · required  
    The local day.  
    format date
  - `stories` integer · required  
    Stories first seen that day.  
    min 0
- `as_of` string · required  
  When the value was true; for a derived value, its newest input's time.  
  format date-time
- `source` string · required  
  Who produced the value, as shown to readers.  
  min length 1
- `attribution` string · nullable  
  Attribution the source's terms require.
- `request_id` string · required · nullable  
  The request that produced this response.
- `live_topics` array of string  
  Kelly Wire topics that update this resource (API and cards only).
- `rg_line` string · nullable  
  The 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.

### Errors
[`invalid_request`](/problems/invalid_request) · [`credential_in_url`](/problems/credential_in_url) · [`unsupported_api_version`](/problems/unsupported_api_version) · [`unauthenticated`](/problems/unauthenticated) · [`method_not_allowed`](/problems/method_not_allowed) · [`rate_limited`](/problems/rate_limited) · [`internal_error`](/problems/internal_error) · [`service_unavailable`](/problems/service_unavailable) · [`insufficient_scope`](/problems/insufficient_scope) · [`not_entitled`](/problems/not_entitled)

### Example
```http
GET https://api.askkelly.ai/v1/me/news
Authorization: Bearer $KELLY_API_KEY
```

```json
{
  "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."
}
```

```http
GET https://api.askkelly.ai/v1/me/news
Authorization: Bearer $KELLY_API_KEY
```

```json
{
  "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
}
```

Where each value comes from:

1. kelly · as of 2026-10-04T17:00:00Z

Generated from Kelly API 2026-10-05.

---

Generated from Kelly API 2026-10-05

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

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