Gloomberb News API

API docs

JSON market news with ticker context, scoring, source clusters, and a simple bearer key.

Account

Auth

Every v1 request requires an API key. Free keys return data delayed by 6 hours. Paid keys return full access.

Authorization: Bearer gloom_news_...
# or
x-api-key: gloom_news_...

List news

curl -s 'https://api.gloom.sh/v1/news?feed=top&limit=25' \
  -H 'Authorization: Bearer gloom_news_...'

Feeds: latest, top, breaking, ticker, sector, topic.

Filters: tickers, topics, sectors, sources, minImportance, minUrgency.

Pagination: pass nextCursor back as cursor.

Ticker format: AAPL or AAPL:XNAS.

Story detail

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

Detail responses include source items for the story cluster. Breaking feed list responses include those items inline.

Metadata

GET https://api.gloom.sh/v1/news/sources
GET https://api.gloom.sh/v1/news/facets
GET https://api.gloom.sh/v1/me

Response shape

{
  "items": [
    {
      "id": "story-id",
      "headline": "Company reports earnings beat",
      "summary": "...",
      "topic": "earnings",
      "topics": ["earnings"],
      "sentiment": "positive",
      "sectors": ["information_technology"],
      "scope": "single_ticker",
      "firstPublishedAt": "2026-05-07T11:59:00.000Z",
      "lastPublishedAt": "2026-05-07T12:00:00.000Z",
      "firstSeenAt": "2026-05-07T11:59:08.000Z",
      "lastSeenAt": "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
      },
      "flags": {
        "breaking": false,
        "developing": false,
        "provisional": false,
        "stale": false
      },
      "breaking": {
        "active": false,
        "provisional": false,
        "kind": null,
        "reason": null,
        "confidence": null,
        "firstDetectedAt": null,
        "lastMeaningfulAt": null,
        "confirmedAt": null,
        "expiresAt": null
      },
      "variantCount": 3,
      "sourceCount": 2,
      "sources": ["example-wire", "example-filings"],
      "tickerLinks": [
        {
          "symbol": "AAPL",
          "exchange": "XNAS",
          "canonicalTicker": "AAPL:XNAS",
          "relationType": "direct",
          "displayTier": "primary",
          "confidence": 0.96,
          "relevanceScore": 92,
          "impactScore": 74,
          "sentiment": "positive"
        }
      ],
      "items": [
        {
          "id": "item-id",
          "sourceKey": "example-wire",
          "sourceName": "Example Wire",
          "title": "Company reports earnings beat",
          "summary": "...",
          "url": "https://example.com/story",
          "publishedAt": "2026-05-07T12:00:00.000Z",
          "hasArticleText": true
        }
      ]
    }
  ],
  "nextCursor": "..."
}