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:
Authorization: Bearer gloom_news_...
x-api-key: gloom_news_...Check access state with:
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
curl -s 'https://api.gloom.sh/v1/news?feed=top&limit=25' \
-H 'Authorization: Bearer gloom_news_...'| Parameter | Values or example | Notes |
|---|---|---|
feed | latest, top, breaking, ticker, sector, topic | Defaults to the service default when omitted. ticker is newest first by last published time. |
limit | 25 | Clamped between 1 and 100. |
cursor | value from nextCursor | Use for pagination. |
tickers | AAPL, AAPL:XNAS, 7203:XTKS | Comma-separated. Required for feed=ticker. Use exchange-qualified symbols for ambiguous tickers. |
tickerTier | primary, related, any | Defaults depend on feed. |
tickerRelations | direct,parent,brand,counterparty,regulatory,competitor | Comma-separated relation filters. |
More filters:
| Parameter | Values or example | Notes |
|---|---|---|
topics / categories | earnings,mna | Category and topic filters. |
sectors | information_technology | Values from /v1/news/facets. |
sources, excludeSources | source keys | Include or exclude sources. |
sentiment | positive, neutral, negative | Story sentiment. |
minImportance, minUrgency | 80 | Minimum score. |
breaking | true or false | Filter breaking state. |
since / until | ISO date/time | Filters by last seen time. |
Feed examples
curl -s 'https://api.gloom.sh/v1/news?feed=ticker&tickers=NVDA:XNAS&tickerTier=primary' \
-H 'x-api-key: gloom_news_...'Story detail
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
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.
{
"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:
reasonCode | Fix |
|---|---|
TICKERS_REQUIRED | feed=ticker needs tickers. The parameter is plural: tickers=AAPL. |
AMBIGUOUS_TICKER | Send an exchange-qualified symbol from candidates, such as AAPL:XNAS, or a local suffix where supported. |