__  __  _ __   ____
/\ \/\ \/\`'__\/',__\
\ \ \_\ \ \ \//\__, `\
 \ \____/\ \_\\/\____/
  \/___/  \/_/ \/___/

Universal Reddit Scraper - A comprehensive Reddit scraping command-line tool written in Python.

Sponsors

If this project has saved you time, consider sponsoring its development.

	MangoProxy provides residential, ISP, datacenter, and mobile proxies in 200+ countries. Trusted by businesses worldwide for stable connections, fast response times, and scalable proxy infrastructure. Use my affiliate link to sign up for an account, and use promo code JOSEPH to save 8% on Static ISP Proxies.
	RapidProxy is a global residential proxy platform built for scraping developers and data collection teams, offering 90M+ real residential IPs across 200+ countries and regions. It supports dynamic rotation, precise geo-targeting, and high-concurrency data collection, helping improve success rates and reduce ban risks. Start your free trial today! Sign up with my affiliate link and use discount code RAPID10 to get 10% off.
	Swiftproxy — Premium residential proxies for web scraping, browser automation, AI workflows, and large-scale data collection. Access 80M+ real residential IPs across 190+ countries with rotating and sticky sessions, non-expiring traffic, and support for HTTP, HTTPS, and SOCKS5. 🎁 Free Trial Available 🏷️ 10% OFF with code: PROXY90 Sign up today with my affiliate link!

Table of Contents

• Contact
• Introduction
• Usage Overview
• "Where’s the Manual?"
  • URS Manual
• Demo GIFs
  • Subreddit Scraping
  • Redditor Scraping
  • Submission Comments Scraping
  • Livestreaming Reddit
  • Generating Word Frequencies
  • Generating Wordclouds
  • Checking PRAW Rate Limits
  • Displaying Directory Tree

Contact

Whether you are using URS for enterprise or personal use, I am very interested in hearing about your use case and how it has helped you achieve a goal. Additionally, please send me an email if you would like to contribute, have questions, or want to share something you have built on top of it.

You can send me an email by clicking on the badge. I look forward to hearing from you!

Introduction

This is a comprehensive Reddit scraping tool that integrates multiple features:

• Scrape Reddit via PRAW (the official Python Reddit API Wrapper)
  • Scrape Subreddits
  • Scrape Redditors
  • Scrape submission comments
• Livestream Reddit via PRAW
  • Livestream comments submitted within Subreddits or by Redditors
  • Livestream submissions submitted within Subreddits or by Redditors
• Analytical tools for scraped data
  • Generate frequencies for words that are found in submission titles, bodies, and/or comments
  • Generate a wordcloud from scrape results

Usage Overview

[-h]
[-e]
[-v]

[-t [<optional_date>]]
[--check]

[-r <subreddit> <(h|n|c|t|r|s)> <n_results_or_keywords> [<optional_time_filter>]]
    [-y]
    [--csv]
    [--rules]
[-u <redditor> <n_results>]
[-c <submission_url> <n_results>]
    [--raw]
[-b]
    [--csv]

[-lr <subreddit>]
[-lu <redditor>]

    [--nosave]
    [--stream-submissions]

[-f <file_path>]
    [--csv]
[-wc <file_path> [<optional_export_format>]]
    [--nosave]

"Where’s the Manual?"

URS Manual

This README has become too long to comfortably contain all usage information for this tool. Consequently, the information that used to be in this file has been moved to a separate manual created with mdBook, a Rust command-line tool for creating books from Markdown files.

Note: You can also find the link in the About sidebar in this repository.

Demo GIFs

Here are all the demo GIFs recorded for URS.

Note: The nd command is nomad, a modern tree alternative I wrote in Rust.

Subreddit Scraping

Redditor Scraping

Submission Comments Scraping

Livestreaming Reddit

Generating Word Frequencies

Generating Wordclouds

Checking PRAW Rate Limits

Displaying Directory Tree