# Reddit Scraper – Subreddit Posts, Comments & Keyword Monitor (`rowfeed/reddit-scraper`) Actor

Watch any public subreddit: new, hot, top and rising posts and the newest comments as clean rows with title, text, link and date, filtered by your keywords. No usernames. $0.50 per 1,000 rows + $0.003 per feed.

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

## Pricing

from $0.50 / 1,000 rows

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

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 – Subreddit Posts, Comments & Keyword Monitor

Watch any public subreddit and get its posts and newest comments as clean rows: title, text, subreddit, link, the external link of link posts, and the date. Add keywords to keep only the posts and comments that mention your brand, a competitor or a topic. Read straight from Reddit's own public feeds, with no login and no account.

Built for brand and product monitoring in the communities that matter to you, market and content research, lead discovery in niche subreddits, and AI agents that need what people are saying right now.

### What you get

- **Posts:** the newest, hot, top (past hour to all time) or rising posts of each subreddit.
- **Comments:** the newest comments across the whole subreddit, with the title and link of the post they belong to.
- **Keywords:** keep only rows that mention one of your keywords, and see which ones in `matched`. Short words match whole words, so "ai" does not match "said".
- **Monitoring:** set "Only the last ... hours" to 24 and schedule the run daily (or 1 and hourly) to get only what is new.
- **Clean text:** HTML removed, link posts get their external link, image posts their preview image.
- **Privacy by default:** no usernames unless you turn on `includeAuthor`, which adds the poster's public `u/name`. `u/name` mentions and email addresses inside the text always become `[user]` and `[email removed]`.

### Example output rows

A real post (text shortened here):

```json
{
  "type": "post",
  "id": "1xrr5qa",
  "subreddit": "webscraping",
  "title": "Need help with Chrome Web Scraper",
  "post_title": null,
  "text": "I am doing a project for uni that is supposed to be very basic. I want to gather 5k records from Metacritic with Web Scraper. …",
  "url": "https://www.reddit.com/r/webscraping/comments/1xrr5qa/need_help_with_chrome_web_scraper/",
  "post_url": "https://www.reddit.com/r/webscraping/comments/1xrr5qa/need_help_with_chrome_web_scraper/",
  "link": null,
  "image": null,
  "published": "2026-11-09T13:05:25Z",
  "source": "r/webscraping new"
}
```

A real comment:

```json
{
  "type": "comment",
  "id": "19sgxfvcm8krp",
  "subreddit": "webscraping",
  "title": null,
  "post_title": "Claude Code refusing to build scraper. Any way around this?",
  "text": "For real, I need it",
  "url": "https://www.reddit.com/r/webscraping/comments/1wzf7jo/claude_code_refusing_to_build_scraper_any_way/19sgxfvcm8krp/",
  "post_url": "https://www.reddit.com/r/webscraping/comments/1wzf7jo/claude_code_refusing_to_build_scraper_any_way/",
  "published": "2026-11-11T10:08:36Z",
  "source": "r/webscraping comments"
}
```

### How to use

1. Click **Try for free** (or **Start**) at the top of this page to open the input form.
2. Fill in **Subreddits**. Public subreddits, one per line: r/SEO, SEO or a subreddit link. The form comes with a working example, so you can also run it as it is.
3. Optional: adjust **Keywords (optional)**, **Read from subreddits**, **Only the last ... hours**, **Max rows**. Every field has a sensible default.
4. Click **Start** and wait for the run to finish.
5. Download the results as Excel, CSV or JSON from the **Output** tab, or get them through the Apify API, a schedule or an integration (Make, Zapier, Google Sheets ...).

### Pricing

Pay per event, no subscription:

- **$0.50 per 1,000 rows** ($0.0005 per post or comment).
- $0.003 per feed read (one subreddit's posts or comments, up to 100 rows).
- $0.003 per run start.

Examples: the pre-filled run (r/webscraping, up to 100 posts) costs at most $0.056. Five subreddits' newest posts (500 rows) cost $0.268. A daily monitor of 10 subreddits for your brand that finds 5 mentions costs $0.036 a day. Error rows, skipped feeds and feeds Reddit refuses are never charged.

### Input

| Field | What it does |
|---|---|
| `subreddits` | `r/SEO`, `SEO` or a subreddit link, one per line. |
| `searches` | Optional keywords. Only rows that mention one of them are kept. |
| `include` | `posts`, `comments` or `both`. |
| `postedWithinHours` | Only rows from the last N hours. 0 = any time. |
| `maxResults` | Stop after this many rows (default 500, up to 5,000). |
| `sort` | `new`, `hot`, `top` or `rising` for posts. |
| `timeRange` | `hour`, `day`, `week`, `month`, `year` or `all`, for top. |
| `includeAuthor` | Add the poster's public username (off by default). |

Each subreddit is one feed for posts and one for comments. One run reads up to 20 feeds.

### Good to know

- **Subreddits, not all of Reddit:** Reddit does not let servers use its site-wide search, so keywords filter the subreddits you list. List the communities where your topic is discussed.
- **Speed:** Reddit allows about one feed a minute per server, and this Actor waits for it instead of working around it. A run with 5 feeds takes about 5 minutes. Schedules suit it well.
- **Up to 100 rows per feed** (Reddit's feed size): the newest 100 posts or comments, or the top 100 for the time range. For busy subreddits, run more often with "Only the last ... hours".
- **No votes or comment counts:** Reddit's public feeds do not include them. You get the content, the link and the date.
- Private, banned and quarantined subreddits cannot be read; they get an error row (not charged).
- **Usernames are personal data** in many countries. If you turn on `includeAuthor`, use them lawfully (for example under GDPR).
- Not affiliated with Reddit.

### More tools from Rowfeed

- [Bluesky Scraper](https://apify.com/rowfeed/bluesky-scraper) – search all of Bluesky by keyword or hashtag, or get any account's posts, with likes and reposts, without author names.
- [Telegram Scraper](https://apify.com/rowfeed/telegram-channel-scraper) – posts, views and reactions of any public Telegram channel, with keyword search inside channels.
- [Hacker News API](https://apify.com/rowfeed/hacker-news-api) – Hacker News stories, front page, Ask/Show HN and the monthly hiring thread as rows.
- [Google News API](https://apify.com/rowfeed/google-news-monitor) – news for any search; monitor mode returns only articles you have not seen.
- [RSS Feed Reader](https://apify.com/rowfeed/rss-feed-reader) – any RSS or Atom feed as clean JSON rows.
- [Google Sheets Export](https://apify.com/rowfeed/google-sheets-export) – send the results of any run to a Google Sheet.
- [Brand Mentions Monitoring](https://apify.com/rowfeed/brand-mentions-monitor) – web pages that mention your brand, with date, sentiment and site strength.

# Actor input Schema

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

Public subreddits, one per line: r/SEO, SEO or a subreddit link. Empty form = r/webscraping as an example.

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

Only keep posts and comments that mention one of these, e.g. your brand or a competitor. Short words match whole words. Empty = keep everything.

## `include` (type: `string`):

Posts, the newest comments across the whole subreddit, or both. Each is one feed per subreddit.

## `postedWithinHours` (type: `integer`):

Only posts and comments from this many hours, e.g. 24 for a daily schedule. 0 = any time.

## `maxResults` (type: `integer`):

Stop after this many rows. Each feed gives up to 100.

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

Newest first suits monitoring. Only for posts; comments are always newest first.

## `timeRange` (type: `string`):

Used with Top.

## `includeAuthor` (type: `boolean`):

Off by default. On = add the poster's public Reddit username (u/name). You are responsible for using it lawfully (e.g. GDPR).

## Actor input object example

```json
{
  "subreddits": [
    "r/SEO",
    "webscraping",
    "https://www.reddit.com/r/bigseo/"
  ],
  "searches": [
    "backlinks",
    "apify",
    "seo tool"
  ],
  "include": "posts",
  "postedWithinHours": 0,
  "maxResults": 500,
  "sort": "new",
  "timeRange": "week",
  "includeAuthor": false
}
```

# Actor output Schema

## `results` (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 = {
    "subreddits": [
        "r/webscraping"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("rowfeed/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 = { "subreddits": ["r/webscraping"] }

# Run the Actor and wait for it to finish
run = client.actor("rowfeed/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 '{
  "subreddits": [
    "r/webscraping"
  ]
}' |
apify call rowfeed/reddit-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,rowfeed/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/0aMs66vqSFEhkTdBd/builds/ruH5TkZIsLPhyodXH/openapi.json
