Fetch Reddit posts with their comment trees or search across Reddit for posts and comments.
Available Tools
| Endpoint | Path | Credits |
|---|---|---|
| Post | /api/v1/tools/reddit/post | 1 (2 with expandComments) |
| Search | /api/v1/tools/reddit/search | 1 |
| Subreddit | /api/v1/tools/reddit/subreddit | 1 (2 with includeComments) |
| User Posts | /api/v1/tools/reddit/user-posts | 1 (2 with includeComments) |
| User Comments | /api/v1/tools/reddit/user-comments | 1 |
| Community | /api/v1/tools/reddit/community | 1 |
Authentication
All tool endpoints use the same Authorization header as the scrape API:
Authorization: Bearer sc_live_your_key_here
Response Format
Every tool returns a consistent envelope with data and meta fields:
{
"data": { ... },
"meta": {
"tool": "reddit-post",
"creditsUsed": 1,
"requestId": "req_abc123"
}
}
Credit cost and request ID are also returned in response headers: X-Request-Cost, X-Remaining-Credits, X-Request-Id.