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:
- Reddit post search finds posts by keyword.
- Subreddit details returns size, rules and description.
- Thread and comments returns a post with its comments.
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.