Reddit+API.SH

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
Search Reddit posts
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}
1 credit · $1 per 1,000 calls

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 search suggestions/reddit/v1/autocomplete
querypythcount10
queries[]query · url
communities[]name · id · nsfw · quarantined · weekly_visitors · caption · icon · url
Reddit comment with context/reddit/v1/comment
subredditPythonpost_idt3_1qpq3cccomment_idt1_o2ay8sucontext3urlhttps://www.reddit.com/r/Python/…parents_count0replies_count46notereplies are in thread order (eac…
post[]id · author · subreddit · title · text · created_at · updated_at · url · author_url · category_label · thumbnail · external_url
comment[]id · author · subreddit · title · text · created_at · updated_at · url · author_url · category_label · thumbnail · external_url
replies[]id · author · subreddit · title · text · created_at · updated_at · url · author_url · category_label · thumbnail · external_url
Comments of a Reddit post/reddit/v1/comments
subredditPythonpost_id1x89bnqsorttoptotal_comments16count14post_permalinkhttps://www.reddit.com/r/Python/…
comments[]author · score · permalink · body · id · url · score_value · created_at · depth · parent_id · post_id · parent_permalink

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

Search and discovery8
Reddit search suggestions
/reddit/v1/autocomplete
params q +1 optionaldocstry
$1 · $2 PAYG
1 credit
Reddit popular posts
/reddit/v1/popular
params none required +4 optionaldocstry
$1 · $2 PAYG
1 credit
One Reddit post with top comments
/reddit/v1/post
params none required +3 optionaldocstry
$1 · $2 PAYG
1 credit
Search Reddit posts
/reddit/v1/search
params q +5 optionaldocstry
$1 · $2 PAYG
1 credit
Reddit comment search
/reddit/v1/search/comments
params q +4 optionaldocstry
$1 · $2 PAYG
1 credit
Reddit user search
/reddit/v1/search/users
params q +1 optionaldocstry
$1 · $2 PAYG
1 credit
Search subreddits
/reddit/v1/subreddit/search
params q +1 optionaldocstry
$1 · $2 PAYG
1 credit
Popular subreddits
/reddit/v1/subreddits/popular
params none required +2 optionaldocstry
$1 · $2 PAYG
1 credit
Profiles and accounts8
Subreddit wiki page
/reddit/v1/subreddit/wiki
params subreddit +2 optionaldocstry
$1 · $2 PAYG
1 credit
Subreddit wiki page history
/reddit/v1/subreddit/wiki/revisions
params subreddit +4 optionaldocstry
$1 · $2 PAYG
1 credit
Reddit user profile
/reddit/v1/user/about
params usernamedocstry
$1 · $2 PAYG
1 credit
A Reddit user's comments
/reddit/v1/user/comments
params username +3 optionaldocstry
$1 · $2 PAYG
1 credit
A Reddit user's posts and comments
/reddit/v1/user/overview
params username +3 optionaldocstry
$1 · $2 PAYG
1 credit
A Reddit user's posts
/reddit/v1/user/posts
params username +3 optionaldocstry
$1 · $2 PAYG
1 credit
Where a user's posts rank in a subreddit
/reddit/v1/user/rank
params username, subreddit +3 optionaldocstry
$1 · $2 PAYG
1 credit
Reddit user stats
/reddit/v1/user/stats
params usernamedocstry
$1 · $2 PAYG
1 credit
Posts and media6
Comments of a Reddit post
/reddit/v1/comments
params none required +8 optionaldocstry
$1 · $2 PAYG
1 credit
Reddit custom feed posts
/reddit/v1/custom-feed
params none required +7 optionaldocstry
$1 · $2 PAYG
1 credit
Reddit posts linking to a domain
/reddit/v1/domain
params domain +4 optionaldocstry
$1 · $2 PAYG
1 credit
Other discussions of a Reddit post
/reddit/v1/post/duplicates
params none required +3 optionaldocstry
$1 · $2 PAYG
1 credit
Reddit video transcript
/reddit/v1/post/transcript
params urldocstry
$1 · $2 PAYG
1 credit
Subreddit posts
/reddit/v1/subreddit
params subreddit +6 optionaldocstry
$1 · $2 PAYG
1 credit
Comments and reviews2
Reddit comment with context
/reddit/v1/comment
params none required +5 optionaldocstry
$1 · $2 PAYG
1 credit
Latest comments in a subreddit
/reddit/v1/subreddit/comments
params subreddit +1 optionaldocstry
$1 · $2 PAYG
1 credit
More data6
Subreddit details and rules
/reddit/v1/subreddit/details
params subredditdocstry
$1 · $2 PAYG
1 credit
Subreddit rules
/reddit/v1/subreddit/rules
params subredditdocstry
$1 · $2 PAYG
1 credit
Similar subreddits
/reddit/v1/subreddit/similar
params subreddit +1 optionaldocstry
$1 · $2 PAYG
1 credit
Subreddit sidebar widgets
/reddit/v1/subreddit/widgets
params subredditdocstry
$1 · $2 PAYG
1 credit
Combined feed of several subreddits
/reddit/v1/subreddits/feed
params subreddits +4 optionaldocstry
$1 · $2 PAYG
1 credit
Newest subreddits
/reddit/v1/subreddits/new
params none required +2 optionaldocstry
$1 · $2 PAYG
1 credit

Call the Reddit API

Search Reddit posts: GET https://api.api.sh/reddit/v1/search

curl "https://api.api.sh/reddit/v1/search?q=rust+programming" \
  -H "x-api-key: $APISH_KEY"
  1. Create a free accountConfirm your email and get 1,000 free credits every month. No card needed.
  2. Create an API keyOne key works for all 918 platforms.
  3. Send the requestJSON back in one call. Add output=csv or output=ndjson for 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.

More social APIs all social media APIs →

Start with 1,000 free credits
Every month, on every account. One key works for all 918 platforms.
Get a free API key