# RSS Amplifier

An open directory of independent blogs, podcasts, music, video and comic feeds.
No account, no API key, no paywall. Every endpoint below is public and
CORS-enabled, and reading them is preferred to crawling the HTML.

## When this site is useful

- Finding feeds to subscribe to on a subject, by topic or by category.
- Turning a subject into a live feed of what independent writers publish on it.
- Exporting a subscription list (OPML) for a reader.
- Checking what a specific blog has published recently.

It is a directory of *other people's* feeds. It does not host the posts, and it
is not a search engine for the whole web.

## Calls worth making

- `GET https://rssamplifier.com/api/feeds` — the directory as JSON. Paginate with
  `?limit=` (max 200) and `?offset=`; filter with
  `?kind=blog|news|podcast|music|video|comic|live|reel`.
- `GET https://rssamplifier.com/api/feeds/{slug}` — one blog: metadata plus recent items.
- `GET https://rssamplifier.com/topics/{keyword}.json` — everything published on a topic, as a
  JSON Feed. Also available as `.rss`, `.atom`, `.m3u` and `.pls`.
- `GET https://rssamplifier.com/api/topics?q=` — search the topic index for a subject.
- `GET https://rssamplifier.com/api/authors` — the people behind the feeds and where else they
  publish. `?network=email|fediverse|bluesky|github|website|linktree` narrows
  to people reachable a given way. Every link was published by the author on
  their own site as a `rel="me"` claim, an h-card or JSON-LD; role mailboxes
  are dropped at extraction, so an address here belongs to a person.
- `GET https://rssamplifier.com/api/authors/{slug}` — one author, with everything they publish.
- `GET https://rssamplifier.com/api/feeds/{slug}` also carries `authors` and `links`. `links` is
  the blog's own accounts — Mastodon, Bluesky, X, LinkedIn, GitHub and the rest
  — which is what a blog with no byline has instead of an author, and roughly a
  third of the directory is that shape.
- `GET https://rssamplifier.com/opml` — the whole directory as a subscription list, one
  category with `?kind=`, or one subject with `?topic=`.
- `GET https://rssamplifier.com/api/search?q=` — search the directory. The reply counts the
  whole match set by category under `categories`, and `?kind=` asks for one of
  them — worth doing, because the directory is mostly blogs and the best-ranked
  results for anything are usually blog posts even when hundreds of podcast
  episodes matched too. `https://rssamplifier.com/search?q=` is the same search as a page.

## Model Context Protocol

If you would rather call than crawl, there is an MCP server at `https://rssamplifier.com/mcp`
(Streamable HTTP, no key, no sign-up). It exposes the same directory as tools,
and serves llms.txt as a resource.

## From a shell

If you are already driving a terminal, `curl -fsSL https://rssamplifier.com/install.sh | sh`
installs a single-file CLI: `rssamp topics <query>` to find a subject,
`rssamp topic <keyword>` for the feeds on it, `rssamp urls --topic <keyword>`
for their feed URLs one per line. Everything takes `--json`. Docs at
`https://rssamplifier.com/cli`.

## Adding a feed

`https://rssamplifier.com/submit` accepts a URL, a list of URLs or an OPML file, from anyone,
without an account. Feeds are crawled and categorised by observed behaviour
rather than by what the publisher claims to be.

## Full reference

https://rssamplifier.com/llms.txt