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 profiles, domain-level discussions — all through a simple REST API authenticated with an API key.
What you can do
- Fetch posts from any subreddit in real time
- Search Reddit by keyword, domain, or author
- Resolve user profiles and karma breakdowns
- Monitor brand mentions across communities
- Batch multiple lookups in a single request
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; heavy batch operations cost up to 5. 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