# Reddit Scraper Pro: Posts, Comments, Subreddits & Search (`leado/reddit-scraper-pro`) Actor

Scrape Reddit posts, comment threads, subreddits, user posts, and keyword search results in one run. No Reddit API key or login needed. From $1.00 per 1,000 posts and $0.50 per 1,000 comments with $0 start fee. Export clean JSON, CSV, Excel, or Markdown for AI/RAG.

- **URL**: https://apify.com/leado/reddit-scraper-pro.md
- **Developed by:** [Leado](https://apify.com/leado) (community)
- **Features:** Limited permissions
- **Stats:** 3 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.70 / 1,000 posts

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Reddit Scraper Pro: Posts, Comments, Subreddits & Search

### What does Reddit Scraper Pro do?

Reddit Scraper Pro extracts Reddit posts, comment threads, subreddit feeds, user submissions, and keyword search results into structured JSON, CSV, Excel, or AI-ready Markdown. It runs without a Reddit account, OAuth API keys, or external proxy configuration.

You can scrape multiple subreddits, search queries, post URLs, and user profiles in a single run. Posts start at **$1.00 per 1,000** and comments start at **$0.50 per 1,000** on the Free plan, down to **$0.70 per 1,000 posts** and **$0.35 per 1,000 comments** on higher tiers, with **$0.00 run start fee** and **$0.00 charged for empty runs**.

### Why use Reddit Scraper Pro?

- **Complete metadata on every record:** Unlike scrapers that fall back to stripped RSS feeds when Reddit blocks logged-out browsers, Reddit Scraper Pro returns `score`, `upvoteRatio`, `numComments`, `parentId`, `linkFlairText`, and full Markdown `selfText`.
- **Automatic spam and deleted-post removal:** When `excludeRemoved` is enabled (on by default), posts and comments removed by moderators, AutoModerator, or authors (`[removed]` and `[deleted]`) are skipped before billing so you only pay for usable content.
- **No per-run start fee:** Many pay-per-event Reddit scrapers charge a fixed startup fee on every run, which makes frequent scheduled monitoring expensive. Reddit Scraper Pro charges $0 to start a run.
- **Fast execution with minimal memory:** Runs in a lightweight 256 MB container and finishes typical multi-subreddit jobs in 2 to 5 seconds instead of launching headless browsers.
- **Drop-in field compatibility:** Output records include both camelCase and legacy alias fields (`selfText` and `body`, `score` and `upVotes`, `numComments` and `numberOfComments`, `author` and `username`, `type` and `dataType`) so you can switch from other Apify Reddit scrapers without changing downstream code.

### What data can you extract from Reddit?

| Data type | Extracted fields |
| :--- | :--- |
| **Posts (`type: "post"`)** | `id`, `title`, `selfText` (`body`), `author` (`username`), `subreddit`, `communityName`, `score` (`upVotes`), `upvoteRatio`, `numComments` (`numberOfComments`), `createdAt`, `createdUtc`, `url`, `permalink`, `link`, `domain`, `isNSFW` (`over18`), `isSelf`, `isVideo`, `isStickied`, `linkFlairText`, `totalAwards`, `scrapedAt` |
| **Comments (`type: "comment"`)** | `id`, `postId`, `postTitle`, `parentId`, `author` (`username`), `body`, `score` (`upVotes`), `createdAt`, `createdUtc`, `permalink`, `url`, `postUrl`, `subreddit`, `isSubmitter`, `scrapedAt` |
| **AI / LLM formats (optional)** | `markdown` (formatted document chunk with metadata header for RAG vector databases) or `instruction` / `input` / `output` pairs for supervised fine-tuning (SFT) |

### How much does it cost to scrape Reddit?

Reddit Scraper Pro uses transparent Pay-Per-Event pricing. There is no monthly rental fee and no run start fee.

| Plan tier | Posts (`$ per 1,000`) | Comments (`$ per 1,000`) | Run start fee |
| :--- | :--- | :--- | :--- |
| **Free** | **$1.00** (`$0.001 / post`) | **$0.50** (`$0.0005 / comment`) | **$0.00** |
| **Bronze (Starter)** | **$0.90** (`$0.0009 / post`) | **$0.45** (`$0.00045 / comment`) | **$0.00** |
| **Silver (Scale)** | **$0.80** (`$0.0008 / post`) | **$0.40** (`$0.00040 / comment`) | **$0.00** |
| **Gold / Business** | **$0.70** (`$0.0007 / post`) | **$0.35** (`$0.00035 / comment`) | **$0.00** |

#### Cost examples (Free tier)

- **Monitor 10 subreddits (10 newest posts each = 100 posts):** `$0.10`
- **Scrape 50 posts + top 5 comments per post (50 posts + 250 comments):** `$0.05 + $0.125 = $0.175`
- **Run that finds 0 matching posts:** `$0.00`

### How to scrape Reddit posts and comments

#### 1. Scrape newest posts from multiple subreddits

Pass subreddit names in `subreddits` (with or without `r/`) or full URLs in `urls`:

```json
{
  "subreddits": ["SaaS", "startups", "Entrepreneur"],
  "sort": "new",
  "maxPostsPerSource": 25,
  "includeComments": false,
  "excludeRemoved": true
}
```

#### 2. Scrape comment threads from direct Reddit post URLs

Pass one or more Reddit post URLs in `urls`. Comment extraction runs automatically for direct post URLs:

```json
{
  "urls": [
    "https://www.reddit.com/r/SaaS/comments/1xti7e3/people_can_love_your_product_and_still_never_buy/"
  ],
  "includeComments": true,
  "maxCommentsPerPost": 10
}
```

#### 3. Search Reddit by keyword for lead generation and brand monitoring

Combine `searchQueries` with `subreddits` to search inside target communities, or leave `subreddits` empty to search all of Reddit:

```json
{
  "subreddits": ["SaaS", "b2bmarketing", "sales"],
  "searchQueries": ["cold email tool", "CRM alternative", "looking for software"],
  "timeWindow": "7d",
  "maxPostsPerSource": 50,
  "includeComments": true,
  "maxCommentsPerPost": 5
}
```

#### 4. Scrape posts from specific Reddit users

```json
{
  "usernames": ["spez", "sama"],
  "maxPostsPerSource": 20,
  "includeComments": false
}
```

### Input parameters

| Parameter | Type | Default | Description |
| :--- | :--- | :--- | :--- |
| `urls` | `string[]` | `[]` | Subreddit URLs, direct post URLs, or user profile URLs. Also accepts `startUrls` or single `url`. |
| `subreddits` | `string[]` | `[]` | Subreddit names (for example `["SaaS", "startups"]`). |
| `searchQueries` | `string[]` | `[]` | Keywords or phrases to search. Scoped to `subreddits` if provided, or searched across all of Reddit. |
| `usernames` | `string[]` | `[]` | Reddit usernames to scrape submissions from. |
| `sort` | `string` | `"new"` | `"new"` (latest posts first), `"top"`, or `"hot"`. |
| `maxPostsPerSource` | `integer` | `25` | Maximum posts returned per subreddit, query, or user (1 to 500). |
| `timeWindow` | `string` | `"all"` | Filter posts by age: `"all"`, `"1h"`, `"4h"`, `"24h"`, `"7d"`, or `"30d"`. |
| `includeComments` | `boolean` | `false` | Extract top comments for each post. Always enabled for direct post URLs. |
| `maxCommentsPerPost` | `integer` | `10` | Maximum comments returned per post (1 to 100). |
| `filterKeywords` | `string[]` | `[]` | Optional post-scrape keyword filter applied to title and body. |
| `filterKeywordMode` | `string` | `"any"` | `"any"`, `"all"`, or `"titleOnly"`. |
| `minScore` | `integer` | `0` | Only keep posts with `score >= minScore`. |
| `minComments` | `integer` | `0` | Only keep posts with `numComments >= minComments`. |
| `excludeRemoved` | `boolean` | `true` | Skip `[removed]`, `[deleted]`, and AutoModerator records. |
| `includeNSFW` | `boolean` | `false` | Include 18+ NSFW posts when set to `true`. |
| `outputFormat` | `string` | `"default"` | `"default"` (standard JSON), `"rag-markdown"`, or `"jsonl-finetune"`. |

### Output example

#### Post record (`type: "post"`)

```json
{
  "type": "post",
  "dataType": "post",
  "id": "1xy6xys",
  "parsedId": "1xy6xys",
  "title": "190+ people cloned outbid.lol. Almost none of them copied the part that made money",
  "selfText": "If you missed it: in August Jonathan Wilke built outbid.lol in about 3 hours...",
  "body": "If you missed it: in August Jonathan Wilke built outbid.lol in about 3 hours...",
  "author": "x7zachary",
  "username": "x7zachary",
  "subreddit": "SaaS",
  "parsedCommunityName": "SaaS",
  "communityName": "r/SaaS",
  "score": 15,
  "upVotes": 15,
  "upvoteRatio": 0.94,
  "numComments": 8,
  "numberOfComments": 8,
  "createdAt": "2026-11-17T01:05:45.000Z",
  "createdUtc": 1794877545,
  "url": "https://www.reddit.com/r/SaaS/comments/1xy6xys/190_people_cloned_outbidlol_almost_none_of_them/",
  "permalink": "https://www.reddit.com/r/SaaS/comments/1xy6xys/190_people_cloned_outbidlol_almost_none_of_them/",
  "link": "https://www.reddit.com/r/SaaS/comments/1xy6xys/190_people_cloned_outbidlol_almost_none_of_them/",
  "domain": "self.SaaS",
  "isNSFW": false,
  "over18": false,
  "isSelf": true,
  "isVideo": false,
  "isStickied": false,
  "linkFlairText": "Discussion",
  "totalAwards": 0,
  "scrapedAt": "2026-11-17T01:15:00.000Z"
}
```

#### Comment record (`type: "comment"`)

```json
{
  "type": "comment",
  "dataType": "comment",
  "id": "19sh85hiuly4l",
  "parsedId": "19sh85hiuly4l",
  "postId": "1xti7e3",
  "postTitle": "People can love your product and still never buy it.",
  "parentId": "t3_1xti7e3",
  "author": "herenerd",
  "username": "herenerd",
  "body": "Maybe they are getting too much free value that they don't think it's worth paying for the premium plans?",
  "score": 4,
  "upVotes": 4,
  "createdAt": "2026-11-11T14:08:46.000Z",
  "createdUtc": 1794406126,
  "permalink": "https://www.reddit.com/r/SaaS/comments/1xti7e3/comment/19sh85hiuly4l/",
  "url": "https://www.reddit.com/r/SaaS/comments/1xti7e3/comment/19sh85hiuly4l/",
  "postUrl": "https://www.reddit.com/r/SaaS/comments/1xti7e3/people_can_love_your_product_and_still_never_buy/",
  "subreddit": "SaaS",
  "isSubmitter": false,
  "scrapedAt": "2026-11-17T01:15:01.000Z"
}
```

### How to use Reddit data for AI, RAG, and LLM fine-tuning

Set `outputFormat` to prepare records directly for AI pipelines:

- **`"default"`**: Standard structured JSON for databases, spreadsheets, and automation tools.
- **`"rag-markdown"`**: Adds a `markdown` field containing the post title, subreddit, author, score, timestamp, canonical URL, and body formatted for chunking and embedding into Pinecone, Qdrant, Weaviate, or pgvector.
- **`"jsonl-finetune"`**: Adds `instruction`, `input`, and `output` fields for supervised fine-tuning (SFT) datasets.

Combine `excludeRemoved: true` and `minScore: 2` when building training corpora to filter out low-quality or moderated submissions.

### API usage (Node.js & Python)

#### Node.js (`apify-client`)

```javascript
import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: process.env.APIFY_TOKEN });

const run = await client.actor('YOUR_USERNAME/reddit-scraper-pro').call({
    subreddits: ['SaaS', 'startups'],
    sort: 'new',
    maxPostsPerSource: 15,
    includeComments: true,
    maxCommentsPerPost: 3,
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);
```

#### Python (`apify-client`)

```python
from apify_client import ApifyClient

client = ApifyClient("YOUR_APIFY_TOKEN")

run = client.actor("YOUR_USERNAME/reddit-scraper-pro").call(run_input={
    "subreddits": ["SaaS", "startups"],
    "sort": "new",
    "maxPostsPerSource": 15,
    "includeComments": True,
    "maxCommentsPerPost": 3,
})

items = client.dataset(run["defaultDatasetId"]).list_items().items
print(items)
```

### Integrations and MCP support

Reddit Scraper Pro works with:

- **MCP (Model Context Protocol):** Connect via Apify's MCP server (`https://mcp.apify.com`) in Claude Code, Claude Desktop, Cursor, or Windsurf to let AI agents search subreddits and inspect threads on demand.
- **Automation platforms:** Trigger scheduled runs and route new leads to Slack, HubSpot, Notion, Google Sheets, or webhooks via **n8n**, **Make**, or **Zapier**.

### FAQ

#### Do I need a Reddit account or Reddit API credentials?

No. Reddit Scraper Pro collects publicly available Reddit data without requiring a Reddit account, OAuth app registration, or external proxy setup.

#### Why are my runs so fast compared to browser-based Reddit scrapers?

Instead of booting Chromium and loading megabytes of frontend assets through residential proxies, Reddit Scraper Pro queries structured Reddit data endpoints directly and filters records in memory.

#### Am I charged for `[removed]` or `[deleted]` posts?

When `excludeRemoved` is set to `true` (the default), removed and deleted posts and comments are filtered out before being pushed to the dataset, so they are never billed.

#### Can I scrape both subreddit feeds and specific post URLs in the same run?

Yes. You can pass subreddit URLs, direct post URLs, and user profile URLs together in `urls`, or combine `subreddits`, `searchQueries`, and `usernames`.

# Actor input Schema

## `urls` (type: `array`):

List of Reddit URLs to scrape: subreddit URLs (https://www.reddit.com/r/SaaS/), direct post URLs (https://www.reddit.com/r/SaaS/comments/...), or user profile URLs (https://www.reddit.com/user/spez/).

## `subreddits` (type: `array`):

Subreddit names to scrape (with or without 'r/' prefix, for example 'SaaS' or 'startups'). Can be used alone or combined with Search Queries.

## `searchQueries` (type: `array`):

Search Reddit posts by keyword or phrase. If Subreddits are also specified, each query runs inside those subreddits; otherwise it searches across all of Reddit.

## `usernames` (type: `array`):

Scrape posts submitted by specific Reddit users (without 'u/' prefix).

## `sort` (type: `string`):

Sort order for posts ('new' returns latest posts first; 'top' and 'hot' sort fetched results by score).

## `maxPostsPerSource` (type: `integer`):

Maximum number of posts to extract per subreddit, search query, or user profile (1 to 500).

## `timeWindow` (type: `string`):

Only return posts newer than the selected time range.

## `includeComments` (type: `boolean`):

Extract top comments for each scraped post. Automatically enabled when scraping direct post URLs.

## `maxCommentsPerPost` (type: `integer`):

Maximum number of comments to extract per post when Include Comments is enabled (1 to 100).

## `filterKeywords` (type: `array`):

Optional list of keywords to filter scraped posts (case-insensitive). Leave empty to keep all posts.

## `filterKeywordMode` (type: `string`):

How Filter Keywords are matched against posts.

## `minScore` (type: `integer`):

Only keep posts with a score greater than or equal to this value.

## `minComments` (type: `integer`):

Only keep posts that have at least this many comments.

## `excludeRemoved` (type: `boolean`):

Skip posts and comments that were removed by moderators or AutoMod or deleted by the author.

## `includeNSFW` (type: `boolean`):

Whether to include NSFW posts in the dataset.

## `outputFormat` (type: `string`):

Choose standard JSON records or AI-ready formats for RAG vector databases and LLM fine-tuning.

## Actor input object example

```json
{
  "urls": [
    "https://www.reddit.com/r/SaaS/"
  ],
  "subreddits": [
    "SaaS",
    "startups"
  ],
  "searchQueries": [],
  "usernames": [],
  "sort": "new",
  "maxPostsPerSource": 10,
  "timeWindow": "all",
  "includeComments": false,
  "maxCommentsPerPost": 5,
  "filterKeywords": [],
  "filterKeywordMode": "any",
  "minScore": 0,
  "minComments": 0,
  "excludeRemoved": true,
  "includeNSFW": false,
  "outputFormat": "default"
}
```

# Actor output Schema

## `dataset` (type: `string`):

No description

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "urls": [
        "https://www.reddit.com/r/SaaS/"
    ],
    "subreddits": [
        "SaaS",
        "startups"
    ],
    "maxPostsPerSource": 10,
    "maxCommentsPerPost": 5
};

// Run the Actor and wait for it to finish
const run = await client.actor("leado/reddit-scraper-pro").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "urls": ["https://www.reddit.com/r/SaaS/"],
    "subreddits": [
        "SaaS",
        "startups",
    ],
    "maxPostsPerSource": 10,
    "maxCommentsPerPost": 5,
}

# Run the Actor and wait for it to finish
run = client.actor("leado/reddit-scraper-pro").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "urls": [
    "https://www.reddit.com/r/SaaS/"
  ],
  "subreddits": [
    "SaaS",
    "startups"
  ],
  "maxPostsPerSource": 10,
  "maxCommentsPerPost": 5
}' |
apify call leado/reddit-scraper-pro --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,leado/reddit-scraper-pro"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/NueY24IQqRnMLIyhc/builds/NR7de4aKx9zf7ZZOw/openapi.json
