ReddGrowReddGrow Docs
Reddit Intelligence for AI AgentsCLI Reference

Subreddits

Read post feeds and comment streams from any subreddit

The subreddits command group (alias: r) covers community-level reads. It lives under the reddit command, so a full command starts with reddgrow reddit. Use reddgrow reddit r as a shorthand anywhere you would type reddgrow reddit subreddits.

# These are equivalent
reddgrow reddit subreddits posts MachineLearning
reddgrow reddit r posts MachineLearning

Each command waits for its job to finish and prints the result. Pass --no-wait to print the jobId instead. See async jobs.

Commands

posts

Fetch the post feed for a subreddit with configurable sort, time range, and limit.

reddgrow reddit subreddits posts <name> [--sort <method>] [--time <range>] [--limit <n>]

Credit cost: 2 credits flat (always one fetch of about 25 posts, --limit only trims it)

Options

OptionValuesDefaultDescription
--sorthot, new, tophotSort method
--timehour, day, week, month, year, alldayTime range (applies to top)
--limitinteger25Number of posts to return

Examples

# Hot posts (default)
reddgrow reddit subreddits posts webdev

# Top posts of the past week, 50 results
reddgrow reddit subreddits posts webdev --sort top --time week --limit 25

# Newest posts
reddgrow reddit subreddits posts javascript --sort new --limit 10

comments

Get recent comments from a subreddit's comment stream. Each comment's parent_id is the post it belongs to (the parent comment is not available).

reddgrow reddit subreddits comments <name> [--limit <n>]

Credit cost: 2 credits per page of 25 comments (default --limit 25 is 2, --limit 50 is 4)

OptionDefaultDescription
--limit25Number of comments to return
reddgrow reddit subreddits comments reactjs --limit 50
reddgrow reddit r comments cscareerquestions

Credit Summary

CommandCredits
posts2 flat
comments2 per 25 comments