Reddrix — An open-source, blazing-fast Reddit Scraper for Python (No Login or API Key)

If this repo is useful to you or saved you time, consider starring ⭐ it to support me and help others find it and have an easier time scraping Reddit ❤️.

Installation • Quickstart • Features • Output Dataset • Reddrix Arguments

pip install -U reddrix
reddrix install # Mandatory for installing the Camoufox browser.

Using Async Context Manager:

from reddrix import Reddrix
import asyncio

async def main():
    async with Reddrix(
        mode="standard",
        subreddit_urls=[
            "https://www.reddit.com/r/webscraping",
            # URLs of specific subreddits to include when scraping posts and comments
            # Add as many as you want
        ],
        profile_urls=[], # URLs of specific profiles to include when scraping posts and comments; add as many as you want. Only public data is scraped
        post_urls=[], # URLs of specific posts to include in the scraping; add as many as you like
        sort="new",
        include_comments=True,
        max_results=500,
        max_posts_per_collection=500,
        verbose=True
    ) as reddrix:
        scrape_count = 0
        async for item in reddrix.get_items():
            # item is a Python dictionary with 24 keys.
            scrape_count += 1
            print(scrape_count, item["submissionType"], item["submissionUrl"])

if __name__ == "__main__":
    asyncio.run(main())

Without the context manager:

from reddrix import Reddrix
import asyncio

async def main():
    reddrix = Reddrix(
        mode="standard",
        subreddit_urls=["https://www.reddit.com/r/webscraping"],
        sort="new",
        include_comments=True,
        max_results=500,
        max_posts_per_collection=500,
        verbose=True
    )
    await reddrix.start()
    
    scrape_count = 0
    async for item in reddrix.get_items():
        # item is a Python dictionary with 24 keys.
        scrape_count += 1
        print(scrape_count, item["submissionType"], item["submissionUrl"])
    
    await reddrix.stop()


if __name__ == "__main__":
    asyncio.run(main())

Scraping Posts and Comments Based on Keywords (uses Reddit's current shreddit search engine):

from reddrix import Reddrix
import asyncio

async def main():
    async with Reddrix(
        mode="keyword_search",
        sort="new", # The sort option is ignored for this mode
        query="how to scrape reddit",
        include_comments=True,
        max_results=500,
        max_posts_per_collection=500,
        verbose=True
    ) as reddrix:
        scrape_count = 0
        async for item in reddrix.get_items():
            # item is a Python dictionary with 24 keys.
            scrape_count += 1
            print(scrape_count, item["submissionType"], item["submissionUrl"])

if __name__ == "__main__":
    asyncio.run(main())

Using Reddrix as a standalone Reddit http client for your custom scraping setup (has both GET and POST methods):

from reddrix import Reddrix
import asyncio

async def main():
    async with Reddrix() as reddrix:
        html_content = await reddrix.get(url="https://www.reddit.com/search?q=how+to+scrape+reddit") # Only HTML/XML is supported
        print(html_content)

if __name__ == "__main__":
    asyncio.run(main())

Using Reddrix with Proxies:

from reddrix import Reddrix
import asyncio

async def main():
    async with Reddrix(
        # Your normal arguments above ...,
        proxies=[
            "scheme://user:pass@hostname:port",
            "scheme://user2:pass2@hostname2:port2",
            # Add as many as you want, and Reddrix automatically rotates between them...
        ]
    ) as reddrix:
        scrape_count = 0
        async for item in reddrix.get_items():
            # item is a Python dictionary with 24 keys.
            scrape_count += 1
            print(scrape_count, item["submissionType"], item["submissionUrl"])

if __name__ == "__main__":
    asyncio.run(main())

Stealth Mode:

By default, stealth is set to adaptive, which means Reddrix will auto-activate it only when scraping comments. To explicitly make it active all times, set it to True. When this mode is active, Reddrix will send the same internal API requests it sends with the wreq client but directly from within the Camoufox browser context using JavaScript fetch. While these requests are being fired in the background, Reddrix will make human-like, random mouse hovering in the page. The key advantage of this strategy is that it is much more undetectable because it avoids the fingerprint drift that occurs when harvesting cookies from a browser and using them in another HTTP client. Also, the majority of the scraping speed is preserved because the browser isn't really waiting for navigation or clicking elements aside from the random mouse movements it is doing in the home page. The disadvantage is that the stealth mode is resource-heavy.

To explicitly disable this mode, set stealth to False. This way, Camoufox will only be used as a cookie harvester, while wreq will use these cookies to make all the HTTP requests. The advantage is that this setup is much less resource-intensive, while the disadvantage is that it gets detected quickly when scraping lots of comments.

Example Code:

from reddrix import Reddrix
import asyncio

async def main():
    async with Reddrix(
        mode="standard",
        stealth=True, # Can also be set to False or "adaptive"
        subreddit_urls=["https://www.reddit.com/r/webscraping"],
        sort="new",
        include_comments=True,
        max_results=500,
        max_posts_per_collection=500,
        verbose=True
    ) as reddrix:
        scrape_count = 0
        async for item in reddrix.get_items():
            # item is a Python dictionary with 24 keys.
            scrape_count += 1
            print(scrape_count, item["submissionType"], item["submissionUrl"])

if __name__ == "__main__":
    asyncio.run(main())

• 🚀 Async-First: High-performance asynchronous scraping with asyncio and an async iterator for streaming results.
• 🥷 Adaptive Stealth: Optionally enable the stealth mode for intelligent, highly undetectable scraping.
• 🔑 No Login or API Key: Scrape Reddit seamlessly without logging in or providing an API key.
• 🔍 Multiple Search Modes: Scrape subreddits, user profiles, and specific posts, or search Reddit by keywords.
• 💬 Comprehensive Data Extraction: Collect posts and comments with 24+ structured fields, including authors, scores, timestamps, flairs, media URLs, and FULL comment threads (no depth limit).
• 🛡️ Resilient Scraping: Built-in retries, cookie renewal, request jittering, and configurable proxies.
• ⚙️ Fine-Grained Control: Configure sorting, time frames, result limits, comment depth, and comment counts.
• 🧩 Standalone HTTP Client: Use Reddrix's asynchronous get() or post() method in your own custom scraping workflows.
• 🐍 Pythonic API: Manage scraper resources with an async context manager or explicit start() and stop() methods.

If you use the preset scraping setup from async for item reddrix.get_items(), each item is a Python dictionary with 24 keys.

Example Reddit Post Output:

{
  "submissionId": "1w1gc8p",
  "submissionIdPrefixed": "t3_1w1gc8p",
  "submissionType": "post",
  "submissionUrl": "https://www.reddit.com/r/Sat/comments/1w1gc8p/is_this_good_improvement_for_10_hours_of/",
  "submittedAt": "2026-08-29T07:53:42+00:00",
  "parentId": None,
  "parentPostId": None,
  "parentPostUrl": None,
  "postType": "image",
  "crosspostParentId": None,
  "crosspostParentUrl": None,
  "title": "Is this good improvement for 10 hours of dedicated study + need help for rw section",
  "bodyText": "math significantly improved but reading writing is too tough for me (international student)\n\nplease help, i have to give the sat in two months, will reading novels improve my rw score?",
  "author": "stcer",
  "depth": None,
  "postFlair": None,
  "tags": [],
  "subreddit": "r/Sat",
  "score": 32,
  "upvoteRatio": 0.98,
  "numComments": 29,
  "numCrossposts": 0,
  "externalUrl": "https://i.redd.it/cjhezz5bs9mh1.jpeg",
  "galleryImagesUrls": []
}

Example Comment Output:

{
  "submissionId": "p6lwobb",
  "submissionIdPrefixed": "t1_p6lwobb",
  "submissionType": "comment",
  "submissionUrl": "https://www.reddit.com/r/Sat/comments/1w1gc8p/is_this_good_improvement_for_10_hours_of/p6lwobb/",
  "submittedAt": "2026-08-29T13:41:52+00:00",
  "parentId": "t3_1w1gc8p",
  "parentPostId": "t3_1w1gc8p",
  "parentPostUrl": "https://www.reddit.com/r/Sat/comments/1w1gc8p",
  "postType": None,
  "crosspostParentId": None,
  "crosspostParentUrl": None,
  "title": None,
  "bodyText": "How did you do that in 10 hours? Can you please give me the sources that you used? I also need help in rw section and I’ll take the sat in 2 weeks",
  "author": "AnalysisStill4932",
  "depth": 0,
  "postFlair": None,
  "tags": [],
  "subreddit": "r/Sat",
  "score": 9,
  "upvoteRatio": None,
  "numComments": None,
  "externalUrl": None,
  "thumbnailUrl": None,
  "galleryImagesUrls": []
}

Output Fields Explanation:

1. submissionId — [string] The ID of the post or comment.
2. submissionIdPrefixed — [string] The prefixed ID of the post or comment.
3. submissionType — [string] Whether the submission is a post or comment.
4. submissionUrl — [string] The URL for the submission.
5. submittedAt — [string] The date and time the post or comment was submitted in UTC timezone and ISO format.
6. parentId — [string, None] The ID of the direct parent post or comment.
7. parentPostId — [string, None] The ID of the parent post. For posts, this field will always be None since posts have no parent.
8. parentPostUrl — [string, None] The URL of the parent post. For posts, this field will always be None since posts have no parent.
9. postType — [string, None] The post type. Can be any of text, poll, link, crosspost, image, gallery, or video. For comments, this field will always be None.
10. crosspostParentId — [string, None] The ID of the parent of the crosspost (for posts that are not crossposts, will be None).
11. crosspostParentUrl — [string, None] The URL of the parent of the crosspost (for posts that are not crossposts, will be None).
12. title — [string, None] The post title (will always be None for comments).
13. bodyText — [string, None] The main text content of a post or comment.
14. author — [string] The author of the post or comment.
15. depth — [integer, None] The comment depth (top-level comments have a depth of 0 and posts have a depth of None).
16. postFlair — [string, None] The post flair (will be None for comments).
17. tags — [list] A list of the tags for the post (always empty for comments).
18. subreddit — [string, None] The subreddit in which the post or comment was submitted.
19. score — [integer, None] The vote score of the post or comment.
20. upvoteRatio — [float, None] The ratio of upvotes to total number of votes of a post (always None for comments).
21. numComments — [integer, None] The number of comments in a post (always None for comments).
22. externalUrl — [string, None] The external URL in a post. For comments, this field will be None because external URLs will be included in the bodyText anyway.
23. thumbnailUrl — [string, None] The thumbnail image URL for video, image, and gallery post types (always None for any other submission).
24. galleryImagesUrls — [list] A list of URLs for all images in a gallery (always empty for any submission other than gallery posts).

1. mode (string) — Either standard or keyword_search. Default is standard.
2. max_results (integer) — The maximum total number of items (posts and comments combined) to return across all sources. Default is 999999.
3. max_posts_per_collection (integer) — The maximum number of posts to scrape from each collection. A collection is a single subreddit, profile, keyword search, or domain. Default is 999999.
4. sort (string) — One of default, new, hot, top_all_time, top_past_hour, top_today, top_past_week, top_past_month, and top_past_year. Applies to subreddits and profiles. This option is ignored in keyword_search mode, which always uses Reddit's relevance sorting. Default is default.
5. subreddit_urls (list of strings) — Subreddit URLs to scrape, e.g. ["https://www.reddit.com/r/webscraping"]. Used in standard mode only. URLs that are not valid subreddit URLs are skipped. Default is [].
6. post_urls (list of strings) — Specific post URLs to scrape, e.g. ["https://www.reddit.com/r/webscraping/comments/abc123/post_title/"]. Used in standard mode only. URLs that are not valid post URLs are skipped. Default is [].
7. profile_urls (list of strings) — User profile URLs to scrape the submitted posts of, e.g. ["https://www.reddit.com/user/username"]. Both /user/ and /u/ URLs are supported. Used in standard mode only. URLs that are not valid profile URLs, or those of profiles that are deleted, banned, or hiding their content, are skipped. Default is [].
8. query (string) — The search keywords to look up site-wide on Reddit. Used in keyword_search mode only. Default is None.
9. include_comments (boolean) — Whether to scrape the comments of each post in addition to the post itself. Comments are returned as separate items with submissionType set to comment. Default is False.
10. max_comments_depth (integer) — The maximum comment depth to scrape. Top-level comments have a depth of 0, their replies have a depth of 1, and so on. Only applies if include_comments is True. Default is 999999.
11. max_comments_per_post (integer) — The maximum total number of comments (top-level comments and replies) to scrape per post. Only applies if include_comments is True. Default is 999999.
12. max_top_comments_per_post (integer) — The maximum number of top-level comments (depth 0) to scrape per post. Only applies if include_comments is True. Default is 999999.
13. proxies (list of strings) — A list of proxy URLs in the format scheme://user:pass@hostname:port. Reddrix rotates through them automatically, picking an unused proxy first and reusing proxies only after the whole list has been used. Default is [] (no proxy).
14. verbose (boolean) — Whether to print timestamped log messages (initialization, retries, etc.) to the console. Default is False.