Reddit Scraper API docs
One REST API for Reddit data. Authenticate with a key, call an endpoint, get structured JSON back. Every request is metered in credits and billed only on success.
Base URL
All endpoints live under a single base URL. Send standard HTTP GET requests; responses are JSON.
https://api.redditscraperapi.com/api/v1Authentication
Pass your API key as the api_key query parameter on every request. Create and manage keys in your dashboard. Keep keys server-side; do not expose them in client-side code.
https://api.redditscraperapi.com/api/v1/<endpoint>?...&api_key=YOUR_API_KEYYour first request
curl "https://api.redditscraperapi.com/api/v1/reddit/subreddit?subreddit=python&api_key=YOUR_API_KEY"Reddit endpoints
Each endpoint returns a stable JSON shape. Follow a link for its full parameters and response fields.
| Endpoint | What it returns |
|---|---|
Comment Thread | how to scrape reddit comments |
Post | reddit post scraper |
Search | reddit search api |
User | scrape reddit profile |
Subreddit | reddit thread scraper |
Credits and limits
Usage is metered in credits: each successful Reddit request costs 5 credits. The free plan includes 1,000 scrapes. Failed requests are retried automatically and never charged, and your live balance, plan limit, and usage history are in the dashboard. See pricing for plan allowances and pay-as-you-go.
Response and error codes
| Status | Meaning |
|---|---|
| 200 | Success. The response body is the parsed JSON for your request. |
| 401 | Missing or invalid api_key. Check the key in your dashboard. |
| 402 | Out of credits or plan limit reached. Top up or upgrade in the dashboard. |
| 404 | The requested resource does not exist (for example a deleted or private item). |
| 429 | Rate limit exceeded for your plan. Slow the request rate or upgrade. |
| 5xx | A temporary upstream issue. The request is retried for you; persistent errors are not charged. |