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
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:
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 token | What you get |
|---|---|
| /r/<sub>/new/.rss | Newest posts in a community |
| /r/<sub>/hot/.rss | Hot posts in a community (rising and controversial work the same way) |
| /r/<a>+<b>+<c>/new/.rss | Several communities as one feed; every sort works |
| /r/<sub>/comments/.rss | The community's newest comments, newest first |
| /domain/<site>/.rss | Posts that link to a site, subdomains included |
| /domain/<site>/top/.rss?t=week | The same by new, top, rising or controversial; t is hour, day, week, month, year or all |
| /r/all/hot/.rss, /r/popular/.rss, /.rss | r/all, r/popular and the front page, with every sort, post text and paging, like any community |
| /r/<sub>/top/.rss?t=day | Top posts; t is hour, day, week, month, year or all |
| /user/<u>/.rss | A user's posts and comments, merged |
| /user/<u>/submitted/.rss | A user's posts |
| /user/<u>/comments/.rss | A user's comments |
| /search.rss?q=<terms> | Search across Reddit |
| /r/<sub>/search.rss?q=<terms>&restrict_sr=1 | Search inside one community |
| /r/<sub>/comments/<id>/.rss | The 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
- Open your dashboard API keys page.
- Under Reddit feed tokens (RSS / JSON), choose Create Reddit feed token.
- 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,
.jsonleavesparent_idnull for replies, and a comment whose score Reddit still hides hasscore_hiddentrue.
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.
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:descriptionand 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
nsfworspoilercategory, andmedia:ratingadult 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>/.rssdo not..jsonfeeds stay Reddit's listing JSON; use the REST API'sinclude: ["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
503withRetry-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-Copyheader says which you got:fresh,stored(a refresh that finished after your last check) orstale(the copy you already had), with itsAgein seconds.
Query parameters
t:hour,day,week,month,yearorall, on top, controversial and search. Anything else is ignored.qandrestrict_sr=1(ortrue,on) on search, to keep results inside the community.sorton search:relevance,hot,top,neworcomments.limit(1 to 100) andafter, the cursor from a.jsonresponse'sdata.after.beforeon/newpaths (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
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
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 title | What to do |
|---|---|
| Your Reddit feed token is invalid or revoked | Create a new token on the API keys page and use it in the feed URL. |
| Your FetchLayer credits ran out | Top up on the billing page; the feed resumes on the next check. |
| This feed is checked too often | Set your reader to check every 15 minutes or more. |
| This Reddit feed is not available | Reddit 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 path | Check 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 carriesRetry-After. These two can also arrive as our usual JSON error body.404or403: 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.503withRetry-After: the feed's first refresh is not ready yet (see Slow refreshes); it will be on the next check. On.rssfeeds too.- Any other
5xxis a brief outage on our side; try again shortly.
Related
- Use with PRAW: the same Reddit data from Python, with four lines of configuration.
- Reddit REST endpoints: every field, with examples.