Reddit API reference
Get public Reddit posts, comments, communities and user activity as clean JSON. Send a subreddit, a search or a thread link. No Reddit account and no API keys of your own.
The Reddit API has 9 endpoints, called the same way: POST /execute with the endpoint ID as capability and its fields as input, or pin Reddit in the MCP server and call each one as a tool. The data comes back as JSON in results[0].data, with what the call cost in billing.credits_charged.
The inputs you send most are q, subreddits and url. Prices run from 0.25–1 credits to 1 credit per call, and a failed call costs nothing.
Endpoints
Open an endpoint for its input, the fields it returns and the request in cURL, Python and Node.js.
| Endpoint | What it returns | Price |
|---|---|---|
reddit.posts.list |
List public posts from one or more subreddits, sorted new, hot, top or rising, page by page. | 1 credit |
reddit.posts.search |
Search public posts across Reddit or within chosen subreddits, sorted by relevance, new, top or most comments, over a time window. | 0.75–3 credits |
reddit.post.get |
Get one post from its thread link: title, text, author, subreddit, score and comment count. | 0.5 credits |
reddit.post.comments.list |
Get a sample of the public comments on one thread: text, author, score and time. | 0.5–1 credits |
reddit.comments.list |
List the newest public comments across one or more subreddits, page by page. | 0.5 credits |
reddit.subreddit.get |
Get a community's card: name, description, weekly visitors and whether it is marked NSFW. | 0.5 credits |
reddit.subreddit.search |
Find communities by name or topic, in Reddit's order of relevance. | 0.5 credits |
reddit.user.posts.list |
List the posts a public account has submitted, newest first. | 0.25–1 credits |
reddit.user.comments.list |
List the comments a public account has made, newest first, with the post each one answers. | 0.5–1.5 credits |
What to know
- Thread comments are a sample A thread's comments come back as a sample of the discussion, not every reply.
- Scores when Reddit shows them Some listings leave out a post's score or comment count. The response says so, so a missing number is never read as zero.
- Next pages List and search endpoints return a next value. Send it back with the same input to continue.
- Some calls take longer A call can take up to a minute when Reddit is slow to answer. Ask your client to wait for it.
Something missing or unclear? Ask the team that builds the Reddit endpoints.