# Reddit Posts & Comments Scraper - Search, Upvotes, Awards (`om_kh/reddit-posts-comments-scraper`) Actor

Search all of Reddit for any keyword or brand: post title, body, link, subreddit, author and flair, upvotes, upvote ratio, comments, awards, media and date, plus optional comments. Export to JSON, CSV or Excel, or use the API, n8n or Make. Our fee $10 per 1,000 posts + supplier.

- **URL**: https://apify.com/om_kh/reddit-posts-comments-scraper.md
- **Developed by:** [Khandji Omar](https://apify.com/om_kh) (community)
- **Categories:** Social media, Lead generation, AI
- **Features:** Limited permissions
- **Stats:** 1 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $150.00 / 1,000 monitored subject re-checkeds

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 Posts & Comments Scraper — Search, Upvotes, Awards

> Search all of Reddit for any keyword or brand: post title, body, link, subreddit, author and flair, upvotes, upvote ratio, comments, awards, media and date, plus optional comments. Export to JSON, CSV or Excel, or use the API, n8n or Make. No login or Reddit API key.

### In short: what you give, what you get, what it costs

| | |
|---|---|
| **You give** | Keywords or brand names |
| **We do** | Search all of Reddit, and optionally read the comments |
| **You get** | One row per post: title, text, link, subreddit, author, upvotes, upvote ratio, comments, awards, media and date, plus sentiment, topic and our free lead score (asks for a tool, complains, talks price), plus every field the supplier returns (`source_data`) |
| **It costs** | $10 per 1,000 posts, **$9 from 21 November 2026**, no start fee. Optional scheduled monitoring: +$0.15 per check (one-off runs never pay it). Apify also bills the supplier Actor `fatihtahta/reddit-scraper-search-fast` that this robot runs for you, at its own price (about $1.49 per 1,000 rows; if it is down, the backup `automation-lab/reddit-scraper` runs instead, about $1.15 per 1,000 posts + $0.003 per run). The first 10 results of every run are free of this robot's fee. |
| **It does not** | Need a Reddit API key, sign in, or post for you |

A real result row is shown further down this page.

### Posts and comments

Set **`includeComments`** to get Reddit comments alongside posts — the replies
are usually where the opinion is, and a brand mention buried in a comment thread
is invisible to a posts-only scraper.

Each post brings at most 2 comments, and a comment is billed like a post (this robot's fee
and the supplier's). Off by default.

### What we add on top of the supplier

- **A backup supplier.** This robot reads Reddit through `fatihtahta/reddit-scraper-search-fast`. If it fails or returns nothing, `automation-lab/reddit-scraper` runs instead, in the same run. On 4 November 2026 the old supplier went down; this is why you no longer get an empty dataset when one supplier breaks. The `served_by` field says which one answered.
- **Lead signals, free.** Every row gets `buying_intent`, `complaint`, `mentions_price`, `is_question` and a `lead_score` from 0 to 100, with `lead_reasons` listing the exact words that set each flag. Sort by `lead_score` to find the posts worth answering first.
- **Sentiment and topic** on every post and comment (`sentiment_label`, `content_category_label`), sent by the supplier at no extra cost.
- **Only what is new.** With `monitorEnabled` on, each scheduled run returns and bills only the posts you have not seen yet, and flags a sudden jump in activity.

### Free tier — 10 results free on every run

The free results waive this Actor's own fee; the source Actor (fatihtahta/reddit-scraper-search-fast, or the backup automation-lab/reddit-scraper) still bills its own price for every row it returns.

**The first 10 results of every run are free**, on every run you ever make —
not a one-off trial. Run it on your own subjects and see the real output before
you are billed for a single result.

One guard: the free allowance never covers more than half of a run, so a run
returning 6 results gets 3 free. That keeps the offer sustainable.

### What it does

Run it once and get the full, current data as clean rows you can export to JSON, CSV or Excel, or pull through the API. Need only fresh data? Turn on `monitorEnabled` and schedule it: every later run returns only what is new or changed since the previous one, so you never re-download or re-pay for the same rows.

### Compared with clearpath/reddit-post-comments-bulk-scraper

Read on the Store on 2026-10-23 (Reddit Post Comments Scraper | Bulk Thread & Reply Export). Where it does better, this section says so.

- **Data source:** this Actor runs fatihtahta/reddit-scraper-search-fast for you (automation-lab/reddit-scraper if it is down), then cleans every row and adds lead signals.
- **This Actor's fee is free on the first results of every run**, and a hard cost cap (`maxTotalChargeUsd`) limits it.
- **Price:** about $11.49 per 1,000 in total here ($10 for this Actor + $1.49 for fatihtahta/reddit-scraper-search-fast), $2.99 at clearpath/reddit-post-comments-bulk-scraper.

### Why this scraper

1. **Try before you pay.** The first 10 results of every run are free, on every run.
2. **Pay only for data delivered.** Failed sources and failed inputs are never billed.
3. **Cost cap on this Actor's fee.** Set `maxTotalChargeUsd` to cap this Actor's own fee; the supplier Actor is capped separately on every call, at its own price.
4. **Only-new mode.** With `monitorEnabled` on a schedule, you get just the new or changed rows, plus a spike signal when volume suddenly jumps.
5. **Clean, normalized rows** with the same field names every run, plus a `RUN_SUMMARY.json` — ready for spreadsheets, databases, n8n/Make/Zapier and AI agents (MCP).

### Example input

```json
{
  "keywords": [
    "notion",
    "airtable"
  ],
  "maxTotalChargeUsd": 1.0
}
```

This returns the full current data right away. To receive only what is new on a schedule, add `"monitorEnabled": true`: the first monitored run stores a free baseline, later runs return only new or changed rows. Pin a `monitorId` to keep separate targets from sharing state.

### Output

Each row is **one Reddit post or comment**.

A real row from a test run on Apify (2026-11-04; long texts are cut and people's names hidden here, your dataset has them in full):

```json
{
  "record_id": "1xngm90",
  "query_id": "notion",
  "title": "Notion Calendar finally has an iPad app",
  "url": "https://www.reddit.com/r/Notion/comments/1xngm90/notion_calendar_finally_has_an_ipad_app/",
  "text": "https://preview.redd.it/v5mrjaxlcjzh1.png?width=480&format=png&auto=webp&s=fbafcefabba85e9125197a...",
  "author": "(hidden)",
  "published_at": "2026-11-04T06:01:24.000Z",
  "score": 2,
  "kind": "post",
  "sentiment_label": "neutral",
  "sentiment_confidence": 0.39,
  "sentiment_score_normalized": 0.37,
  "content_category_label": "Computer Software and Applications",
  "content_category_path": [
    "Technology & Computing",
    "Computing",
    "Computer Software and Applications"
  ],
  "content_category_confidence": 0.94,
  "content_category_match_type": "multi_signal",
  "upvote_ratio": 1,
  "num_comments": 0,
  "subreddit": "Notion",
  "permalink": "/r/Notion/comments/1xngm90/notion_calendar_finally_has_an_ipad_app/",
  "old_reddit_url": "https://old.reddit.com/r/Notion/comments/1xngm90/notion_calendar_finally_has_an_ipad_app/",
  "flair": "Notion Calendar",
  "over_18": false,
  "is_self": true,
  "is_video": false,
  "is_gallery": false,
  "domain": "self",
  "subreddit_id": "t5_hds7r",
  "subreddit_name_prefixed": "r/Notion",
  "age_hours": 0.0605,
  "retrieved_at": "2026-11-04T06:05:01.858Z",
  "media_type": "text",
  "has_media": false,
  "gallery_count": 0,
  "title_length": 39,
  "body_length": 254,
  "word_count": 36,
  "score_per_hour": 33.0579,
  "comments_per_hour": 0,
  "is_deleted_or_removed": false,
  "comment_to_score_ratio": 0,
  "is_high_engagement": false,
  "total_awards_received": 0,
  "author_fullname": "(hidden)",
  "served_by": "fatihtahta/reddit-scraper-search-fast",
  "buying_intent": false,
  "complaint": false,
  "mentions_price": false,
  "is_question": false,
  "lead_score": 0
}
```

| Field | What it holds |
|---|---|
| `title` | post title (empty on a comment) |
| `text` | post or comment text |
| `subreddit` | subreddit name |
| `kind` | post or comment |
| `author` | Reddit username |
| `published_at` | post time (UTC) |
| `score` | upvotes minus downvotes |
| `num_comments` | number of comments |
| `sentiment_label` | positive, negative, neutral, mixed or uncertain (from the supplier) |
| `lead_score` | added by us: 0-100, how much this post is worth answering |
| `buying_intent` | added by us: the post asks for a tool, a recommendation or an alternative |
| `url` | link to the post or comment |

Each row also keeps the other fields the source returns, so you get everything above and more. In the **Output** tab, the **Overview** table shows these columns, readable without any code; export them as CSV, Excel, JSON or HTML.

#### Every field

| Field | What it holds |
|---|---|
| `record_id` | stable ID of the row (used for new-only delivery) |
| `query_id` | the keyword, subreddit or user this row belongs to |
| `title` | post title (empty on a comment) |
| `url` | link to the post or comment |
| `text` | post or comment text |
| `author` | Reddit username |
| `published_at` | post time (UTC) |
| `score` | upvotes minus downvotes |
| `kind` | post or comment |
| `subreddit` | subreddit name |
| `num_comments` | number of comments |
| `upvote_ratio` | share of upvotes |
| `flair` | post flair |
| `sentiment_label` | positive, negative, neutral, mixed or uncertain (from the supplier) |
| `sentiment_score` | sentiment strength (from the supplier) |
| `content_category_label` | topic of the post (from the supplier) |
| `served_by` | which supplier answered (the backup runs only if the first is down or empty) |
| `buying_intent` | added by us: the post asks for a tool, a recommendation or an alternative |
| `complaint` | added by us: the post complains (broken, refund, cancel, frustrated...) |
| `mentions_price` | added by us: the post talks about money or pricing |
| `is_question` | added by us: the post is a question |
| `lead_score` | added by us: 0-100, how much this post is worth answering |
| `lead_reasons` | added by us: the words that set each flag |
| `score_per_hour` | upvotes per hour since posting |
| `comments_per_hour` | comments per hour since posting |
| `age_hours` | hours since posting |
| `is_high_engagement` | true when the post is getting unusual attention |
| `postId` | the post a comment belongs to |
| `parentId` | the comment or post this one answers |
| `depth` | reply depth of a comment |
| `sentiment_confidence` | sentiment confidence |
| `sentiment_score_normalized` | sentiment score normalized |
| `content_category_path` | content category path |
| `content_category_confidence` | content category confidence |
| `content_category_match_type` | content category match type |
| `permalink` | permalink |
| `old_reddit_url` | old reddit url |
| `over_18` | over 18 |
| `is_self` | is self |
| `is_video` | is video |
| `is_gallery` | is gallery |
| `domain` | domain |
| `subreddit_id` | subreddit id |
| `subreddit_name_prefixed` | subreddit name prefixed |
| `retrieved_at` | retrieved at |
| `media_type` | media type |
| `has_media` | has media |
| `gallery_count` | gallery count |
| `title_length` | title length |
| `body_length` | body length |
| `word_count` | word count |
| `is_deleted_or_removed` | is deleted or removed |
| `comment_to_score_ratio` | comment to score ratio |
| `total_awards_received` | total awards received |
| `author_fullname` | author fullname |
| `engagement_total` | engagement total |
| `postUrl` | postUrl |
| `parent_kind` | parent kind |
| `source_data` | every field fatihtahta/reddit-scraper-search-fast returns for this row, untouched |

Each row also carries `source_data`: the full row returned by [fatihtahta/reddit-scraper-search-fast](https://apify.com/fatihtahta/reddit-scraper-search-fast), every field it gives, untouched — you never get less than the supplier itself delivers. Our own fields above stay exactly as they are. A row over 200 KB is trimmed and `source_data_trimmed` lists the fields cut.

### How you're charged

- **Source Actor charge:** this Actor runs [fatihtahta/reddit-scraper-search-fast](https://apify.com/fatihtahta/reddit-scraper-search-fast) inside your run, and Apify bills that run to your account at its own price (about $1.49 per 1,000 rows, no start fee, read on 2026-11-04). If it fails or returns nothing, the backup [automation-lab/reddit-scraper](https://apify.com/automation-lab/reddit-scraper) runs instead (about $1.15 per 1,000 posts + $0.003 per run; its empty runs are free), on top of this Actor's price. Each call to it is capped at $0.50.
- **Result** — **$0.01 per post or comment** from 22 October 2026 (free before that date), billed only for results delivered to your dataset. With monitoring on, only results that are new since the last check are delivered and billed.
- **Monitoring check** ($0.15) — only when you turn on scheduled monitoring (`monitorEnabled`), once per target per run, and only when the source responded. **One-off runs never pay it**: you pay only per result.
- **One-off runs pay only per result.** The monitoring check applies only to scheduled monitoring; every call to the supplier Actor is capped per call, at its own price, and `maxTotalChargeUsd` caps this Actor's own fee.

### Related tools

- Already know which subreddit to watch? → [Reddit Subreddit Scraper - Posts, Comments, Upvote Count](https://apify.com/om_kh/reddit-subreddit-scraper)
- Tracking one specific account instead of a keyword? → [Reddit User Scraper - Posts, Upvotes, Subreddits](https://apify.com/om_kh/reddit-user-scraper)

### How to use it in 3 steps

1. Click **Try for free** and fill in **Reddit search keywords** (`keywords`).
2. Optional: adjust the other fields; every one has a description and a sensible default.
3. Click **Start** and download the results as JSON, CSV or Excel, or read them from the API.

### Use cases

- **Brand mentions**
- **Market research**
- **AI datasets**

### Use it from code (API)

Every Apify Actor is an API. Start a run and read the results with one call.

**Python**

```python
from apify_client import ApifyClient

client = ApifyClient("<YOUR_APIFY_TOKEN>")
run = client.actor("om_kh/reddit-posts-comments-scraper").call(run_input={"keywords": ["notion", "airtable"], "includeComments": False})
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)
```

**JavaScript**

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

const client = new ApifyClient({ token: '<YOUR_APIFY_TOKEN>' });
const run = await client.actor('om_kh/reddit-posts-comments-scraper').call({
    "keywords": [
        "notion",
        "airtable"
    ],
    "includeComments": false
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);
```

**One HTTP call (cURL)** — runs the Actor and returns the dataset in the same response:

```bash
curl -X POST "https://api.apify.com/v2/acts/om_kh~reddit-posts-comments-scraper/run-sync-get-dataset-items?token=<YOUR_APIFY_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"keywords": ["notion", "airtable"], "includeComments": false}'
```

### Integrations: n8n, Make, Zapier, Google Sheets

- **n8n** — the official *Apify* node, operation *Run Actor and get dataset*, Actor `om_kh/reddit-posts-comments-scraper`.
- **Make** — *Apify › Run an Actor*, then *Apify › Get Dataset Items*.
- **Zapier** — *Apify › Run Actor*; map the dataset items into your next step.
- **Google Sheets, webhooks, Slack** — add an integration from the *Integrations* tab of this Actor.
- **Schedules** — run it every hour or day from *Schedules* in Apify Console.

### Use it from an AI agent (MCP and x402)

Connect Claude Desktop, Cursor, VS Code or any MCP client to Apify's MCP server
at `https://mcp.apify.com` and add this Actor, `om_kh/reddit-posts-comments-scraper`, as a tool — the
agent passes the same JSON as the run input and gets the dataset back.

AI agents that pay with **x402** can run it too, without an Apify account: the
Actor charges only per result delivered, so an agent pays exactly for what it gets.

### FAQ

**Is it legal to scrape Reddit?**
This Actor collects only publicly available Reddit data and never logs in. You are responsible for how you use it; check Reddit's terms and your local law (GDPR, CCPA) if you store personal data, and ask a lawyer if unsure.

**Do I need an account, cookies or an API key?**
No. You only need an Apify account to run it.

**What data do I get?**
Posts and comments with text, subreddit, score and date. Download it as JSON, CSV, Excel, HTML or XML, or read it from the API.

**Am I charged when something fails?**
No. An input that fails is listed with its reason in the run summary and is never charged.

**Can I run it on a schedule?**
Yes. Create a schedule in Apify Console (hourly, daily, weekly) and connect webhooks, Google Sheets, Slack, n8n, Make or Zapier.

**Can I use it from Python, JavaScript or an AI agent?**
Yes: see the code samples above, or connect AI agents through MCP with the `reddit_new_mentions` tool.

### All input fields

The main fields are described above; these are the others the form accepts:

- **`currentItems`** (Bring your own items (optional)) — Skip the chained fetch and pass records directly (no upstream call, no fetch fee).

### Your feedback

Did this Actor save you time? A short review on the **Reviews** tab helps other people find it, and every review is read. Something missing or broken? Open an issue on the **Issues** tab: it is answered and fixed fast.

### More Actors from the same author

- [Instagram Following & Related Profiles Scraper - Full List](https://apify.com/om_kh/instagram-following-scraper)
- [X (Twitter) Search Scraper - Posts, Likes, Replies](https://apify.com/om_kh/twitter-x-search-scraper)
- [Facebook Page Posts Scraper - Likes, Comments, Date](https://apify.com/om_kh/facebook-page-posts-scraper)
- [Twitch Clips Scraper - Clips, View Counts, Creator Names](https://apify.com/om_kh/twitch-clips-scraper)

# Actor input Schema

## `keywords` (type: `array`):

Brand, product, or competitor keywords to monitor across Reddit posts.

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

Return Reddit comments as well as posts. Comments share the same 15-item budget as posts, so a run with comments on returns fewer posts - and costs exactly the same.

## `currentItems` (type: `array`):

Skip the chained fetch and pass records directly (no upstream call, no fetch fee).

## `maxTotalChargeUsd` (type: `number`):

Hard maximum amount that this run may charge.

## `sources` (type: `array`):

Declare every upstream source before this run. Each item needs name, authorization, and estimated_cost_usd.

## `monitorEnabled` (type: `boolean`):

The first monitored run stores a free baseline. Later runs deliver and charge only new results.

## `monitorId` (type: `string`):

Pins the persistent baseline to a name of your choice, so separate targets never share state. Leave empty to derive it automatically.

## Actor input object example

```json
{
  "keywords": [
    "notion",
    "airtable"
  ],
  "includeComments": false,
  "currentItems": [],
  "sources": [
    {
      "name": "Chained upstream actor",
      "authorization": "public_structured_data",
      "estimated_cost_usd": 0
    }
  ],
  "monitorEnabled": false,
  "monitorId": ""
}
```

# Actor output Schema

## `report` (type: `string`):

A visual summary of delivery, charges, changes, and source issues.

## `results` (type: `string`):

Business-ready results in a sortable table. No JSON knowledge required.

## `csv` (type: `string`):

Results ready for spreadsheets, CRMs, and analytics tools.

## `excel` (type: `string`):

Results as an Excel workbook for non-technical teams.

## `runSummary` (type: `string`):

Machine-readable delivery, billing, and source diagnostics.

# 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 = {
    "keywords": [
        "notion",
        "airtable"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("om_kh/reddit-posts-comments-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 = { "keywords": [
        "notion",
        "airtable",
    ] }

# Run the Actor and wait for it to finish
run = client.actor("om_kh/reddit-posts-comments-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 '{
  "keywords": [
    "notion",
    "airtable"
  ]
}' |
apify call om_kh/reddit-posts-comments-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,om_kh/reddit-posts-comments-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/1Y8cR5usTRXzoWCz9/builds/lesNnvT1nDo1tHzh4/openapi.json