Send your Redditapis key as a bearer token: an Authorization header with the value Bearer YOUR_API_KEY, on every request to api.redditapis.com. There is no OAuth handshake, no client id and secret pair, and no developer-app review. The key is issued at signup and works immediately on all 74 endpoints.
Reddit API documentation
One bearer token, 74 endpoints, JSON in and JSON out. This page is the map of the whole surface with what each call costs. The per-endpoint reference lives in the full docs. Our platform documents 74 REST endpoints, per our published endpoint list.
How does the Redditapis REST API work?
Redditapis is a REST API for Reddit data and actions. You send one bearer token against api.redditapis.com and get JSON back, with no OAuth handshake and no developer-app review. There are 74 published endpoints across listings, posts and comments, typed search, users, write actions, direct messages, and account billing. Reads cost $0.0015 per call, votes $0.005, writes $0.012, and direct messages $0.025, billed per call rather than per row returned.
Base URL and authentication
Every endpoint lives under https://api.redditapis.com and takes the same header. There is no token exchange step, so the first call you write is also the call you ship.
Authenticated request
# Every call takes the same bearer token.
curl "https://api.redditapis.com/api/reddit/search?q=api&subreddit=webdev&limit=25" \
-H "Authorization: Bearer YOUR_API_KEY"What you do not need
- No OAuth client id and secret pair.
- No Reddit developer-app registration or review.
- No refresh-token rotation to maintain.
- No per-scope approval before you can read comments.
New to this? The API key guide covers issuing and rotating a token.
Every endpoint, by family
All 74 published endpoints. Prices are per call, not per row, so a listing that returns 100 items costs the same as one that returns three.
Listings
3 endpointsPull posts out of a subreddit or the whole site. These are the endpoints most integrations start with.
| Endpoint | Per call | What it returns |
|---|---|---|
GET /api/reddit/posts | $0.0015 | Posts from a subreddit, sorted hot, new, top, rising, controversial, or best. |
GET /api/reddit/search | $0.0015 | Keyword search, either sitewide or restricted to one subreddit. |
GET /api/reddit/sub/{name}/top | $0.0015 | Top posts in a subreddit for a timeframe. |
Posts and comments
6 endpointsRead a single post, walk its full comment tree, or check a batch of comment ids in one call.
| Endpoint | Per call | What it returns |
|---|---|---|
GET /api/reddit/post/{id} | $0.0015 | One post with its comment tree. |
GET /api/reddit/post/{id}/comments | $0.0015 | Comment tree for a post id. |
GET /api/reddit/comments/{postId} | $0.0015 | Alias of the route above, kept for older clients. |
GET /api/reddit/comments | $0.0015 | Comment tree addressed by permalink instead of id. |
GET /api/reddit/comment/{id} | $0.0015 | A single comment by id. |
POST /api/reddit/comments/verify | $0.0015 | Check up to 100 comment ids as live, deleted, removed, or not found. POST because 100 ids do not fit in a query string, and it bills at the read rate at any batch size. |
Typed search
5 endpointsSearch one entity type at a time instead of filtering a mixed result set on your side.
| Endpoint | Per call | What it returns |
|---|---|---|
GET /api/reddit/search/communities | $0.0015 | Find subreddits by keyword. |
GET /api/reddit/search/comments | $0.0015 | Search comment bodies. |
GET /api/reddit/search/media | $0.0015 | Image, video, and gallery posts only. |
GET /api/reddit/search/users | $0.0015 | Find Reddit accounts by name. |
GET /api/reddit/search/comments/deep | $0.02 | Priced above the flat rate because a single call runs a comment search and then reads the comment tree of each matching parent post, 5 by default and up to 25 with limit, so the price tracks the fan-out. At most 2 run at once per account. |
Users
2 endpointsProfile data and recent activity for a named account.
| Endpoint | Per call | What it returns |
|---|---|---|
GET /api/reddit/user/{name} | $0.0015 | Profile and karma for one account. |
GET /api/reddit/user/{name}/comments | $0.0015 | Recent comments by that account. |
Auth, profile, and write actions
7 endpointsEverything that changes state on Reddit. Authenticate once, then act with the returned session.
| Endpoint | Per call | What it returns |
|---|---|---|
POST /api/reddit/login | $0.012 | Authenticate a Reddit account and get a session for the write endpoints. |
POST /api/reddit/comment | $0.012 | Post a comment or a reply. |
POST /api/reddit/v2/comment | $0.012 | The v2 comment path. |
POST /api/reddit/vote | $0.005 | Upvote, downvote, or clear a vote. |
POST /api/reddit/profile/description | $0.012 | Set the profile description. |
POST /api/reddit/profile/display-name | $0.012 | Set the display name. |
POST /api/reddit/profile/avatar | $0.012 | Set the account avatar. |
Direct messages
3 endpointsSend and read Reddit DMs. This is the surface no other third-party provider exposes.
| Endpoint | Per call | What it returns |
|---|---|---|
POST /api/reddit/dm | $0.025 | Send a direct message. |
POST /api/reddit/dm/threads | $0.025 | List DM threads for the authenticated account. |
POST /api/reddit/dm/messages | $0.025 | List the messages inside one thread. |
Account
2 endpointsYour own billing state. These two never cost a credit.
| Endpoint | Per call | What it returns |
|---|---|---|
GET /account/me | Free | Account details and remaining credit balance. |
GET /account/payments | Free | Payment history. |
Feedback
2 endpointsTell the team what broke or what is missing. Built for AI agents, free on every plan.
| Endpoint | Per call | What it returns |
|---|---|---|
POST /feedback | Free | Send a bug, idea or missing-capability report. 10 per minute per key. |
GET /feedback/{id} | Free | Read whether a report was triaged, shipped or declined, and the team's response. |
Request and response schemas for each of these live in the full endpoint reference, and the machine-readable version is at openapi.json.
Pagination
Listing responses carry an after value. Pass it straight back to get the next page. It is an opaque cursor we issue, not a raw Reddit fullname, because the cursor also carries how deep into the listing you already are. When it comes back null, the listing is exhausted.
Python pagination
# Page with the cursor we return. Do not hand-build a Reddit fullname.
first = requests.get(
"https://api.redditapis.com/api/reddit/posts",
params={"subreddit": "webdev", "sort": "new", "limit": 100},
headers={"Authorization": "Bearer YOUR_API_KEY"},
).json()
cursor = first["after"] # None means the listing is exhausted
if cursor:
page_two = requests.get(
"https://api.redditapis.com/api/reddit/posts",
params={"subreddit": "webdev", "sort": "new", "limit": 100, "after": cursor},
headers={"Authorization": "Bearer YOUR_API_KEY"},
).json()Reddit itself stops most listings around 1,000 items. The pagination guide covers what to do when you hit that ceiling.
Errors and billing behaviour
Errors come back as JSON with a single error field. These are the ones worth handling explicitly.
| Status | Body | What it means |
|---|---|---|
| 400 | {"error": "..."} | A required parameter is missing or malformed. The message names the parameter. |
| 401 | {"error": "Missing Bearer token"} | No Authorization header was sent. |
| 402 | {"error": "Insufficient credits"} | The key is valid but the balance is empty. Top up and retry. |
| 403 | {"error": "Invalid token"} | The bearer token was not recognised. |
| 404 | {"error": "..."} | No route matched, or Reddit has no such post, comment, or account. |
| 429 | {"error": "rate_limited", "retry_after": ...} | Your key went over its pace (a burst of about 20 calls, then a steady pace of about 10 reads a second) and this call would have waited more than 10 seconds in line. Not billed; wait the Retry-After seconds. Every read carries X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset, so a client can pace itself and never see this. |
| 502 | {"error": "..."} | Reddit failed upstream. Retry with backoff; a failed upstream read is not billed. |
A request that matches no route is not billed, and an OPTIONS preflight is not billed, because neither runs a handler or makes an upstream Reddit call. Rate limiting against Reddit is handled on our side with retries and backoff, so you write against clean JSON instead of planning around a shared quota. Your own key gets a burst of about 20 calls, then a steady pace of about 10 reads a second; a call over the pace gets a short wait instead of an error, and the X-RateLimit headers on every read show where you stand.
Where to go from here
This page is the surface map. These take you deeper:
- Quickstart , first call in five minutes
- Pricing , the full per-tier rate card
- MCP server , the same endpoints as agent tools
- Complete 2026 guide , the long-form walkthrough
- Community and support , where to ask when something breaks
- Search API , query parameters in depth
Frequently asked questions
There are 74 published endpoints: 38 flat-rate reads, 2 premium read, 1 vote endpoint, 7 write endpoints, 3 direct-message endpoints, and 22 free account endpoints. That count comes from the same source the OpenAPI document is generated against, so the reference on this page and the machine-readable spec cannot disagree.
Reads are $0.0015 per call, votes $0.005, writes $0.012, and direct messages $0.025. Deep comment search is $0.02 because one call fans out into a search plus one comment-tree read per matching parent post, 5 by default and up to 25. The post visibility check is $0.004 because it makes exactly two upstream calls. Account endpoints are free. The unit is the call, not the row, so a read that returns 100 items still costs $0.0015.
Listing responses carry an after value. Pass it back as the after parameter on the next request to get the following page. It is an opaque cursor issued by us, so do not construct one from a Reddit fullname. When after comes back null the listing is exhausted.
A request that matches no route is not billed, and an OPTIONS preflight is not billed, because neither one runs a handler or makes an upstream Reddit call. A request that reaches a handler is billed at its tier rate.
Yes. The machine-readable OpenAPI 3.1 document is published at docs.redditapis.com/openapi.json, and it is also advertised from the API catalog at /.well-known/api-catalog so agents can discover it without reading this page.
By the numbers
The API surface, by the numbers
Every Redditapis figure resolves to our published rate card and endpoint count; every external figure is a primary source.
The API publishes 74 endpoints: 38 flat-rate reads, 2 premium read, 1 vote endpoint, 7 writes, 3 direct-message endpoints, and 22 free account endpoints. (Redditapis, 2026)
Reads bill at $0.0015 per call, votes at $0.005, writes at $0.012, and direct messages at $0.025, with deep comment search at $0.02 for its fan-out. (Redditapis pricing, 2026)
Every new account starts with $0.50 in free credits and no card on file, which covers 333 reads before any charge. (Redditapis, 2026)
Reddit's own free Data API access is limited to 100 queries per minute per OAuth client, and traffic without OAuth is blocked. (Reddit Data API Wiki, 2026)
Reddit's commercial Data API was reported at $0.24 per 1,000 API calls, the rate that ended third-party apps like Apollo in 2023. (The Verge, 2023)
Reddit signed a reported $60 million-a-year deal to license its data for AI training, which is why programmatic access is gated the way it is. (Reuters, 2024)
Keep reading.
Continue exploring related pages.
Reddit API documentation
The complete 2026 reference: auth, all 74 endpoints, and code.
Get a Reddit API key
Instant bearer token, no waitlist and no enterprise contract.
Reddit Responsible Builder Policy
Why Reddit denies API applications, and the managed REST bypass.
Reddit API use cases
14 use cases from AI training to brand monitoring and DMs.
Reddit Search API
Search posts, comments, users, and communities over one REST endpoint.
Reddit MCP server
Wrap the REST API as MCP tools for Claude, Cursor, and any MCP client.
Reddit MCP hub
Install tabs for every client, the full tool table, pricing and fixes.
Reddit API for AI agents
Live Reddit context for tool calls, MCP servers, and RAG pipelines.
Redditapis pricing
Endpoint-level costs and quick monthly totals - reads from $0.0015 / call.
Reddit API cost calculator
Estimate monthly spend using your request volume.
Reddit API guides and tutorials
Tutorials, walkthroughs, and API deep-dives for developers.
Reddit API alternatives
Evaluate alternatives by cost model, limits, and integration fit.
Cheap Reddit API
The cheapest way to get Reddit data: $0.0015 per call, no contract, no minimum.
Official Reddit API vs Redditapis
Access, setup, rate limits, and pricing, side by side.
PRAW alternative
A hosted Reddit REST API for any language, no app registration or OAuth.
Reddapi alternative
A maintained Reddit REST API with published pricing and write endpoints.
Reddit comment scraper alternative
The raw comment API: search and filter comments, historical and live, clean JSON.
Reddit scraper API
Hosted scraper API vs building your own: no proxies to manage, clean JSON.
RapidAPI Reddit alternative
A direct, maintained Reddit API with published pricing and write endpoints.
Bright Data Reddit alternative
A purpose-built Reddit API vs a general scraping platform: structured JSON, plus writes.
ScraperAPI Reddit alternative
A Reddit-native API vs a generic HTML fetcher: auth and pagination handled, typed JSON.
TikHub alternative
TikHub's Reddit surface is read-only; get comment, vote, and DM endpoints too.
EnsembleData alternative
No $100/month floor: pay per call from $0.0015, plus write, vote, and DM endpoints.
Scrape Creators alternative
7 read-only Reddit endpoints vs a dedicated API with real write, vote, and DM paths.
FetchLayer alternative
Posts, comments, and search only; add vote, comment, and DM over the same REST auth.
PullPush alternative
PullPush is free but volunteer-run and goes offline for reindexing; a maintained REST API that stays up.
Reddit monitoring API
Build your own keyword and brand-mention monitor: search, comment search, and subreddit streams over REST.
F5Bot vs Redditapis
F5Bot's Slack and Discord delivery needs its $49.99/mo Gold tier; Redditapis includes it from $19/mo.
Syften vs Redditapis
Syften caps you at 100 to 500 results a day; Redditapis allows 10,000 a day per monitor at the entry plan.
Octolens vs Redditapis
Octolens meters by mention with overage fees; Redditapis is flat-priced by subreddit slot from $19/mo.
Affiliate program
Earn 20% lifetime commissions - capped at $5,000/yr.
Reddit Vote API tutorial
Upvote and downvote a post programmatically via the REST API.
Reddit Data API: REST, no PRAW
REST endpoints for Reddit data with no PRAW and no OAuth dance.
Reddit scraping benchmarks
Real throughput, error rates, and cost benchmarks for Reddit scraping.
Reddit API answers
Direct answers on cost, access, rate limits, endpoints, and auth.
How much the Reddit API costs
Per-call pricing from $0.0015 a read, with $0.50 in free credits.
Reddit API in Python
One requests call with a bearer token, no PRAW and no OAuth flow.
Reddit shadowban checker
Check if a Reddit account is shadowbanned in seconds, free and no login.
Subreddit stats checker
See any subreddit's live subscriber count, active users, and age, free and no login.
Make your first call in five minutes.
$0.50 in free credits, no card required. Sign up, copy your bearer token, and hit any of the 74 endpoints.