Gloom News API

News

GitHub OpenAPI

Operations 5

GET /v1/datasets/news/sample Daily News sample #
GET /v1/stories Publisher stories with ticker and topic filters #
GET /v1/stories/sources News source directory #
GET /v1/stories/facets Story topic, sector and source counts #
GET /v1/stories/{id} Story and its publisher variants #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/gloom-sh:gloom-sh-news-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

gloom-sh-news-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Gloom Datasets News API
  version: '2026-11-10'
  description: 'Gloom Datasets API. Authenticate with a `gds_` key. Prices and limits: https://gloom.sh/datasets/pricing. Changes: https://gloom.sh/datasets/docs/changelog.


    Every response is `{data, meta}` and every error `{error: {type, code, message, param, requestId, docUrl}}`. Dataset routes sit directly under /v1; the catalog, account and reference routes under /v1/datasets. Company routes take symbols=, listings in any notation (AAPL, BRK-B, AIR.PA, VOD:XLON), as many as the route''s x-symbols.max: each item names its canonical listing, meta.symbols reports every input, and a listing the dataset does not know is free. Paths renamed in 2026-10-23 answer 308 to their new path until 2027-01-23 (x-redirects). Gloom Datasets keys and Gloom Pro keys are different keys for different APIs: each is refused by the other''s routes. Every route is also a tool of the MCP server at https://api.gloom.sh/v1/datasets/mcp (Streamable HTTP; x-mcp), with the same key and price. No key? Pay each call with x402: a call with no key answers 402 with its price in the PAYMENT-REQUIRED header; pay it in USDC on Base ($0.03 a credit) and send the same request with PAYMENT-SIGNATURE (x-x402, https://gloom.sh/datasets/docs/x402).'
  x-mcp:
    url: https://api.gloom.sh/v1/datasets/mcp
    transport: streamable-http
    docs: https://gloom.sh/datasets/docs/mcp
  termsOfService: https://gloom.sh/datasets/terms
  contact:
    name: Gloom Datasets
    url: https://gloom.sh/datasets/docs
    email: hello@gloom.sh
  x-guidance: 'Gloom Datasets sells financial and alternative datasets (SEC filings, fundamentals, options, macro, hiring, GPU prices and more), one JSON route per dataset under /v1. Every route is paid per call with x402, in USDC on Base, with no account: a request with no payment answers 402 and its PAYMENT-REQUIRED header holds the price; the same request with a signed PAYMENT-SIGNATURE header is answered and then settled. A credit costs $0.03; each route''s price is in its x-payment-info, and routes that take symbols= (AAPL,MSFT) charge each listing the dataset holds. GET /v1/datasets lists the datasets and GET /v1/datasets/{id}/sample answers a dataset''s free sample. Parameters, limits and response schemas are described per route. Docs: https://gloom.sh/datasets/docs/x402.'
servers:
- url: https://api.gloom.sh
security:
- bearer: []
- apiKey: []
tags:


# --- truncated at 32 KB (56 KB total) ---
# Full source: https://artifacts.apis.io/gloom-sh/openapi/gloom-sh-news-api-openapi.yml