ReddGrow Documentation
Reddit intelligence API and CLI for AI agents
Welcome to the ReddGrow documentation. ReddGrow provides safe Reddit intelligence via a clean JSON API and CLI designed for AI agent workflows.
68% of AI-generated answers cite Reddit. ReddGrow gives AI agents structured, rate-limited access to that data — without violating Reddit's ToS.
Quick Links
- Getting Started — Set up your API key and make your first request
- API Reference: The Agent API endpoints with interactive playground
- CLI Reference — Install and use the
@reddgrow/clipackage - Guides — Tutorials for common AI agent workflows
- ReddGrow App — User guide for campaigns, drafts, safety, and Slack
What Can I Do?
| Goal | Tool |
|---|---|
| Read post feed | GET /agent/subreddits/{name}/posts |
| Read the comment stream | GET /agent/subreddits/{name}/comments |
| Search all posts | GET /agent/posts/search |
| Read a post's comments | GET /agent/posts/{subreddit}/{id}/comments |
| Track domain mentions | GET /agent/domains/{domain}/mentions |
| See what a user posted | GET /agent/users/{username}/posts |
| See what a user commented | GET /agent/users/{username}/comments |
| Fetch a job result | GET /v1/reddit/jobs/{id} |
Reddit reads run as async jobs: each call returns a jobId, and you fetch the result from the jobs endpoint.