API Reference
Use Crawlora's Reddit Scraper API endpoints to extract supported public Reddit data as structured JSON. This documentation covers 11 active endpoints including Get Reddit post comments, List Reddit domain posts, Get Reddit post, Search Reddit posts, and related APIs. Developers can use these endpoints for monitoring, enrichment, research dashboards, internal data pipelines, and agent-native workflows without maintaining platform-specific scraping code. Each endpoint page documents authentication, request parameters such as id, domain, q, subreddit, cURL examples, response examples, response schemas, errors, credit cost, and Playground testing. Send requests to the Crawlora API with an x-api-key header, review usage and plan limits on pricing, and test safe sample requests in Playground before moving the workflow into production.
Choose an endpoint, send an authenticated request with the x-api-key header, and inspect the normalized JSON response. The examples below use the public Crawlora API base URL and the same endpoint catalog used by Playground.
curl -X GET "https://api.crawlora.net/api/v1/reddit/search?q=coffee&sort=relevance&time=hour&limit=10" \
-H "x-api-key: $CRAWLORA_API_KEY"These endpoint cards are generated from the active Crawlora endpoint catalog, including method, path, auth mode, credit cost, parameter summary, docs, and Playground links.
/reddit/comments/{id}apiKey1 credit/requestReturns a Reddit post with its public comments. A post that exists but has no comments yet returns a 200 response with an empty comments list; a post that does not exist returns 404, and a temporary block or upstream failure returns 503 (retryable) rather than 404.
Required params: id:path
/reddit/domain/{domain}/postsapiKeyNo listed credit chargeReturns normalized public posts submitted from a linked domain.
Required params: domain:path
/reddit/post/{id}apiKey1 credit/requestReturns a normalized public Reddit post entry.
Required params: id:path
/reddit/searchapiKey1 credit/requestSearches public Reddit content and returns normalized public post entries.
Required params: q:query
/reddit/subreddit/{subreddit}/aboutapiKey1 credit/requestReturns public metadata and sample posts for a subreddit. Subscriber counts, icons, and banners are omitted because they are not available on anonymous Reddit pages.
Required params: subreddit:path
/reddit/subreddit/{subreddit}/commentsapiKey1 credit/requestReturns flat public comment entries from a subreddit latest-comments feed.
Required params: subreddit:path
/reddit/subreddit/{subreddit}/postsapiKey1 credit/requestReturns normalized public posts from a subreddit.
Required params: subreddit:path
/reddit/subreddits/postsapiKey1 credit/requestReturns normalized public posts from a combined multi-subreddit feed.
Required params: subreddits:query
/reddit/trendsapiKey1 credit/requestReturns normalized public posts from broad Reddit hot, new, rising, or top feeds. For subreddit-specific trends, use `/reddit/subreddit/{subreddit}/posts` with `sort=hot`, `sort=new`, `sort=rising`, or `sort=top`.
Required params: None
/reddit/user/{username}/commentsapiKey1 credit/requestReturns flat public comment entries from a public Reddit user's comments feed.
Required params: username:path
/reddit/user/{username}/postsapiKey1 credit/requestReturns normalized public posts from a public Reddit user's submitted feed.
Required params: username:path
| Endpoint | API path | Method | Credits | Required params | Docs | Playground |
|---|---|---|---|---|---|---|
| Get Reddit post comments | /reddit/comments/{id} | GET | 1 credit/request | id:path | View docs | Try endpoint |
| List Reddit domain posts | /reddit/domain/{domain}/posts | GET | No listed credit charge | domain:path | View docs | Try endpoint |
| Get Reddit post | /reddit/post/{id} | GET | 1 credit/request | id:path | View docs | Try endpoint |
| Search Reddit posts | /reddit/search | GET | 1 credit/request | q:query | View docs | Try endpoint |
| Get Reddit subreddit metadata | /reddit/subreddit/{subreddit}/about | GET | 1 credit/request | subreddit:path | View docs | Try endpoint |
| List Reddit subreddit comments | /reddit/subreddit/{subreddit}/comments | GET | 1 credit/request | subreddit:path | View docs | Try endpoint |
| List Reddit subreddit posts | /reddit/subreddit/{subreddit}/posts | GET | 1 credit/request | subreddit:path | View docs | Try endpoint |
| List Reddit multi-subreddit posts | /reddit/subreddits/posts | GET | 1 credit/request | subreddits:query | View docs | Try endpoint |
| List Reddit trends | /reddit/trends | GET | 1 credit/request | None | View docs | Try endpoint |
| List Reddit user comments | /reddit/user/{username}/comments | GET | 1 credit/request | username:path | View docs | Try endpoint |
| List Reddit user posts | /reddit/user/{username}/posts | GET | 1 credit/request | username:path | View docs | Try endpoint |