Documentation Index Fetch the complete documentation index at: https://docs.scrapebadger.com/llms.txt
Use this file to discover all available pages before exploring further.
Reddit Scraper API Search posts, fetch comment trees, explore subreddits, and retrieve user profiles from Reddit. The API handles TLS fingerprinting, proxy rotation, and anti-bot bypass automatically — no Reddit API key or OAuth setup needed.
Key Features
22 Endpoints Search, posts, comments, subreddits, users, wiki, trending, and cross-post detection.
No Reddit API Key We handle all authentication and rate limiting. Just use your ScrapeBadger API key.
Comment Trees Full nested comment threads with configurable depth control (0-10 levels).
Search Syntax Full Reddit search operators: title:, author:, subreddit:, flair:, AND/OR/NOT.
Anti-Bot Bypass Automatic TLS fingerprint rotation and residential proxy routing.
SDK Support First-class support via the ScrapeBadger Node.js and Python SDKs.
Quick Start import ScrapeBadger from 'scrapebadger' ; const client = new ScrapeBadger ({ apiKey: 'YOUR_API_KEY' }); // Search posts const results = await client . reddit . search . posts ({ q: 'artificial intelligence' , sort: 'top' , t: 'week' , limit: 10 , }); console . log ( results . posts );
Endpoints Search Endpoint Credits Description GET /v1/reddit/search/posts2 Search posts globally or within a subreddit GET /v1/reddit/search/subreddits2 Search for subreddits by keyword GET /v1/reddit/search/users2 Search for Reddit users GET /v1/reddit/domains/{domain}/posts2 Get posts linking to a specific domain
Posts Endpoint Credits Description GET /v1/reddit/posts/trending1 Trending posts from Reddit’s front page GET /v1/reddit/posts/{post_id}2 Get post details by ID GET /v1/reddit/posts/{post_id}/comments3 Comment tree with depth control GET /v1/reddit/posts/{post_id}/duplicates3 Cross-posts and duplicates
Subreddits Endpoint Credits Description GET /v1/reddit/subreddits/{subreddit}2 Subreddit metadata GET /v1/reddit/subreddits/{subreddit}/posts2 Subreddit posts (hot/new/top/rising) GET /v1/reddit/subreddits/{subreddit}/rules1 Subreddit rules GET /v1/reddit/subreddits/{subreddit}/wiki1 List wiki pages GET /v1/reddit/subreddits/{subreddit}/wiki/{page}3 Wiki page content GET /v1/reddit/subreddits/popular1 Popular subreddits GET /v1/reddit/subreddits/new1 New subreddits
Users Endpoint Credits Description GET /v1/reddit/users/{username}2 User profile and karma GET /v1/reddit/users/{username}/posts2 User’s submitted posts GET /v1/reddit/users/{username}/comments2 User’s comment history GET /v1/reddit/users/{username}/moderated3 Subreddits user moderates GET /v1/reddit/users/{username}/trophies1 User’s trophy case
All listing endpoints use cursor-based pagination with after and before parameters.
{ "posts" : [ ... ], "pagination" : { "after" : "t3_abc123" , "before" : null , "count" : 25 , "limit" : 25 } }
Pass the after value as a query parameter to get the next page of results. The maximum limit per request is 100.
Search Syntax The search endpoints support Reddit’s full query syntax:
Operator Example Description title:title:pythonSearch in post titles author:author:spezFilter by author subreddit:subreddit:programmingFilter by subreddit flair:flair:DiscussionFilter by flair site:site:github.comFilter by link domain nsfw:yesnsfw:yesInclude NSFW posts self:yesself:yesOnly text posts AND / OR / NOTpython AND tutorialBoolean operators
Response Fields Post Object Field Type Description idstring Reddit post ID (e.g. 1obwkbb) fullnamestring Reddit fullname with t3_ prefix titlestring Post title selftextstring Plain-text body (empty for link posts) selftext_htmlstring | null HTML-rendered body urlstring Final URL (link target or self-post URL) permalinkstring Full Reddit permalink domainstring Link domain (e.g. github.com, self.python) authorstring Author username author_fullnamestring | null Author fullname (t2_...) author_flair_textstring | null Author’s flair on this subreddit subredditstring Subreddit name (no prefix) subreddit_name_prefixedstring Subreddit with prefix (e.g. r/python) subreddit_idstring Subreddit fullname (t5_...) subreddit_subscribersnumber Subscriber count at time of fetch scorenumber Net score (ups − downs) upsnumber Upvote count upvote_rationumber Ratio of upvotes (0.0–1.0) num_commentsnumber Total comment count num_crosspostsnumber Number of cross-posts created_utcnumber Unix timestamp created_atstring ISO 8601 UTC timestamp (e.g. 2025-10-20T22:56:45Z) editednumber | boolean False or edit Unix timestamp edited_atstring | null ISO 8601 UTC if edited is_selfboolean True for text posts is_videoboolean True for native Reddit video is_galleryboolean True for image galleries is_nsfwboolean NSFW flag is_spoilerboolean Spoiler flag is_lockedboolean Locked from new comments is_stickiedboolean Pinned to top of subreddit is_archivedboolean Older than 6 months (no new comments) is_original_contentboolean OC tag is_robot_indexableboolean Whether search engines can index is_crosspostableboolean Allowed to be cross-posted send_repliesboolean Author receives inbox replies link_flair_textstring | null Post flair text link_flair_background_colorstring | null Flair background hex link_flair_text_colorstring | null light or darklink_flair_template_idstring | null Reddit’s flair template UUID distinguishedstring | null moderator, admin, or nullthumbnailstring | null Thumbnail URL preview_imagesarray Preview images with url, width, height mediaobject | null Embedded media (video, oEmbed) gallery_dataarray | null Gallery item metadata total_awardsnumber Total awards received awardsarray Award objects (id, name, count, icon_url) gildednumber Number of times gilded removed_by_categorystring | null Removal reason category
Field Type Description id, fullnamestring Comment ID and t1_* fullname body, body_htmlstring Comment text (plain & rendered) author, author_fullnamestring Author info subreddit, subreddit_name_prefixedstring Subreddit context post_id, post_titlestring Parent post parent_idstring Parent thing fullname score, ups, controversialitynumber Engagement depthnumber Nesting level (0 = top-level) created_utc, created_atnumber, string Unix + ISO 8601 edited, edited_atnumber/bool, string Edit timestamps is_submitterboolean True if author is post author (OP) is_stickied, is_lockedboolean Moderation state distinguishedstring | null Mod/admin badge repliesarray Nested comments (recursive)
Subreddit Object Field Type Description id, fullname, namestring Identifiers display_name_prefixedstring E.g. r/python title, header_titlestring Display names description, description_htmlstring Long description (sidebar) public_description, public_description_htmlstring Short description subscribers, active_usersnumber Member counts created_utc, created_atnumber, string When created typestring public, private, restrictedsubmission_typestring any, link, selfadvertiser_categorystring | null Ad category is_nsfw, is_quarantinedboolean Content flags icon_url, banner_url, header_urlstring Images primary_color, key_color, banner_background_colorstring Theme wiki_enabled, allow_images, allow_videos, allow_galleries, allow_pollsboolean Content permissions spoilers_enabled, emojis_enabled, free_form_reportsboolean Features comment_score_hide_minsnumber Minutes before scores show should_archive_postsboolean Auto-archive after 6mo allowed_media_in_commentsarray E.g. ["video"]
User Object Field Type Description id, fullname, namestring Identifiers display_name_prefixedstring E.g. u/spez description, profile_titlestring Bio icon_url, snoovatar_url, banner_urlstring Images profile_urlstring Profile page URL link_karma, comment_karma, awardee_karma, awarder_karma, total_karmanumber Karma breakdown created_utc, created_atnumber, string Account age verified, has_verified_email, is_employee, is_mod, is_gold, is_suspendedboolean Account flags accepts_followers, has_subscribedboolean Settings is_nsfwboolean NSFW profile
Rate Limits Reddit Scraper API requests are subject to the same rate limits as all ScrapeBadger endpoints. See Rate Limits for details. 
