Reddit feeds (RSS / JSON) — FetchLayer Docs

Reddit feeds (RSS / JSON)

Reddit shut down its .rss feeds on 18 November 2026. We serve the same feeds from api.fetchlayer.dev: keep the Reddit path, put a feed token in front of it, and your feed reader, Zapier or IFTTT trigger, Discord or Slack bot or script carries on. The same paths ending in .json return Reddit-style listing JSON.

The URL

text
https://api.fetchlayer.dev/feed/<FEED_TOKEN>/<same Reddit path>

Take the Reddit URL you use today, drop https://www.reddit.com, and put https://api.fetchlayer.dev/feed/<FEED_TOKEN> in its place. For example:

text
Before  https://www.reddit.com/r/python/new/.rss
After   https://api.fetchlayer.dev/feed/<FEED_TOKEN>/r/python/new/.rss

Before  https://www.reddit.com/r/python/top/.rss?t=week
After   https://api.fetchlayer.dev/feed/<FEED_TOKEN>/r/python/top/.rss?t=week

Before  https://www.reddit.com/user/spez/comments/.rss
After   https://api.fetchlayer.dev/feed/<FEED_TOKEN>/user/spez/comments/.rss

Before  https://www.reddit.com/r/python/search.rss?q=fastapi&restrict_sr=1
After   https://api.fetchlayer.dev/feed/<FEED_TOKEN>/r/python/search.rss?q=fastapi&restrict_sr=1

Before  https://www.reddit.com/r/python/comments/1xehnro/.rss
After   https://api.fetchlayer.dev/feed/<FEED_TOKEN>/r/python/comments/1xehnro/.rss

JSON    https://api.fetchlayer.dev/feed/<FEED_TOKEN>/r/python/new/.json
Path after the tokenWhat you get
/r/<sub>/new/.rssNewest posts in a community
/r/<sub>/hot/.rssHot posts in a community (rising and controversial work the same way)
/r/<a>+<b>+<c>/new/.rssSeveral communities as one feed; every sort works
/r/<sub>/comments/.rssThe community's newest comments, newest first
/domain/<site>/.rssPosts that link to a site, subdomains included
/domain/<site>/top/.rss?t=weekThe same by new, top, rising or controversial; t is hour, day, week, month, year or all
/r/all/hot/.rss, /r/popular/.rss, /.rssr/all, r/popular and the front page, with every sort, post text and paging, like any community
/r/<sub>/top/.rss?t=dayTop posts; t is hour, day, week, month, year or all
/user/<u>/.rssA user's posts and comments, merged
/user/<u>/submitted/.rssA user's posts
/user/<u>/comments/.rssA user's comments
/search.rss?q=<terms>Search across Reddit
/r/<sub>/search.rss?q=<terms>&restrict_sr=1Search inside one community
/r/<sub>/comments/<id>/.rssThe comments on one post (up to ?limit entries, 25 by default)

Replace .rss with .json on any of these for Reddit-style listing JSON.

Get a feed token

  1. Open your dashboard API keys page.
  2. Under Reddit feed tokens (RSS / JSON), choose Create Reddit feed token.
  3. Copy it. We show it once.
  • A feed token works for these feeds only, and only for Reddit. It cannot call the rest of the API.
  • The token is part of the URL, so anyone with the URL can read the feed on your credits. Do not share it or post it publicly.
  • Revoke it from the same page whenever you like. Create a new one and swap the URL.
  • Prefer not to use the dashboard? Ask support and we will issue one.

What an entry carries

  • A text post carries its body in the entry content (.json: selftext). A link or image post carries its thumbnail picture (.json: preview.images).
  • A community's comments feed titles each entry /u/<user> on <post title>.
  • In a community's comments feed, .json leaves parent_id null for replies, and a comment whose score Reddit still hides has score_hidden true.

Images in the feed

Add ?media=1 to an .rss feed (or &media=1 after other parameters) and each post entry carries its pictures. It is opt-in per feed URL, so feeds without it are unchanged, and it costs nothing extra.

text
https://api.fetchlayer.dev/feed/<FEED_TOKEN>/r/pics/new/.rss?media=1
https://api.fetchlayer.dev/feed/<FEED_TOKEN>/r/earthporn/top/.rss?t=week&media=1
  • Every picture as a Media RSS <media:content medium="image"> with its width and height, the first one as <media:thumbnail>, and the same pictures as <img> tags in the entry content. Readers use one or the other; Discord bots such as MonitoRSS read both.
  • A gallery: every picture, in the post's order, with its caption as media:description and under the image.
  • A video: its still picture, linked to the post. A feed cannot carry a playable Reddit video with sound, so the link is how readers watch it.
  • A link post: its preview image, when it has one. A text post: unchanged.
  • Posts marked NSFW or spoiler carry the real pictures, and the entry says so: a nsfw or spoiler category, and media:rating adult for NSFW. Filter on those if your channel should not show them.
  • Picture addresses can stop working after a while. A reader that shows them as the entry arrives is fine; to keep a picture, download it rather than linking to it.
  • Post and search feeds, a user's posts, posts for a site and a single post's feed carry media. Comment feeds and a user's merged /user/<u>/.rss do not. .json feeds stay Reddit's listing JSON; use the REST API's include: ["media"] for structured media.

Credits

Every refresh you receive bills, so set your reader to check every 15 minutes or more. We bill a feed fetch once, when you receive it; serving a copy you already received again is free.

  • 1 credit per refresh of up to 25 items on every listing path: a community (any sort), a community's comments, posts for a site, r/all, r/popular and the front page, both kinds of search, and a user's posts or comments.
  • Multireddits bill per community: /r/a+b+c/… is 1 credit per community per 25 items, so a 3-community feed is 3 credits per refresh and a 100-community feed is 100. A refresh your balance cannot fully cover is refused before anything is fetched.
  • 2 credits for /user/<u>/.rss, which merges the user's posts and comments.
  • 1 credit for a post's comments (/r/<sub>/comments/<id>/.rss), however large the thread: the post plus its first page of comments, flat.
  • Add ?limit=N (up to 100) for more items per refresh: 1 credit per 25 items (per community on a multireddit).
  • Error entries and error responses are never billed.

Slow refreshes

Many feed readers give up after a few seconds, and a large feed can take longer than that to refresh. So a feed never keeps your reader waiting more than about 4 seconds:

  • If the refresh is not ready by then, your reader gets the last copy of the feed it received (when that copy is under 30 minutes old), free. The refresh finishes anyway, and your reader's next check gets it straight away.
  • If there is no copy yet, the answer is 503 with Retry-After: 20, and the refresh still finishes for the next check.
  • A finished refresh is billed when your reader receives it, under the rules above. One your reader never collects within an hour is never billed.
  • The X-Feed-Copy header says which you got: fresh, stored (a refresh that finished after your last check) or stale (the copy you already had), with its Age in seconds.

Query parameters

  • t: hour, day, week, month, year or all, on top, controversial and search. Anything else is ignored.
  • q and restrict_sr=1 (or true, on) on search, to keep results inside the community.
  • sort on search: relevance, hot, top, new or comments.
  • limit (1 to 100) and after, the cursor from a .json response's data.after.
  • before on /new paths (a community, a multireddit or a user's posts or comments): a post's or comment's fullname (t3_…, t1_…); only what is newer than it comes back.
  • Nothing else is read.

Copy-paste setup

Feedly, Inoreader, Miniflux and FreshRSS: add a new feed and paste the URL, for example https://api.fetchlayer.dev/feed/<FEED_TOKEN>/r/python/new/.rss. Nothing else to set.

Python, feedparser

python
import os
import feedparser

token = os.environ["FETCHLAYER_FEED_TOKEN"]
feed = feedparser.parse(f"https://api.fetchlayer.dev/feed/{token}/r/python/new/.rss")

for entry in feed.entries:
    print(entry.title, entry.link)

Python, requests with .json

python
import os
import requests

token = os.environ["FETCHLAYER_FEED_TOKEN"]
r = requests.get(f"https://api.fetchlayer.dev/feed/{token}/r/python/new/.json", timeout=30)
r.raise_for_status()

for child in r.json()["data"]["children"]:
    post = child["data"]
    print(post["score"], post["title"])

When something is wrong

.rss

Feed readers hide HTTP errors, so a .rss feed answers 200 with a valid feed holding one entry that says what is wrong. It is not billed, and the feed resumes by itself once the cause is fixed. The one exception is a feed whose first refresh is not ready yet: that answers 503 with Retry-After (see Slow refreshes), which readers retry by themselves.

Entry titleWhat to do
Your Reddit feed token is invalid or revokedCreate a new token on the API keys page and use it in the feed URL.
Your FetchLayer credits ran outTop up on the billing page; the feed resumes on the next check.
This feed is checked too oftenSet your reader to check every 15 minutes or more.
This Reddit feed is not availableReddit does not show it right now: the community or user may be private, banned or gone, or the post deleted.
Reddit has no feed at this pathCheck the path against the table above.

.json

A .json feed answers with a real status and Reddit's error shape, {"message": "...", "error": 404}:

  • 401: the token is invalid or revoked.
  • 402: you are out of credits. 429: too many refreshes; it carries Retry-After. These two can also arrive as our usual JSON error body.
  • 404 or 403: the community is private, banned or gone, the user does not exist, or the post was deleted.
  • 404: Reddit has no feed at that path.
  • 503 with Retry-After: the feed's first refresh is not ready yet (see Slow refreshes); it will be on the next check. On .rss feeds too.
  • Any other 5xx is a brief outage on our side; try again shortly.

Related

Product overview Reddit API: what it returns, pricing and use cases