ReddGrow DocsSubreddits
Query community data, post feeds, comments, rules, wiki, and more from any subreddit
The subreddits command group (alias: r) covers all community-level data endpoints. Use reddgrow r as a shorthand anywhere you would type reddgrow subreddits.
# These are equivalent
reddgrow subreddits about MachineLearning
reddgrow r about MachineLearningCommands
search
Find subreddits matching a query string.
reddgrow subreddits search <query>Credit cost: 3 credits
reddgrow subreddits search "machine learning"
reddgrow r search "indie hackers"about
Get detailed metadata for a subreddit — subscriber count, description, creation date, and community settings.
reddgrow subreddits about <name>Credit cost: 1 credit
reddgrow subreddits about rust
reddgrow r about programmingrules
Get the posting rules for a subreddit. Check these before submitting content to avoid violations.
reddgrow subreddits rules <name>Credit cost: 1 credit
reddgrow subreddits rules startups
reddgrow r rules MachineLearningposts
Fetch the post feed for a subreddit with configurable sort, time range, and limit.
reddgrow subreddits posts <name> [--sort <method>] [--time <range>] [--limit <n>]Credit cost: 2 credits
Options
| Option | Values | Default | Description |
|---|---|---|---|
--sort | hot, new, top, rising, controversial | hot | Sort method |
--time | hour, day, week, month, year, all | day | Time range (applies to top and controversial) |
--limit | integer | 25 | Number of posts to return |
Examples
# Hot posts (default)
reddgrow subreddits posts webdev
# Top posts of the past week, 50 results
reddgrow subreddits posts webdev --sort top --time week --limit 50
# Newest posts
reddgrow subreddits posts javascript --sort new --limit 10
# Rising posts
reddgrow r posts rust --sort risingcomments
Get recent comments from a subreddit's comment stream.
reddgrow subreddits comments <name> [--limit <n>]Credit cost: 2 credits
| Option | Default | Description |
|---|---|---|
--limit | 25 | Number of comments to return |
reddgrow subreddits comments reactjs --limit 50
reddgrow r comments cscareerquestionswiki
List all wiki page names for a subreddit.
reddgrow subreddits wiki <name>Credit cost: 5 credits
reddgrow subreddits wiki python
reddgrow r wiki learnprogrammingwiki-page
Read the full Markdown content of a specific wiki page.
reddgrow subreddits wiki-page <name> <page>Credit cost: 5 credits
reddgrow subreddits wiki-page python introduction
reddgrow r wiki-page learnprogramming faqwidgets
Get the sidebar widgets for a subreddit, including community links, text blocks, and resources.
reddgrow subreddits widgets <name>Credit cost: 1 credit
reddgrow subreddits widgets SideProject
reddgrow r widgets entrepreneurtraffic
Get historical traffic statistics for a subreddit — pageviews and unique visitors broken down by day, hour, and month.
reddgrow subreddits traffic <name>Credit cost: 1 credit
reddgrow subreddits traffic programming
reddgrow r traffic MachineLearningcheck-url
Check whether a specific URL has already been submitted to a subreddit. Returns any existing posts that share the URL.
reddgrow subreddits check-url <name> <url>Credit cost: 3 credits
reddgrow subreddits check-url programming https://example.com/my-blog-post
reddgrow r check-url webdev https://yourdomain.com/articleCredit Summary
| Command | Credits |
|---|---|
search | 3 |
about | 1 |
rules | 1 |
posts | 2 |
comments | 2 |
wiki | 5 |
wiki-page | 5 |
widgets | 1 |
traffic | 1 |
check-url | 3 |