Reddit JSON API

Implementation notes

When to use Reddit JSON API

Appending `.json` to any Reddit URL is the semi-official way to get read access to posts and comments without OAuth. Reddit's official free API tier became effectively unusable in June 2023 (see /graveyard), so `.json` endpoints are what's left for hobbyists, learning projects, and light-weight aggregators. Use this pattern for: read-only apps that surface content from specific subreddits, weekend projects analyzing community discussion, learning HTTP and pagination. Do NOT use it for production apps that depend on stable access — Reddit's stance on `.json` is 'we haven't shut it down yet' and could change at any point.

Common pitfalls

• A `User-Agent` header is required and must not be a generic browser string. Reddit blocks requests from common browser user agents to prevent scraping. Use a descriptive custom string like `my-project/1.0 by u/your_username`.
• The `.json` endpoint is not an officially supported API. Reddit has not committed to its stability, and the response structure has changed without notice in the past. For production apps, prefer the official OAuth API at `oauth.reddit.com`, which is more stable.
• The `after` pagination token is tied to the current request's sort order. Changing the sort (`top`, `new`, `hot`) between paginated requests invalidates the token and restarts pagination from the first page silently.
• Deleted comments return a JSON object with `[deleted]` as the body and `[deleted]` as the author rather than being excluded. Your code must explicitly filter these if you are building a display interface.
• Rate limit is 60 requests/minute per IP for unauthenticated access. Behind NAT (dorm networks, small offices, corporate WiFi) this is shared across all users on that egress IP — you can be throttled even when you personally are making one call per minute.

Quick start (bash)

curl -H "User-Agent: my-app/1.0" "https://www.reddit.com/r/programming/top.json?limit=5&t=week"

From our monitoring

In our monitoring, the `.json` endpoint has been surprisingly reliable — 99%+ uptime with response times under 400ms globally. Reddit has NOT shut it down despite killing the official free API in 2023, which suggests they view it as low-cost enough to leave running. That could change without warning; do not build a paid product on it. For anything hobby-scale, it works well enough to be worth using.

Production integration patterns

Subreddit trend digest

The most popular use of `.json` is a daily/weekly digest of top posts from a curated set of subreddits. Pattern: at 00:00 UTC, fetch `/r/{subreddit}/top.json?t=day&limit=25` for each subreddit in your list (say 5-10 subreddits), dedupe by URL, rank by score, and send an email digest or Slack post. Total API calls: 10 per day, well under any limit. Requires no user auth, deployable to Cloudflare Workers on the free tier.

Keyword mention tracker (careful)

For brand mention tracking across Reddit, do NOT hit `/search.json` in a loop across all subreddits — Reddit will silently degrade or block you. Instead, target specific subreddits where your keyword is relevant, hit their `/new.json` once every 5-10 minutes, and filter client-side. Combined with a 5-day sliding cache of seen post IDs, this gives you near-real-time mention detection at ~12 API calls/hour. Much friendlier and just as effective.

Compared to the closest paid alternatives

vs Reddit OAuth API — Free: 100/min personal · Commercial: $0.24 per 1k requests

Reddit's official OAuth API remains free at 100 queries/minute for authenticated apps, but the free tier since 2023 is aggressively enforced — production apps hitting it consistently get throttled or banned. The paid tier for commercial use starts at ~$0.24 per 1,000 requests. For personal projects the OAuth flow is worth the setup vs `.json` because it's supported and stable.

vs Pushshift.io (community) — Free with approval

Pushshift is a community-maintained archive of Reddit content, hugely useful for historical research and full-text search back to 2005. Access has been restricted since 2023 (auth required, some data behind approval). If your project needs history rather than live data, Pushshift is the answer — but expect a manual approval process.

Embed this badge

Add a live status badge to your README, docs, or website.

Markdown

[![Reddit JSON API Status](https://freeapi-builder.a10ayassine.workers.dev/badge/reddit-json.svg)](https://freeapi.watch/reddit-json)

HTML

<a href="https://freeapi.watch/reddit-json"><img src="https://freeapi-builder.a10ayassine.workers.dev/badge/reddit-json.svg" alt="Reddit JSON API Status"/></a>