Getting Started
Set up the ReddGrow API and CLI in under 5 minutes
ReddGrow is a Reddit intelligence API built for AI agents and developers. It gives your agent structured access to Reddit data (subreddit feeds, post search, user post and comment history, domain-level discussions) through a simple REST API authenticated with an API key. Reads run as short async jobs: you create one, then poll for the result.
What you can do
- Fetch posts and recent comments from any subreddit
- Search Reddit by keyword, find posts linking to a domain, or read an author's history
- Read any user's post and comment history
- Monitor brand mentions across communities
- Run many lookups in parallel as jobs
Setup in 3 steps
1. Get your API key
Sign up at reddgrow.ai and create an API key from Settings > API Keys. Keys are prefixed with rg_.
See API Keys for full instructions and security best practices.
2. Make your first request
Verify your key and check your credit balance with a single request:
curl -H "x-api-key: rg_your_key_here" https://api.reddgrow.ai/agent/meSee First Request for curl, CLI, and Node.js examples.
3. Understand credits
Every API call costs credits. Simple lookups cost 1 credit, and Reddit reads are priced per Reddit page fetched (1 to 5 credits per page, depending on the read). Your plan determines your monthly credit limit.
See Credits for the full cost table and plan comparison.
Next steps
- API Reference — full endpoint documentation
- CLI Reference — use ReddGrow from the terminal
- Guides — recipes for common agent workflows