Reddit Intelligence for AI AgentsCLI Reference
Posts
Search Reddit posts and fetch comments for a specific post
The posts command group provides cross-subreddit post search and comment fetching. Commands live under reddgrow reddit, wait for their job to finish, and print the result. Pass --no-wait to print the jobId instead.
Commands
search
Search for posts across all of Reddit. The query is matched as an exact phrase and results are returned newest first. Results include titles and metadata only, so selftext is empty.
reddgrow reddit posts search <query> [--limit <n>]Credit cost: 1 credit per page of 7 results (default --limit 25 is 4 credits, --limit 7 is 1, --limit 100 is 8)
| Option | Default | Description |
|---|---|---|
--limit | 25 | Number of results to return (1 to 100) |
Examples
reddgrow reddit posts search "typescript performance tips"
reddgrow reddit posts search "rust vs go" --limit 50
reddgrow reddit posts search "show hn" --limit 10comments
Fetch the comments for a specific post.
reddgrow reddit posts comments <subreddit> <id> [--limit <n>]Credit cost: 2 credits flat (a post's comments are always one fetch, whatever the limit)
| Argument | Description |
|---|---|
subreddit | Subreddit name (without r/) |
id | Reddit post ID (the alphanumeric string in the post URL) |
| Option | Default | Description |
|---|---|---|
--limit | 25 | Number of comments to return |
Examples
# Post URL: reddit.com/r/programming/comments/abc123/...
reddgrow reddit posts comments programming abc123
reddgrow reddit posts comments programming abc123 --limit 100Credit Summary
| Command | Credits |
|---|---|
search | 1 per 7 results (4 at the default limit) |
comments | 2 flat |