Advanced

News API

Use Gloom's standalone market-news API in your own financial product.

Separate product

The News API is Gloom's market news for your own product, backend, model pipeline, or dashboard. It is not needed to use the app and is billed separately from Gloom Cloud.

The financial news API page shows the live wire and has the Get API key button.

Comparing news APIs? See the best financial news APIs, or Gloom side by side with NewsAPI.org and newsfilter.io.

See also: Gloom Datasets, a separate paid API for alternative signals, filings, macro, news and market data, with its own gds_ keys.

Access

The free key reads news delayed 12 hours, with the full v1 response: ticker links and source clusters, no metering. Create or rotate it from News API account.

Real-time news: from $199 a month with the News and our own data plan. Unlimited is no longer sold; existing Unlimited subscriptions keep real-time access.

Authentication

Every /v1/news request requires a News API key or a Gloom Datasets key (gds_). Use either header style:

bash
Authorization: Bearer gloom_news_...

x-api-key: gloom_news_...

Check access state with:

bash
curl -s 'https://api.gloom.sh/v1/me' \
  -H 'Authorization: Bearer gloom_news_...'

/v1/me returns the plan, whether the key has full access, billing interval/status, and dataDelaySeconds.

The market data endpoints under /v1 (quotes, data, history) take Gloom keys instead; see the REST API.

List news

bash
curl -s 'https://api.gloom.sh/v1/news?feed=top&limit=25' \
  -H 'Authorization: Bearer gloom_news_...'
ParameterValues or exampleNotes
feedlatest, top, breaking, ticker, sector, topicDefaults to the service default when omitted. ticker is newest first by last published time.
limit25Clamped between 1 and 100.
cursorvalue from nextCursorUse for pagination.
tickersAAPL, AAPL:XNAS, 7203:XTKSComma-separated. Required for feed=ticker. Use exchange-qualified symbols for ambiguous tickers.
tickerTierprimary, related, anyDefaults depend on feed.
tickerRelationsdirect,parent,brand,counterparty,regulatory,competitorComma-separated relation filters.

More filters:

ParameterValues or exampleNotes
topics / categoriesearnings,mnaCategory and topic filters.
sectorsinformation_technologyValues from /v1/news/facets.
sources, excludeSourcessource keysInclude or exclude sources.
sentimentpositive, neutral, negativeStory sentiment.
minImportance, minUrgency80Minimum score.
breakingtrue or falseFilter breaking state.
since / untilISO date/timeFilters by last seen time.

Feed examples

bash
curl -s 'https://api.gloom.sh/v1/news?feed=ticker&tickers=NVDA:XNAS&tickerTier=primary' \
  -H 'x-api-key: gloom_news_...'

Story detail

bash
curl -s 'https://api.gloom.sh/v1/news/{storyId}' \
  -H 'Authorization: Bearer gloom_news_...'

Detail returns the story plus its source items. Top and breaking lists include source items inline.

Metadata

bash
curl -s 'https://api.gloom.sh/v1/news/sources' \
  -H 'Authorization: Bearer gloom_news_...'

curl -s 'https://api.gloom.sh/v1/news/facets' \
  -H 'Authorization: Bearer gloom_news_...'

Use these to populate filters in your app.

Response shape

Abridged; each story also carries topics, sectors, scope, first and last seen times, flags, breaking detail, variantCount and sourceCount.

json
{
  "items": [
    {
      "id": "story-id",
      "headline": "Company reports earnings beat",
      "summary": "...",
      "topic": "earnings",
      "sentiment": "positive",
      "firstPublishedAt": "2026-05-07T11:59:00.000Z",
      "lastPublishedAt": "2026-05-07T12:00:00.000Z",
      "primaryUrl": "https://example.com/story",
      "primarySource": "example-wire",
      "scores": { "importance": 82, "urgency": 76, "marketImpact": 74, "novelty": 88, "confidence": 91 },
      "tickerLinks": [
        {
          "symbol": "AAPL",
          "exchange": "XNAS",
          "canonicalTicker": "AAPL:XNAS",
          "relationType": "direct",
          "displayTier": "primary",
          "confidence": 0.96
        }
      ],
      "items": [
        {
          "id": "item-id",
          "sourceKey": "example-wire",
          "title": "Company reports earnings beat",
          "url": "https://example.com/story",
          "publishedAt": "2026-05-07T12:00:00.000Z"
        }
      ]
    }
  ],
  "nextCursor": "..."
}

Ticker errors

Ticker problems return 400 with a reasonCode:

reasonCodeFix
TICKERS_REQUIREDfeed=ticker needs tickers. The parameter is plural: tickers=AAPL.
AMBIGUOUS_TICKERSend an exchange-qualified symbol from candidates, such as AAPL:XNAS, or a local suffix where supported.