+Reddit API
Search Reddit and read posts, full comment trees, communities and user histories as JSON, without a Reddit app.
The API.SH Reddit API reads public Reddit the way a logged-out visitor sees it and returns JSON. Search posts, comments, users and communities with Reddit's sort and time filters; page through a subreddit's feed filtered by flair or linked domain; open a post with its score, upvote ratio and full comment tree, folded replies included; and pull a user's profile, karma split, posts and comments. Community endpoints return details, rules, sidebar widgets, wiki pages with edit history and similar subreddits. There are also r/popular by country, posts linking to any website, combined multi-subreddit feeds and video transcripts.
- 30 endpoints
- from $1 / 1,000 calls
- 1,000 free credits / month
- failed calls free
GET https://api.api.sh/reddit/v1/ search
{"query": "SpaceX Starship","sort": "relevance","time": "all","subreddit": null,"engine": "feed","count": 22,"next_cursor": "t3_1i32831","feed": {"title": "reddit.com: search results - SpaceX Starship","subtitle": null,"updated": "2026-11-04T06:08:23+00:00","icon": null,"logo": null,"category": " reddit.com","category_label": "r/ reddit.com","url": "https://www.reddit.com/search?q=SpaceX+Starship&sort=relevance&t=all&limit=25"},"posts": [{"id": "t3_1wsg3qu","title": "SpaceX's Starship reaches orbit for the first time","author": "TeaReim","subreddit": "worldnews","published": "2026-09-28T14:27:17+00:00","updated": "2026-09-28T14:27:17+00:00","text": null,"url": "https://www.reddit.com/r/worldnews/comments/1wsg3qu/spacexs_starship_reaches_orbit_for_the_first_time/","link": "https://www.reuters.com/business/media-telecom/spacexs-starship-launches-14th-flight-first-headed-orbit-2026-09-28/","thumbnail": null,"author_url": "https://www.reddit.com/user/TeaReim","category_label": "r/worldnews","external_url": "https://www.reuters.com/business/media-telecom/spacexs-starship-launches-14th-flight-first-headed-orbit-2026-09-28/","images": [],"videos": [],"links": [],"permalink": "/r/worldnews/comments/1wsg3qu/spacexs_starship_reaches_orbit_for_the_first_time/","content_html": " submitted by <a href=\"https://www.reddit.com/user/TeaReim\"> /u/TeaReim </a> to <a href=\"https://www.reddit.com/r/worldnews/\"> r/worl…","media_thumbnail": null},{"id": "t3_1v4lj7n","title": "How impressive is SpaceX's starship actually?","author": "Connect_Cat_2045","subreddit": "NoStupidQuestions","published": "2026-07-23T18:01:49+00:00","updated": "2026-07-23T18:01:49+00:00","text": "I've seen some people call it a scam and I've seen other people call it the greatest rocket ever made.\n So how good is it actually","url": "https://www.reddit.com/r/NoStupidQuestions/comments/1v4lj7n/how_impressive_is_spacexs_starship_actually/","link": null,"thumbnail": null,"author_url": "https://www.reddit.com/user/Connect_Cat_2045","category_label": "r/NoStupidQuestions","external_url": null,"images": [],"videos": [],"links": [],"permalink": "/r/NoStupidQuestions/comments/1v4lj7n/how_impressive_is_spacexs_starship_actually/","content_html": "<!-- SC_OFF --><div class=\"md\"><p>I've seen some people call it a scam and I've seen other people call it the greatest rocket ever made.</p>…","media_thumbnail": null},"… 20 more"],"cached": false,"credits_used": 1} What you can build with the Reddit API
Brand and competitor monitoring
Run /reddit/v1/search and /reddit/v1/search/comments for your brand with sort=new and time=day, and use /reddit/v1/domain to catch every post that links to your site or a competitor's.
Customer research from real threads
Pull the whole comment tree of a high-signal post with /reddit/v1/comments, following next_cursor and each folded thread in more_replies, then group the pain points and feature requests people actually write.
Finding the right communities
Start from Reddit's autocomplete or subreddit search, expand with /reddit/v1/subreddit/similar, and read weekly visitors, rules and sidebar flairs before you post or advertise in a community.
Datasets and RAG for AI
Collect a niche from several subreddits at once with /reddit/v1/subreddits/feed, plus the latest comments across a community, and index posts, comments and wiki pages for retrieval or evaluation sets.
Vetting users and tracking post rank
Check an account's age, karma split and post and comment counts before a partnership, read its history with /reddit/v1/user/overview, and see where its posts rank in a subreddit's hot or top feed.
Trend spotting
Read r/popular for a country, the most popular and newest communities, and crossposts of a link across subreddits with /reddit/v1/post/duplicates to see what is spreading and where.
Reddit data you get
Field names from real responses. Numbers come parsed, URLs absolute, dates in ISO 8601.
Reddit API endpoints and prices
Every Reddit endpoint costs 1 credit per call: credits are $1 per 1,000 on a monthly plan, $2 pay-as-you-go. Pricing
| Reddit search suggestions /reddit/ | $1 · $2 PAYG 1 credit |
| Reddit popular posts /reddit/ | $1 · $2 PAYG 1 credit |
| One Reddit post with top comments /reddit/ | $1 · $2 PAYG 1 credit |
| Search Reddit posts /reddit/ | $1 · $2 PAYG 1 credit |
| Reddit comment search /reddit/ | $1 · $2 PAYG 1 credit |
| Reddit user search /reddit/ | $1 · $2 PAYG 1 credit |
| Search subreddits /reddit/ | $1 · $2 PAYG 1 credit |
| Popular subreddits /reddit/ | $1 · $2 PAYG 1 credit |
| Subreddit wiki page /reddit/ | $1 · $2 PAYG 1 credit |
| Subreddit wiki page history /reddit/ | $1 · $2 PAYG 1 credit |
| Reddit user profile /reddit/ | $1 · $2 PAYG 1 credit |
| A Reddit user's comments /reddit/ | $1 · $2 PAYG 1 credit |
| A Reddit user's posts and comments /reddit/ | $1 · $2 PAYG 1 credit |
| A Reddit user's posts /reddit/ | $1 · $2 PAYG 1 credit |
| Where a user's posts rank in a subreddit /reddit/ | $1 · $2 PAYG 1 credit |
| Reddit user stats /reddit/ | $1 · $2 PAYG 1 credit |
| Comments of a Reddit post /reddit/ | $1 · $2 PAYG 1 credit |
| Reddit custom feed posts /reddit/ | $1 · $2 PAYG 1 credit |
| Reddit posts linking to a domain /reddit/ | $1 · $2 PAYG 1 credit |
| Other discussions of a Reddit post /reddit/ | $1 · $2 PAYG 1 credit |
| Reddit video transcript /reddit/ | $1 · $2 PAYG 1 credit |
| Subreddit posts /reddit/ | $1 · $2 PAYG 1 credit |
| Reddit comment with context /reddit/ | $1 · $2 PAYG 1 credit |
| Latest comments in a subreddit /reddit/ | $1 · $2 PAYG 1 credit |
| Subreddit details and rules /reddit/ | $1 · $2 PAYG 1 credit |
| Subreddit rules /reddit/ | $1 · $2 PAYG 1 credit |
| Similar subreddits /reddit/ | $1 · $2 PAYG 1 credit |
| Subreddit sidebar widgets /reddit/ | $1 · $2 PAYG 1 credit |
| Combined feed of several subreddits /reddit/ | $1 · $2 PAYG 1 credit |
| Newest subreddits /reddit/ | $1 · $2 PAYG 1 credit |
Call the Reddit API
Search Reddit posts: GET https://api.api.sh/reddit/
curl "https://api.api.sh/reddit/v1/search?q=rust+programming" \
-H "x-api-key: $APISH_KEY" import os, requests
res = requests.get(
"https://api.api.sh/reddit/v1/search",
params={"q": "rust programming"},
headers={"x-api-key": os.environ["APISH_KEY"]},
timeout=120,
)
res.raise_for_status()
data = res.json() const url = new URL("https://api.api.sh/reddit/v1/search");
url.searchParams.set("q", "rust programming");
const res = await fetch(url, { headers: { "x-api-key": process.env.APISH_KEY } });
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
const data = await res.json(); # Google Sheets (API.SH add-on)
=APISH("/reddit/v1/search", "q", "rust programming")
# Zapier, Make, n8n (verified node): pick the API.SH app,
# choose "Reddit" and "Search Reddit posts".
# AI agents (Claude, ChatGPT, Cursor): add the
# API.SH MCP server https://api.sh/mcp - Create a free accountConfirm your email and get 1,000 free credits every month. No card needed.
- Create an API keyOne key works for all 918 platforms.
- Send the requestJSON back in one call. Add
output=csvoroutput=ndjsonfor files.
Why API.SH for Reddit data
- Public data only: no Reddit login, cookies or account needed
- One key and one response shape for Reddit and 917 other platforms
- Built and maintained by API.SH, not third-party publishers
- Pay per call; errors on our side cost nothing
- No rate limits: run as many calls in parallel as you need
- Live status for every endpoint
API.SH vs the official Reddit API
Reddit's Data API needs a registered app, OAuth and Reddit's approval, and commercial use needs a paid agreement. API.SH needs no Reddit app, approval or login and returns public Reddit pages as JSON.
Open-source Reddit scrapers and PRAW scripts break when Reddit changes its pages or closes API access, and Apify actors are priced per actor. API.SH keeps the Reddit endpoints working and bills every call from one balance.
Reddit API questions
What Reddit data can I get?+
Search: posts (/reddit/v1/search), comments, users, subreddits and Reddit's own autocomplete. Posts: one post with top comments, the full comment tree (/reddit/v1/comments), one comment with its parents, crossposts and video transcripts. Communities: subreddit feeds, latest comments, details, rules, sidebar widgets, wiki pages and their history, similar, popular and new subreddits, multi-subreddit feeds, custom feeds and posts linking to a domain. Users: profile, stats, posts, comments, overview and post rank in a subreddit.
How much does the Reddit API cost?+
Every Reddit endpoint costs 1 credit per call. On a monthly plan 1,000 credits cost $1 (Starter is $50/month for 50,000 credits). Pay-as-you-go is $2 per 1,000 credits, with top-ups from $15 that never expire.
Is there a free Reddit API?+
Yes. Every account gets 1,000 free credits every month, no card needed. That is 1,000 calls to /reddit/v1/autocomplete at 1 credit each.
Is Reddit shutting down its API?+
Reddit has announced that it will end public API access in 2027 and stopped taking new public API applications, steering developers to its Developer Platform and licensing deals. API.SH does not use a Reddit API key: it reads the public pages any logged-out visitor sees, so you do not need Reddit's approval to start.
How do I get a Reddit API key?+
With API.SH you do not need one from Reddit. Sign up at api.sh and copy your API.SH key; it works for every Reddit endpoint and every other platform in the catalog, with no OAuth flow and no app review.
How do I get all comments on a Reddit post?+
Call /reddit/v1/comments with the post url. Each page has top-level threads; pass next_cursor back as cursor for more, and call the same route with the cursor of each item in more_replies to open the reply threads Reddit folded. depth limits how far down the replies go, and sort accepts best, top, new, controversial, old and qa.
Is scraping Reddit allowed?+
API.SH returns only public posts, comments and profiles that anyone can read without an account. How you store and use that data is up to you: follow Reddit's user agreement and the privacy law where you operate, especially for usernames and personal content.
Do I need a Reddit account?+
No. Nothing is posted, voted or read through an account. Private and quarantined content that needs a login is not returned; a custom feed that is private answers 404.
Can I use the Reddit API from Python?+
Yes. Use the Python SDK or any HTTP client: send GET https://api.api.sh/reddit/v1/subreddit?subreddit=python&sort=top&time=week with your key in the x-api-key header and read the posts array from the JSON.
How do I get started?+
Sign up at api.sh, copy your key and try /reddit/v1/search?q=standing+desk&sort=new. Every parameter is in the docs at https://api.sh/docs, and the same routes work from the JS and Python SDKs, Google Sheets, Zapier, Make, n8n and the MCP server at https://api.sh/mcp.
Does the Reddit API have a rate limit?+
No. API.SH puts no rate limit on your key: send as many Reddit calls in parallel as you need and pay only for the calls that run. If Reddit itself slows down, the call returns 503 with a retry-after header and is not charged.