# Reddit Scraper ($0.90/1K) - Posts, Comments, Search (`carabain-digital/reddit-scraper`) Actor

Scrape Reddit posts, comments, subreddits, users and search results without login or API key: title, text, score, upvote ratio, comments with replies, flair, media. Same output as Reddit Scraper Lite, with a built-in residential proxy.

- **URL**: https://apify.com/carabain-digital/reddit-scraper.md
- **Developed by:** [Carabain Digital](https://apify.com/carabain-digital) (community)
- **Categories:** Social media, Lead generation
- **Features:** Limited permissions, Single-tenant, Server interface
- **Stats:** 2 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.54 / 1,000 items

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.
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

#### What is Reddit Scraper?

**Reddit Scraper** extracts **Reddit posts, comments, subreddits, user posts and search results without a login or API key**. For every post you get the **title, full text, author, subreddit, score, upvote ratio, number of comments, flair, media links and date**, and for every comment the **text, author, score, depth and parent**, so you can rebuild whole threads. The output has **the same fields as Reddit Scraper Lite** (`dataType`, `upVotes`, `numberOfComments`, `parentId`, ...), so you can switch without changing your code. A residential proxy is built in, so runs don't end on Reddit's "blocked by network security" page. Built for **brand monitoring, market and product research, lead finding and AI training data**. Prefilled example: the top posts of r/dataisbeautiful this week. Costs **$0.90 per 1,000 items**.

- 🔁 **Drop-in replacement** for trudax/reddit-scraper-lite: same input names, same output keys
- 🛡️ **Built-in residential proxy**, included in the price: no 403s, no API key, no login
- 📰 **Subreddits**: hot, new, top (hour to all time) and rising, with community info
- 💬 **Comments with replies**: depth, parent and reply count to rebuild threads
- 🔎 **Search**: posts and communities by keyword, inside one subreddit or all of Reddit
- 👤 **User posts** from profile URLs
- 🔌 **Connect anywhere**: API, schedules, webhooks, Google Sheets, Make, Zapier, MCP / AI agents

#### What data can I get?

<table>
<tr><td>📝 Post title, full text and HTML</td><td>👍 Score, upvote ratio, number of comments</td></tr>
<tr><td>💬 Comments: text, author, score, depth, parent</td><td>🏷️ Flair, post type, NSFW and promoted flags</td></tr>
<tr><td>🖼️ Image, gallery, video and thumbnail links</td><td>🏘️ Communities: description, weekly visitors, weekly contributions</td></tr>
</table>

#### How do I scrape Reddit?

1. [Create a free Apify account](https://console.apify.com/sign-up) and open this Actor.
2. Paste **Reddit URLs** (subreddits, posts, users or search pages) and/or enter **search terms**.
3. Set **Max posts per source** and **Max comments per post**.
4. Click **Start**, then download the results from the **Output** tab as JSON, CSV, Excel, XML or HTML.

#### How much does it cost?

You pay per item in your dataset: **$0.90 per 1,000 items** (posts, comments and communities alike), no subscription and no start fee. 100 posts with 10 comments each are 1,100 items, about $1. The residential proxy is included. The monthly credit of Apify's Free plan ($5) covers around 5,500 items. Paid plans get volume discounts. Set **Max items** to cap a run.

#### ⬇️ Input

| Field | Description |
|---|---|
| **Reddit URLs** (`startUrls`) | `/r/<sub>/` (+ `hot`, `new`, `top/?t=week`, `rising`), `/r/<sub>/comments/<id>/...`, `/user/<name>/`, `/search/?q=...` |
| **Search terms** (`searches`) | Keywords; **Search within community** (`searchCommunityName`) to stay in one subreddit |
| **Search for posts / communities** (`searchPosts`, `searchCommunities`) | What a search returns |
| **Sort** (`sort`) / **Time filter** (`time`) | Relevance, hot, top, new, most comments; hour to all time |
| **Max items** (`maxItems`), **Max posts per source** (`maxPostCount`), **Max comments per post** (`maxComments`) | Limits |
| **Skip comments / user posts / community info** | Turn parts off |
| **Include NSFW** (`includeNSFW`), **Posts after** (`postDateLimit`), **Comments after** (`commentDateLimit`) | Filters |

```json
{
    "startUrls": [{"url": "https://www.reddit.com/r/homeassistant/new/"}],
    "searches": ["home assistant energy"],
    "maxPostCount": 25,
    "maxComments": 10,
    "postDateLimit": "2026-11-01"
}
```

#### ⬆️ Output

Posts, comments and communities share one schema; filter on `dataType`.

```json
{
    "dataType": "post",
    "id": "t3_1xfwzpj",
    "parsedId": "1xfwzpj",
    "url": "https://www.reddit.com/r/dataisbeautiful/comments/1xfwzpj/oc_how_far_100_of_fuel_takes_you_in_americas/",
    "username": "madredditscientist",
    "userId": "t2_owff7qyq",
    "title": "[OC] How far $100 of fuel takes you in America's best-selling cars",
    "communityName": "r/dataisbeautiful",
    "parsedCommunityName": "dataisbeautiful",
    "body": "Interactive live version with all updates ...",
    "link": "https://i.redd.it/k7aa10ftdtxh1.png",
    "numberOfComments": 1860,
    "flair": "OC",
    "upVotes": 3941,
    "upVoteRatio": 0.8656,
    "isVideo": false,
    "isAd": false,
    "over18": false,
    "imageUrls": ["https://i.redd.it/k7aa10ftdtxh1.png"],
    "postType": "image",
    "createdAt": "2026-10-26T13:35:22.659Z",
    "scrapedAt": "2026-11-08T14:00:00Z"
}
```

```json
{
    "dataType": "comment",
    "id": "t1_19sbixv8nzseb",
    "url": "https://www.reddit.com/r/Python/comments/1xqknnl/comment/19sbixv8nzseb/",
    "username": "q-rka",
    "body": "Looks cool.",
    "postId": "t3_1xqknnl",
    "parentId": "t1_19sbawggy3on6",
    "depth": 1,
    "numberOfReplies": 1,
    "upVotes": 2,
    "createdAt": "2026-11-08T09:27:53.359Z"
}
```

#### What can I do with Reddit data?

- 📣 **Brand monitoring**: new posts and comments that mention you or competitors, every day
- 🧪 **Market research from subreddits**: what people ask, praise and complain about in your niche
- 🎯 **Lead finding**: posts from people asking for a tool or service like yours
- 🏘️ **Community analysis**: weekly visitors and contributions per subreddit, to pick where to post
- 💭 **Sentiment analysis**: score, upvote ratio and comment text per post for opinion tracking
- 🤖 **LLM training data**: threads with replies, depth and parent for RAG and fine-tuning

#### ⚠️ Good to know

- **Comments** come in reading order (as on the post page, best first) with replies, up to **Max comments per post**.
- **Search results** are enriched from the post page (text, upvote ratio) unless **Skip comments** is on; with Skip comments they have the search card fields only (title, author, subreddit, score, comments, date).
- **Communities** show weekly visitors and contributions; Reddit no longer shows subscriber counts to visitors.
- **Not included**: private or quarantined communities, comment search and user comment history.

#### Frequently asked questions

#### Can I switch from Reddit Scraper Lite?

Yes. The input fields (`startUrls`, `searches`, `searchCommunityName`, `searchPosts`, `searchCommunities`, `sort`, `time`, `includeNSFW`, `maxItems`, `maxPostCount`, `maxComments`, `maxCommunitiesCount`, `skipComments`, `skipUserPosts`, `skipCommunity`, `postDateLimit`, `commentDateLimit`, `ignoreStartUrls`) and the output keys are the same. Extra fields: `postType`, `depth`, `weeklyVisitors`, `weeklyContributions`.

#### Can I use it with the Apify API?

Yes. Python:

```python
from apify_client import ApifyClient

client = ApifyClient("<YOUR_APIFY_TOKEN>")
run = client.actor("carabain-digital/reddit-scraper").call(run_input={"searches": ["your brand"], "sort": "new", "maxPostCount": 50})
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item["dataType"], item["upVotes"], (item["title"] or item["body"] or "")[:80])
```

JavaScript:

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

const client = new ApifyClient({ token: '<YOUR_APIFY_TOKEN>' });
const run = await client.actor('carabain-digital/reddit-scraper').call({
    startUrls: [{ url: 'https://www.reddit.com/r/selfhosted/top/?t=month' }], skipComments: true,
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items.length, 'posts');
```

#### Can I call it as a real-time API?

Yes. This Actor also runs as a **Server Actor**: send an HTTP request and get the results back in the response, no run to start or dataset to fetch. Handy for the newest Reddit posts about a keyword inside your own app. Pass the same fields as the normal input, in the query string (repeat a key for a list) or as a JSON body:

```bash
curl "https://carabain-digital--reddit-scraper.apify.actor/?searches=apify&maxItems=20&skipComments=true" \
  -H "Authorization: Bearer <YOUR_APIFY_TOKEN>"
```

The response is a JSON array of the same items a normal run returns, billed the same way. Errors come back as `{"error": ..., "message": ...}` with status 400 (invalid input) or 502 (the site blocked the request). The first request after a pause takes a few seconds longer while the server starts. See the **Server** tab for details.

#### Can I use it through an MCP server or with AI agents?

Yes. Add it to an AI agent through the [Apify MCP server](https://mcp.apify.com) (`https://mcp.apify.com?tools=carabain-digital/reddit-scraper`). Example prompt: *"Use Reddit Scraper to find this week's top posts in r/homeassistant and summarise the main complaints."*

#### Is it legal to scrape Reddit?

The Actor reads pages that anyone can see without logging in. Posts and comments contain usernames, which can be personal data under GDPR; only collect what you need and have a legal basis for it. Check Reddit's terms for your use case. More background: [Is web scraping legal?](https://blog.apify.com/is-web-scraping-legal/)

#### Not working? Feedback

Open an issue on the **Issues** tab with the run link and we will look at it. Ideas are welcome there too.

#### Other scrapers by us

| Actor | Covers |
|---|---|
| [Google Trends Scraper](https://apify.com/carabain-digital/google-trends) | Search interest over time, by region, related queries, Trending now |
| [Tripadvisor Reviews](https://apify.com/carabain-digital/tripadvisor-reviews) | Hotel, restaurant and attraction reviews |

⭐ **Does it work well for you?** A review on the Store page helps others find this Actor and helps us keep it maintained.

# Actor input Schema

## `startUrls` (type: `array`):

Subreddits (`/r/python/`, `/r/python/new/`, `/r/python/top/?t=week`), posts (`/r/.../comments/<id>/...`), users (`/user/<name>/`) or search pages (`/search/?q=...`).

## `searches` (type: `array`):

Search Reddit for these terms (posts, and communities if enabled below). One term per line.

## `searchCommunityName` (type: `string`):

Only search inside this subreddit, e.g. `programming`.

## `searchPosts` (type: `boolean`):

Return posts that match the search terms.

## `searchCommunities` (type: `boolean`):

Also return communities (subreddits) that match the search terms.

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

Order of search results.

## `time` (type: `string`):

For search and for top subreddit feeds.

## `maxItems` (type: `integer`):

Maximum items (posts, comments and communities together) in the dataset. 0 = no limit.

## `maxPostCount` (type: `integer`):

Posts per subreddit, user, search term or search URL.

## `maxComments` (type: `integer`):

Comments per post (in reading order, replies included). 0 = no comments.

## `maxCommunitiesCount` (type: `integer`):

Communities per search term when Search for communities is on.

## `skipComments` (type: `boolean`):

Don't scrape comments (faster: posts come straight from the feed).

## `skipUserPosts` (type: `boolean`):

Ignore user profile URLs.

## `skipCommunity` (type: `boolean`):

Don't add a community item (name, description, weekly visitors) for subreddit URLs.

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

Include posts marked NSFW (18+).

## `postDateLimit` (type: `string`):

Only posts created on or after this day, YYYY-MM-DD.

## `commentDateLimit` (type: `string`):

Only comments created on or after this day, YYYY-MM-DD.

## `ignoreStartUrls` (type: `boolean`):

Ignore Reddit URLs and only run the searches (for Zapier/Make setups).

## `proxyConfiguration` (type: `object`):

Keep the default: the Actor uses its own residential proxy (included in the price). Reddit blocks datacenter IPs.

## Actor input object example

```json
{
  "startUrls": [
    {
      "url": "https://www.reddit.com/r/dataisbeautiful/top/?t=week"
    }
  ],
  "searchPosts": true,
  "searchCommunities": false,
  "sort": "new",
  "time": "all",
  "maxItems": 50,
  "maxPostCount": 10,
  "maxComments": 10,
  "maxCommunitiesCount": 2,
  "skipComments": false,
  "skipUserPosts": false,
  "skipCommunity": false,
  "includeNSFW": true,
  "ignoreStartUrls": false,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

## `items` (type: `string`):

All scraped items; filter on dataType.

# 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 = {
    "startUrls": [
        {
            "url": "https://www.reddit.com/r/dataisbeautiful/top/?t=week"
        }
    ],
    "maxItems": 50,
    "maxPostCount": 10,
    "maxComments": 10,
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("carabain-digital/reddit-scraper").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 = {
    "startUrls": [{ "url": "https://www.reddit.com/r/dataisbeautiful/top/?t=week" }],
    "maxItems": 50,
    "maxPostCount": 10,
    "maxComments": 10,
    "proxyConfiguration": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("carabain-digital/reddit-scraper").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 '{
  "startUrls": [
    {
      "url": "https://www.reddit.com/r/dataisbeautiful/top/?t=week"
    }
  ],
  "maxItems": 50,
  "maxPostCount": 10,
  "maxComments": 10,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}' |
apify call carabain-digital/reddit-scraper --silent --output-dataset

```

## MCP server setup

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

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/hdChAdmrnuLJQbRVI/builds/fRUUPj8VTG8lIKPzw/openapi.json
