Skip to content

Reddit JSON API: add .json to a URL, and why it is not enough

The Reddit JSON API: how adding .json to a Reddit URL returns data, its limits for scripts, and a stable read-only alternative with paging and a free test key.

Piyushh · November 7, 2026 · 1 min read

The Reddit JSON API is the trick of adding .json to a Reddit URL. Put .json on the end of a subreddit listing or a post link and you get JSON back instead of a web page. That's handy for a quick look, but it isn't a dependable base for a script.

What it returns

The JSON holds the same listings you see on the page (posts, scores, authors and comment trees) in Reddit's own nested format. Open it in a browser to inspect the fields.

Why it falls short for scripts

  • It is unauthenticated, so it gets rate limited and is easy to block.
  • The nested format takes work to flatten.
  • Nothing guarantees it keeps working. See our posts on scraping Reddit and Reddit API vs scraping.

A stable version of the same idea

A hosted API returns flat JSON and a cursor for paging:

curl "https://api.chatterapi.com/v1/reddit/search?q=python+tips&time=month" \
  -H "Authorization: Bearer $CHATTERAPI_KEY"

Send a key, read data and follow page.nextCursor. The Reddit search API guide has more, or you can try the free Reddit scraper first. ChatterAPI is independent of Reddit and read-only.

FAQ

How do I get Reddit data as JSON?
Add .json to the end of many Reddit URLs, for example a subreddit or a post link. The page returns JSON instead of HTML.
Is the Reddit .json endpoint reliable for scripts?
It is unauthenticated and rate limited, and automated clients are often blocked. Developers report it failing in production.
What is a stable alternative?
A hosted API with a key and a fixed response shape. See the Reddit API for scripts section.

More on Reddit API

Try it free for 7 days.

1,000 credits to make your first calls. One key for Reddit and X, over REST or MCP.