In short
- Reddit API credentials are an app’s client ID and, for web and script apps, a client secret, created at reddit.com/prefs/apps. Read on Reddit OAuth2 wiki (github.com/reddit-archive) (opens in a new tab)
- Reddit requires you to request access and get explicit approval before you read any Reddit data through its API, and explicit written approval for commercial use. Read on Responsible Builder Policy (Reddit Help) (opens in a new tab)
- Reddit stopped accepting new requests for public Data API access on 2026-10-31, and the remaining public access ends in March 2027. Read on Reddit admin post in r/redditdev, “Moving Data API Apps to the Developer Platform” (2026-09-30) (opens in a new tab)
- As of 2026-11-14, free access is limited to 100 queries per minute per OAuth client ID. Read on Reddit Data API Wiki (Reddit Help) (opens in a new tab)
- PrimaryAPI reads public subreddits, posts, comments and search results with one key and no Reddit app to register.
What a Reddit API key is
Reddit has no single API key. You register an app, get a client ID (plus a client secret if the app can keep one), and exchange them for an OAuth access token that goes on every request. Read on Reddit OAuth2 wiki (github.com/reddit-archive) (opens in a new tab)
Every Data API request needs a registered OAuth token. Reddit says it can throttle or block users it cannot identify, and traffic without OAuth or login credentials is blocked. Read on Reddit Data API Wiki (Reddit Help) (opens in a new tab)
| App type | Where it runs | Client secret |
|---|---|---|
| Web app | As part of a web service on a server you control | Yes |
| Installed app | On devices you don’t control, such as a user’s phone | No |
| Script app | On hardware you control, with access only to your own account | Yes |
How to get Reddit API access today
Registering an app used to be the whole process. Now it is the last step, after Reddit has approved your use case.
Reddit stopped accepting new requests for public Data API access on 2026-10-31. Read on Reddit admin post in r/redditdev, “Moving Data API Apps to the Developer Platform” (2026-09-30) (opens in a new tab)
A project starting now should plan for a commercial agreement with Reddit, for its Developer Platform, or for another way to read public data.
- Read the Responsible Builder Policy, the Developer Terms and the Data API Terms: Reddit makes all Data API use subject to them. Read on Reddit Data API Wiki (Reddit Help) (opens in a new tab)
- Request access through Reddit’s help center. Non-commercial use has a sign-up form, and commercial use a separate request form. Read on Developer Platform & Accessing Reddit Data (Reddit Help) (opens in a new tab)
- Wait for explicit approval, and send one request per use case: Reddit treats several accounts or requests for the same use case as masking how you access its data. Read on Responsible Builder Policy (Reddit Help) (opens in a new tab)
- Once approved, create the app at reddit.com/prefs/apps, pick the app type, and copy the client ID and secret. Read on Reddit OAuth2 wiki (github.com/reddit-archive) (opens in a new tab)
- Send a unique User-Agent such as <platform>:<app ID>:<version string> (by /u/<reddit username>). Generic ones like Python/urllib are drastically limited. Read on Reddit Data API Wiki (Reddit Help) (opens in a new tab)
Commercial use and what Reddit charges
Reddit counts any use by or for a business, or as part of a monetized product, as commercial: apps with ads or paywalls, subscription services and paid data access among them. Commercial use needs Reddit’s permission and a contract. Read on Developer Platform & Accessing Reddit Data (Reddit Help) (opens in a new tab)
Reddit publishes no price list. Its help center says it offers free and paid access, that bulk exporting is significantly limited by default, and that select developers who need broader access may be charged fees to lift those limits. Read on Developer Platform & Accessing Reddit Data (Reddit Help) (opens in a new tab)
Reddit also says you cannot display Reddit content and run ads in the same app, website or service. Read on Developer Platform & Accessing Reddit Data (Reddit Help) (opens in a new tab)
Because Reddit does not publish a rate, treat any per-call Reddit price you see quoted online as unconfirmed.
Reddit API rate limits
These limits apply to free access, as Reddit’s Data API Wiki states them on 2026-11-14.
- Requests: 100 queries per minute per OAuth client ID, averaged over a 10-minute window so short bursts are fine. Read on Reddit Data API Wiki (Reddit Help) (opens in a new tab)
- Chat: 2,000 messages per day per recipient and 3,000 per day in total. Read on Reddit Data API Wiki (Reddit Help) (opens in a new tab)
- Headers: X-Ratelimit-Used, X-Ratelimit-Remaining and X-Ratelimit-Reset show how much of the window you have used. Read on Reddit Data API Wiki (Reddit Help) (opens in a new tab)
- Mod bots that need more can ask Reddit through its contact form. Read on Reddit Data API Wiki (Reddit Help) (opens in a new tab)
The 2026 and 2027 dates
If you build on public Data API access, these dates set its end.
- 2026-10-31: Reddit stopped accepting new requests for public Data API access. Read on Reddit admin post in r/redditdev, “Moving Data API Apps to the Developer Platform” (2026-09-30) (opens in a new tab)
- 2027-01-12: Reddit begins cutting off apps and users that have not registered. Read on Reddit admin post in r/redditdev, “Moving Data API Apps to the Developer Platform” (2026-09-30) (opens in a new tab)
- March 2027: the remaining public API access ends. Read on Reddit admin post in r/redditdev, “Moving Data API Apps to the Developer Platform” (2026-09-30) (opens in a new tab)
- Reddit is moving Data API apps, especially mod bots and community tools, to its Developer Platform (Devvit), and runs a $1,000,000 App Migration Program for developers who register existing apps. Read on Migrating apps from the Data API to Devvit (developers.reddit.com) (opens in a new tab)
Read public Reddit data with one PrimaryAPI key
PrimaryAPI reads public Reddit data with your PrimaryAPI key: a subreddit’s posts, a single post, comment threads, search across Reddit or inside one subreddit, trending posts and a user’s posts. There is no Reddit app to register and no access request to wait on.
Create an account, copy your key and send a request to the Reddit Subreddit Posts API with a subreddit name. Each API’s page shows its price per call, its fields and an example response, and you only pay when data comes back.
Credits you buy never expire, every key can carry its own spend limit, and the same key reads X, Threads, YouTube and the rest of the catalog.
When Reddit’s own APIs are the right choice
Use Reddit’s Developer Platform for mod tools, bots and games that run inside Reddit, and the Data API, with Reddit’s approval, when you post, comment or message for signed-in users. PrimaryAPI reads public data only.
For ad campaigns and ad reports, the Reddit Ads API is open to all developers and needs no allowlisting or approval. Read on Reddit Ads API v3 reference (ads-api.reddit.com) (opens in a new tab)
Try it with PrimaryAPI
One key for every API below, for your code and your AI agents. You only pay when data comes back.
- Reddit Subreddit PostsPosts of one subreddit listing, cursor paged2 credits / call
- Reddit Post CommentsComments of a Reddit post by URL, flattened depth-first with parent ids, scores and timestamps, cursor paged2 credits / call
- Reddit SearchSearch Reddit posts across all subreddits by query, with sort order and time window, cursor paged2 credits / call
- Reddit PostOne Reddit post by URL: title, body, author, subreddit, score, upvote ratio, comment count and flags2 credits / call
- Reddit Subreddit SearchSearch posts inside one subreddit by query, sort order and time window, cursor paged2 credits / call
- Reddit User PostsPosts submitted by one Reddit user, sorted by new, top, hot or controversial, cursor paged2 credits / call