news

Get a news article by UID

get/api/news/{uid}/

Path parameters

uidstring required

Response

A single enriched article.

story_idstring nullable

Populated whenever the response is story-collapsed — ?collapse=story on /api/news/, and always on /api/news/trending/. The uid of the story's ROOT article — the same value for a given story on every collapsing surface (this feed, trending, and the MCP tools) and across calls, so it works as a stable story key. On ?collapse=story the root is the row itself, so it equals this item's own original.uid; on /api/news/trending/ the item is the story's strongest-ranked member, which may differ from the root. Either way it resolves via /api/news/{uid}/. null in the default (uncollapsed) feed.

sources_countinteger nullable

Story-collapsed responses only. Number of distinct outlets (source domains) covering this story; the same outlet running it more than once counts once. Most stories are carried by a single outlet, so this is usually 1. Treat a value above 1 as the signal, not the number itself. May exceed the length of sources, which is capped at 10. null in the default feed.

sourcesstring[] nullable

Story-collapsed responses only. Distinct source domains covering this story, in first-appearance order, capped at 10. null in the default feed.

Example response

{
  "enrichment": {
    "tickers": [
      "NVDA"
    ],
    "news_context_enhancement": {
      "key_entities": [
        {
          "type": "company"
        }
      ]
    }
  },
  "earnings": {
    "fiscal_period": "Second Quarter Fiscal 2027",
    "key_metrics": [
      {
        "value": "$96.2 billion"
      }
    ]
  },
  "story_id": "788e477c66f3849b",
  "sources_count": 3,
  "sources": [
    "reuters.com",
    "apnews.com",
    "bloomberg.com"
  ],
  "insider": {
    "transaction_code": "S",
    "shares": "25000",
    "avg_price_usd": "187.32",
    "total_value_usd": "4683000",
    "insider_name": "STEVENS MARK A",
    "insider_title": "Director",
    "transaction_date": "2026-07-09",
    "filed_at": "2026-07-11T20:31:04Z"
  }
}

Changes

Changed in 1 of the 8 revisions of this API.1

Aug 27, 20268a2df497d6bf1See the full diff
- ○
  added the optional property earnings to the response with the 200 status
  response-optional-property-added

Full history