Microsoft experiments on users.
\n\nWordPress experiments on developers.
\n\nPick your poison.
\nMicrosoft experiments on users.
\n\nWordPress experiments on developers.
\n\nPick your poison.
\n
| "Actor succeeded with N results in the dataset" | Run finished. Some or zero records pushed. | Open the dataset to view results. |
| 
| "The Actor process failed…" | Validation error or upstream Reddit fault. | Check the run log. You are NOT charged for failed runs. |
| 
| "The Actor timed out. You can resurrect it with a longer timeout to continue where you left off." | Run exceeded its timeout. | Re-run with a smaller `limit` or fewer inputs. |
| 
| "The Actor process was aborted. You can resurrect it to continue where you left off." | You stopped the run manually. | No charge for unpushed results. |
**Common in-run conditions** *(visible in run log)*
| Condition | Cause | Result |
|---|---|---|
| Empty result set | Subreddit empty / banned / private. | Run `SUCCEEDED`, 0 records, no charge. |
| Removed post stub | Post was removed; metadata still partial. | Run `SUCCEEDED`, returns stub with `removed_by_category`. |
| `qa` sort fallback | `qa` sort outside QA-mode subs. | Run `SUCCEEDED`, falls back to `top`. |
| Validation error: `post` required | Missing `post` field on Detail / Comments. | Run `FAILED` immediately, no charge. |
***
### Common edge cases
- **Removed / deleted posts** return whatever metadata Reddit still exposes — often a stub with `removed_by_category`.
- **Private / quarantined subreddits** return zero records.
- **500 items per run** — `limit` and `count` go up to 500 per run. Split bigger jobs into several runs.
- **Comments `all` mode is uncapped** — long threads (10k+ comments) hit Reddit's tree size limit before our cap.
- **Comment `qa` sort** — only meaningful in QA-mode subreddits; falls back to `top` elsewhere.
- **NSFW content** — fully supported; the `over_18` flag tells you if a post is age-gated.
***
### Why this actor is fast
- **Speed — 1–3 seconds per call, end-to-end.** Pure HTTP to Reddit's API. No browser to boot, no Playwright / Selenium / Puppeteer overhead. Competing browser-based scrapers typically take 15–60 seconds per call.
- **Reliability — zero browser flakiness.** No headless-Chromium crashes. No JS-render timeouts. No captcha pages. No surprise mid-run failures from a browser quirk.
- **Footprint — under 100 MB RAM per run.** Most browser-based scrapers need 1–4 GB. Built for reliability behind the scenes — just paste your inputs and run.
***
### Pricing
**Free. There is no per-result fee** — we don't charge anything for the results you get, however many you pull.
You only pay Apify's normal platform usage, which is the compute time your run takes. Apify's free plan includes **$5 of usage credit every month**, so you can start right away without a paid plan.
***
### Need a different shape of data?
- **[Reddit Bulk Scrape](https://apify.com/red_crawler/reddit-bulk-scrape)** — paste up to 10000 IDs / names / URLs in a single run (posts, comments, subreddits, users)
- **[Reddit Search](https://apify.com/red_crawler/reddit-search)** — keyword search across posts, subreddits, users
- **[Reddit Users](https://apify.com/red_crawler/reddit-users)** — single-user lookups with profile + trophies + posts + comments
- **[Reddit Subreddits](https://apify.com/red_crawler/reddit-subreddits)** — subreddit info, rules, browse, listings, autocomplete (8 ops)
- **[Reddit Posts](https://apify.com/red_crawler/reddit-posts)** — front-page feed, crosspost duplicates, pinned posts
***
### Support and feedback
Found a bug, want a feature, or hit a Reddit error code we don't translate clearly? Open an issue via the actor's Apify Console feedback link, or reach out at the RedCrawler support channel.
***
*Reddit Scraper — Subreddit Feeds, Posts, Comments is part of the RedCrawler family of Reddit actors. RedCrawler is independent — not affiliated with, endorsed by, or sponsored by Reddit, Inc. Use it within Reddit's API terms.*
# Actor input Schema
## `endpoint` (type: `string`):
Choose which kind of Reddit content to retrieve.
## `subreddit` (type: `string`):
Subreddit name without the r/ prefix. Used by: Scrape Posts.
## `sort` (type: `string`):
Post sort order. Used by: Scrape Posts.
## `time_filter` (type: `string`):
Time window — IGNORED unless sort is set to 'top' or 'controversial'. Leave as '—' for other sort orders.
## `limit` (type: `integer`):
Max posts to fetch (1–500). Used by: Scrape Posts.
## `post_detail_url` (type: `string`):
Reddit post permalink, t3_xxxxx, or short id. Used by: Post Detail.
## `comments_post_url` (type: `string`):
Reddit post permalink, t3_xxxxx, or short id whose comments you want. Used by: Scrape Comments.
## `comments_num` (type: `integer`):
How many comments to return (1–500). Used by: Scrape Comments.
## `comment_sort` (type: `string`):
Comment sort order. Used by: Scrape Comments.
## `comment_mode` (type: `string`):
How to traverse the comment tree. 'custom' = full tree to count, 'top_level' = top comments only, 'all' = full tree no limit.
## `comment_url` (type: `string`):
Reddit comment permalink, t1_xxxxx, or short id. Used by: Comment Detail.
## Actor input object example
```json
{
"endpoint": "subreddit_posts",
"subreddit": "AskReddit",
"sort": "hot",
"time_filter": "",
"limit": 25,
"post_detail_url": "https://www.reddit.com/r/Wordpress/comments/1s4a4j6/",
"comments_post_url": "https://www.reddit.com/r/Wordpress/comments/1s4a4j6/",
"comments_num": 100,
"comment_sort": "top",
"comment_mode": "custom"
}
```
# API
You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.
## JavaScript example
```javascript
import { ApifyClient } from 'apify-client';
// Initialize the ApifyClient with your Apify API token
// Replace the '