Skip to content

Reddit API documentation: where it is and what changed

Reddit API documentation in one place: where Reddit publishes it, what the 2026 access changes mean, and the endpoint docs for a hosted alternative with working examples.

Piyushh · November 7, 2026 · 1 min read

Reddit API documentation lives in two places: the reference Reddit publishes for its own Data API, and the docs of any service that sells access to Reddit data. Which one you need depends on whether Reddit will approve an app of your own.

Reddit's own documentation

Reddit documents its Data API at reddit.com/dev/api, with endpoints for search, subreddits, posts and comments. Who may get a token is set by its Responsible Builder Policy. The Reddit API guide and the guide to getting a Reddit API key cover what changed and when.

The reference alone doesn't get you access. A new app needs Reddit's approval, which is why many developers read the docs and then go looking for another route.

Documentation for ChatterAPI's Reddit endpoints

ChatterAPI is an independent service that reads public Reddit data and is not affiliated with Reddit. Its Reddit endpoints are documented chapter by chapter at /docs/reddit, and All endpoints lists every one. Each endpoint page gives the parameters, a request sample in curl, Python and JavaScript, and a recorded response.

The pages people use most:

A first call from the documentation

curl "https://api.chatterapi.com/v1/reddit/search?q=best+crm+for+small+business&time=year" \
  -H "Authorization: Bearer $CHATTERAPI_KEY"

The response is JSON with a data array, a page object holding nextCursor, and a credits object. To get the next page, pass nextCursor back. Query options are covered in the Reddit search API guide.

Which documentation do you need?

Use Reddit's reference if you have an approved app and want to follow Reddit's own contract. Use the ChatterAPI docs if you want read-only access without applying, or the same call shape for Reddit and X. The comparison with the official API lists the differences.

To try an endpoint first, open the free Reddit post search.

FAQ

Where is the official Reddit API documentation?
Reddit publishes its Data API reference at reddit.com/dev/api and its developer policies on the Reddit help center. Access to new tokens now needs approval, so reading the docs and getting a key are separate steps.
Is there documentation for a Reddit API that needs no Reddit developer account?
Yes. ChatterAPI documents every Reddit endpoint at /docs/reddit, with parameters, a request sample and a recorded response for each one.
Does the documentation show response fields?
Each endpoint page lists the fields and shows a real recorded response with its capture date.

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.