What the key is
Reddit calls it an app: a client ID and a client secret. Your code swaps them for a short-lived OAuth access token, then sends that token with each request. Requests without OAuth are blocked.
You also need a descriptive User-Agent that names your app and a contact, as Reddit asks in its API rules.
Approval and the Responsible Builder Policy
For years anyone could create a key in their account preferences in a minute. That changed in late 2025: Reddit now requires explicit approval before an app can access Reddit data, and self-service key creation was closed to new apps. Existing approved credentials keep working.
The policy also forbids commercialising Reddit data or using it to train AI models without Reddit’s written permission, and forbids hiding what your app does or working around rate limits.
Rate limits once you have a key
- 100 queries per minute per OAuth client ID on the free tier, averaged over a 10-minute window.
- Usage is reported in
X-Ratelimit-Used,X-Ratelimit-RemainingandX-Ratelimit-Reset(seconds until the window ends). - Higher volume and any commercial use need a contract with Reddit. Reddit does not publish a price list; the widely quoted figure from 2023 is $0.24 per 1,000 calls.
Choosing an approach
| You want to | Route |
|---|---|
| Build a Reddit app or bot that acts for users | Apply for official access and follow the Responsible Builder Policy. |
| Do non-commercial research | Apply for official access and state the research use. |
| Read public posts and comments in a commercial product | Get a commercial agreement with Reddit, or use a data API that reads public Reddit pages. |
In Monocrawl
Public Reddit data in Monocrawl
Monocrawl returns public Reddit posts, comments, subreddits and user histories on your Monocrawl key, with no Reddit app to register or tokens to refresh.
reddit/searchfor posts across Reddit with sort and time filters.reddit/search-commentsfor comments that mention a term.reddit/post/commentsfor the comment tree under a post.reddit/subredditfor a community’s hot, new, top or rising posts.reddit/omni-searchfor threads, top comments and communities for one keyword in a single call.
You can also watch Reddit for new mentions of a brand or keyword with a Monitor.
Common questions
Is the Reddit API free?
The free tier allows 100 queries per minute per approved app for non-commercial use. Commercial use needs an agreement with Reddit.
Can I still create a Reddit API key?
New apps now need Reddit’s approval before they can access data. The old instant self-service route was closed in late 2025.
What User-Agent should I send to Reddit?
A unique, descriptive one, such as platform:app-id:version (by /u/yourname). Generic browser strings are more likely to be limited.
Sources