API Reference
All 9 ReddGrow Agent API endpoints with interactive playground
The ReddGrow Agent API provides structured Reddit intelligence for AI agents. All endpoints use GET requests and return clean JSON. Reddit reads are asynchronous jobs: they answer 202 with a jobId, and you poll GET /agent/jobs/{id} for the result (see below).
Base URL
https://api.reddgrow.aiAuthentication
Pass your API key in the x-api-key header:
curl -H "x-api-key: rg_your_key_here" https://api.reddgrow.ai/agent/meAsynchronous reads
Reddit reads run on ReddGrow's logged-out scraper, so they are jobs rather than live calls. Create a job, then poll it:
# 1. Create the job (returns immediately)
curl -H "x-api-key: rg_your_key_here" "https://api.reddgrow.ai/agent/posts/search?q=typescript"
# {"jobId":"3f1c...","status":"queued"}
# 2. Poll until status is "completed" or "failed" (free)
curl -H "x-api-key: rg_your_key_here" https://api.reddgrow.ai/agent/jobs/3f1c...
# {"jobId":"3f1c...","status":"completed","creditsCharged":4,"result":[...]}status moves through queued, running, then completed (the data is in result) or failed (see error). A job usually finishes in under a minute and is kept for 24 hours. Creating a job reserves credits for the pages your limit can need, and the unused pages are refunded when it finishes. The final charge is creditsCharged on the finished job. If the job fails on ReddGrow's side (error.status 503), the full reservation is refunded. If Reddit answers 403, 404 or 429, you pay for the pages fetched (at least 1 page) and the rest is refunded.
Credit Costs
Reads are priced per Reddit page fetched. limit defaults to 25 (minimum 1, maximum 100) and at most 8 pages are fetched per read.
| Read | Credits per page | Default (limit 25) |
|---|---|---|
| Subreddit posts | 2 (always 1 page) | 2 |
| Post comments | 2 (always 1 page) | 2 |
| Subreddit comments | 2 (25 per page) | 2 |
| User posts | 1 (about 20 per page) | 2 |
| User comments | 2 (25 per page) | 2 |
| Post search | 1 (7 per page) | 4 |
| Domain mentions | 5 (25 per page) | 5 |
| Job polling | 0 | 0 |
Endpoint Groups
- Meta: Account info, credit balance and job status (2 endpoints)
- Subreddits: Subreddit posts and comment stream (2 endpoints)
- Posts: Search and post comments (2 endpoints)
- Users: Post history and comment history (2 endpoints)
- Domains: Reddit mentions of any domain (1 endpoint)