Updated May 16, 2026

News API basics

Auth

MethodHeader
Bearer tokenAuthorization: Bearer gloom_news_...
API key headerx-api-key: gloom_news_...

Requests

UseRequest
Top storiesGET https://api.gloom.sh/v1/news?feed=top&limit=25
Breaking storiesGET https://api.gloom.sh/v1/news?feed=breaking&limit=25
Ticker storiesGET https://api.gloom.sh/v1/news?feed=ticker&tickers=AAPL:XNAS
SourcesGET https://api.gloom.sh/v1/news/sources
FacetsGET https://api.gloom.sh/v1/news/facets
AccountGET https://api.gloom.sh/v1/me

Example

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

Common filters

FilterExample
feedtop, latest, breaking, ticker, sector, topic
tickersAAPL or AAPL:XNAS
topicsearnings,mna
sourcesSource keys from /v1/news/sources
minImportanceNumeric threshold
minUrgencyNumeric threshold