# Hottub News > Agent-first worldwide news aggregation. Headlines, short summaries and links from thousands of sources — news organizations, wires, governments, space agencies, research and community sites — normalized into one flat schema with stable ids, ISO language/country codes and an incremental sync cursor. Paid press releases are always labeled. No key needed to read. Everything is GET, cached at the edge, and available in six formats. ## Fastest paths - Latest, cheapest to read: https://hottub.news/v1/items?format=lines&limit=100 - Only what's new since you last looked: https://hottub.news/v1/items?after=&format=ndjson (start with after=0; reuse the `X-Cursor` header / `cursor` field) - Search: https://hottub.news/v1/items?q=solar+eclipse&since=2d&format=md - What everyone is covering: https://hottub.news/v1/items?sort=hot&format=md (last 48h, one item per story; `related` counts other items on the same story) - Filter: lang=en,es · country=US,IN · topic=space · kind=official · source= · since=6h · until=2026-09-26 - Variety: per_source=1 keeps at most one item per publisher (browse only; sync is always complete) - One item: https://hottub.news/v1/items/ (append .md for Markdown) - MCP (Streamable HTTP, stateless): https://hottub.news/mcp — tools: search_news, sync_news, get_news_item, list_sources, news_stats, quote_placement ## Formats (`format=` or Accept header) - json — {schema, count, cursor, next, sponsored, items[]} - ndjson — one item per line - lines — TSV: seq, id, published, kind, lang, country, source, title, url (fewest tokens) - md — Markdown bullets with summaries - rss, jsonfeed — for feed readers ## Item fields (hottub-news/item/v1) id (n_… news, s_… sponsored) · seq (sync cursor) · kind (article | press_release | official | community | research | sponsored) · title · url · summary (≤480 chars, plain text) · published · seen (RFC 3339 UTC) · lang (ISO 639-1) · country (ISO 3166-1 alpha-2, publisher's) · source {id, name, domain} · via (source we fetched through) · topics[] · authors[] · image · mentions (sources that linked this exact URL, when > 1) · related (sort=hot only) · disclosure (sponsored only). Empty fields are omitted, never null. ## Paid placements Businesses can pay through Hottub Business to place press releases in the mix. Every one has kind="sponsored" and disclosure {paid: true, label, sponsor {id, name, url, verified}, campaign}; text formats prefix the title with "[SPONSORED PRESS RELEASE · paid by …]". At most 3 per page, never first, never adjacent, never on searches or sensitive topics. Add sponsored=exclude to omit them. All running placements: https://hottub.news/v1/sponsored Pricing is public and explained: https://hottub.news/v1/pricing (rate card and formula) and https://hottub.news/v1/pricing/quote?topics=ai&days=7&lang=en. A day's price is base × topic tier × topic interest (share of the current news flow) × demand (other bookings) × targeting reach, with duration discounts. ## Coverage Thousands of RSS/Atom/JSON Feed sources in 50+ languages, the GDELT Global Knowledge Graph (every article GDELT sees, every 15 minutes, 65 languages), space and science agencies, governments and regulators, community rankings, and press wires. Some sources' terms don't allow redistribution; those are used only to weight stories (mentions, sort=hot) and topics, and are never served. ## Reference - [OpenAPI](https://hottub.news/openapi.json) - [Item JSON Schema](https://hottub.news/schema/item.json) - [Sources and their health](https://hottub.news/v1/sources) - [Coverage stats](https://hottub.news/v1/stats) ## Provider Hottub News is provided by Hottub, Inc. — https://joinhottub.com ## Terms Summaries are short excerpts supplied by publishers; the url is the story. Respect each source's terms (listed on /v1/sources). Please keep to about 1 request per second per client; cached responses are free to reuse for their max-age.