# Reddit Search & Brand Monitoring: Posts & Comments (`deepmine/reddit-search-scraper`) Actor

Search all of Reddit for any keyword, brand or competitor, no login: matching posts with title, text, score, comment count, subreddit and author, or the comments that mention your words. Relevance, new or top, any period, all of Reddit or one subreddit. Schedule it to catch new mentions daily.

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

## Pricing

from $0.39 / 1,000 results

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

### What does Reddit Search & Brand Monitoring do?

It searches all of Reddit for your keywords, brand names or competitors and returns every matching post (title, full text, score, upvote ratio, comment count, subreddit, author, flair, media) or every comment that uses your words. Sort by relevance, new, top or most comments, pick any period from the past hour to all time, search all of Reddit or one subreddit, and run it on a schedule to catch new mentions. No login, no browser, no cookies.

These are real rows from the prefilled run (searches "Shopify" and "WooCommerce", relevance, past week, 50 posts each):

| Post | Subreddit | Score | Comments | Posted |
|---|---|---:|---:|---|
| [Shopify put a 10% reserve on my payouts](https://www.reddit.com/r/shopify/comments/1wteprb/shopify_put_a_10_reserve_on_my_payouts/) | r/shopify | 0 | 67 | 2026-09-29 |
| [Selling on both Etsy & Shopify?](https://www.reddit.com/r/EtsySellers/comments/1wwa1k4/selling_on_both_etsy_shopify/) | r/EtsySellers | 16 | 45 | 2026-10-03 |
| [Mailchimp alternatives for a larger Shopify store](https://www.reddit.com/r/ShopifyeCommerce/comments/1wt7sjq/mailchimp_alternatives_for_a_larger_shopify_store/) | r/ShopifyeCommerce | 18 | 34 | 2026-09-29 |
| [Best alternative to Shopify for a small business website that doesn...](https://www.reddit.com/r/smallbusiness/comments/1wu6sfw/best_alternative_to_shopify_for_a_small_business/) | r/smallbusiness | 3 | 34 | 2026-09-30 |
| [High-traffic WooCommerce: disable WP-Cron and switch to real server...](https://www.reddit.com/r/woocommerce/comments/1wwn3bu/hightraffic_woocommerce_disable_wpcron_and_switch/) | r/woocommerce | 6 | 26 | 2026-10-03 |

<sub>$0.49 per 1,000 results on Starter ($0.59 Free, $0.45 Scale, $0.39 Business). The prefilled run (100 posts) costs about $0.05. No start fee. Collected 2026-10-06.</sub>

### What can you search on Reddit with it?

- **Posts** that match your words, all of Reddit or one subreddit, in Reddit's sorts: Relevance, New, Top, Most comments, Hot.
- **Comments** that use your words anywhere on Reddit (set **Search for** to Comments): each with its author, score, time, post and subreddit. This is how most brand mentions happen, inside other people's threads.
- **Communities** (with their rules, weekly visitors and contributions) and **users** that match a word.
- **The comments of the posts found**, if you want the whole conversation (**Include comments**).
- **Reddit search links** you already have (reddit.com/search/?q=...): each keeps its own sort, period and type.

### Use cases

- **Brand monitoring**: what people say about your product this week, in posts and in comments, with scores to see what took off.
- **Competitor research**: complaints and praise for a rival ("Shopify reserve", "alternative to Mailchimp") straight from users.
- **Lead generation**: people asking for a tool like yours ("best CRM for startups", "looking for a Shopify developer").
- **PR and crisis alerts**: a daily scheduled run with sort **New** and **Posted after** "1 day" returns only fresh mentions.
- **Market research and AI datasets**: real opinions on any topic, with full text and engagement numbers.

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

You pay per result in your dataset: a post, a comment, a user or a community, all at the same price.

| Apify plan | Price per 1,000 results |
|---|---:|
| Free | $0.59 |
| Starter | $0.49 |
| Scale | $0.45 |
| Business | $0.39 |

A post that several of your search terms find is charged once per run. Results your filters skip are free. There's no start fee, and the run stops at your spending limit.

### Input

The prefill searches "Shopify" and "WooCommerce" over the past week and keeps 50 posts each. To change it:

- **Search terms**: one per line. Each term is its own search; Reddit matches the words in titles and post text (and in comments with **Search for** Comments).
- **Search for**: posts, comments, communities or users.
- **Sort** and **Period**: for monitoring, use **New** with a short period; for research, **Relevance** or **Top**.
- **Match**: **Reddit's match** (the default) keeps whatever Reddit's search finds. **Every word** keeps a post only when its title and text hold every word of the search term (a comment, when its text does), in any order; **Exact phrase** needs the words in a row. Results that don't match aren't delivered and aren't charged. For example, a post search for "crm recommendation" over the past year (October 20, 2026): of Reddit's first 30 results, 4 held both words (most say "recommendations"); **Exact phrase** read through Reddit's 244 results and kept the 16 that hold the phrase.
- **Max results per search term**: Reddit stops a post search at about 250 per sort; **Maximize coverage** (under More ways to search) also reads it in other sorts and periods and merges them without duplicates.
- Below the first screen: one subreddit only, Reddit search links, **Filters** (dates, minimum score, NSFW), the comments of the posts found, and **Advanced** (a total cap for the run, comment depth and sort, proxy).

```json
{
  "searches": ["your brand", "your competitor"],
  "searchType": "comments",
  "searchSort": "new",
  "searchTime": "day",
  "maxItemsPerSource": 200
}
```

### Output

Every row goes to one dataset, where `dataType` says what it is: `post`, `comment`, `community` or `user`. The Output tab has a table for each (posts with a stats view) and one with everything. `input` and `searchQuery` tell you which of your search terms found the row. Download as JSON, CSV, Excel or HTML, or read it through the Apify API.

A comment found by searching comments for "HubSpot" (shortened):

```json
{
  "dataType": "comment",
  "id": "t1_peapj54",
  "url": "https://www.reddit.com/r/recruitinghell/comments/1wz7lvw/this_is_why_we_cant_get_jobs/peapj54/",
  "body": "HubSpot always operated on the \"hire, churn, burn, and discard fresh college grads\" model. ...",
  "upVotes": 3,
  "createdAt": "2026-10-06T20:41:19Z",
  "postTitle": "This is why we can’t get jobs",
  "communityName": "r/recruitinghell",
  "inputType": "search:comments",
  "searchQuery": "HubSpot"
}
```

**Post fields** (101): `id`, `url`, `title`, `body`, `communityName`, `username`, `upVotes`, `upvoteRatio`, `commentsCount`, `createdAt`, `flair`, `postType`, `contentUrl`, `domain`, `imageUrls`, `videoUrl`, `over18`, `ageHours`, `scorePerHour`, `commentsPerHour`, `engagementTotal`, `wordCount`, `bodyHtml`, `subredditSubscribers`, `authorFlairText`, `isSelf`, `isVideo`, `spoiler`, `locked`, `stickied`, `isAd`, `numCrossposts`, `galleryImages`, `permalink`, `shortUrl` and more.

**Comment fields** (61): `id`, `url`, `body`, `username`, `upVotes`, `createdAt`, `parentId`, `postId`, `postTitle`, `postUrl`, `communityName`, `isSubmitter`, `edited`, `bodyHtml` and more. Comments found by a comment search come one by one, each filled in from its own page: its author (`username`, `authorId`), `depth` and `rootCommentId` (up to 8 levels deep), and the post's `postUpVotes`, `postCommentsCount` and `postAuthor`. They don't come inside their thread, so `numberOfReplies` is empty; turn on **Include comments** with a post search to get whole threads instead.

Community rows have `subscribers`, `weeklyActiveUsers`, `weeklyContributions`, `description` and `rules`; user rows have karma, account age and verification.

### Is it legal to search Reddit?

The Actor reads only public Reddit pages that anyone can open without an account. It never logs in and skips private and quarantined communities. If your results include personal data, you're responsible for handling it lawfully (for example under GDPR).

### FAQ

**Why do some posts not mention my word in the title?** Reddit's search matches the post text too, so some posts mention your word only in passing (a job ad, a list of tools), and it also matches other forms of a word and other fields. Sort **Relevance** puts the closest matches first; **Match** set to **Every word** or **Exact phrase** keeps only results whose own text holds your words, and **Search only in this subreddit** and a **Minimum score** keep results tight. Skipped rows are free.

**How do I get only new mentions every day?** Schedule the Actor (Apify Schedules) with **Sort** New, **Period** Day and **Posted after** "1 day". Each run returns the last day's mentions; post rows have `createdAt` and `scrapedAt` to merge runs.

**How far back does comment search go?** **Search only in this subreddit** uses Reddit's own subreddit search (and each row is checked again). Reddit's comment search has no period of its own, so **Period** and **Posted after/before** are applied to what it returns (other comments are skipped and free). With sort **New**, the run stops at the first page older than your period.

**Is it fast?** Results arrive page by page as Reddit answers. The prefilled run (100 posts) took 6 and 25 seconds on Apify in two runs, the first row 1.5 and 3.3 seconds after the start (256 MB, datacenter proxy, October 22, 2026).

**Does my Apify plan matter?** Only for very large runs. Reddit allows 100 requests per IP every 10 minutes and the run uses your plan's datacenter proxy IPs (5 on Free, more on paid plans). If they are all used up, the run waits for Reddit's window to reset and says so in its status.

### Feedback

Missing a field or a search option? Open an issue on the Actor's Issues tab; we read every one. If the results helped, a short review on the Store page helps others find it.

# Actor input Schema

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

Keywords, brand or product names to find, one per line, e.g. Shopify. Each is searched across all of Reddit (or one subreddit, under More ways to search).

## `searchType` (type: `string`):

What the search terms look for. Comments finds comments that use your words anywhere on Reddit (Search sort: relevance, new or top; Search period and Search only in this subreddit apply), each with its post and community.

## `searchSort` (type: `string`):

Order of results: Relevance, New (latest mentions first, best for monitoring), Top, Most comments or Hot.

## `searchTime` (type: `string`):

How far back to look. Comments older than this are skipped (free).

## `matchMode` (type: `string`):

How closely a post or comment must match your search terms.

• Reddit's match: whatever Reddit's search finds (it also matches word stems and other fields, so some results only touch your words).
• Every word: the post's title and text (or the comment) must hold every word of the search term, in any order.
• Exact phrase: the words in a row, as typed (case, punctuation and line breaks don't matter).

Results that don't match aren't delivered and aren't charged. A post's own comments (Include comments) always come with it.

## `maxItemsPerSource` (type: `integer`):

Most posts (or comments, communities or users) per search term. Reddit stops a post search at about 250 per sort; Maximize coverage gets more.

## `withinSubreddit` (type: `string`):

Optional subreddit name (e.g. CRM) to limit search terms to. With Comments, other communities' comments are skipped (free).

## `maximizeCoverage` (type: `boolean`):

Reddit stops a search at about 250 posts per sort. On: each search is also read in other sorts and periods (new, top by year, month, week...) and merged without duplicates.

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

Optional: Reddit search links, one per row (reddit.com/search/?q=...\&sort=new); each keeps its own sort, period and type. Other Reddit links (a subreddit, a post) work too.

## `postedAfter` (type: `string`):

Only posts and comments from after this date: 2026-09-01, 2026-09-01T12:00:00Z, or a period like '7 days' or '12 hours'.

## `postedBefore` (type: `string`):

Only posts and comments from before this date (same formats).

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

Skip posts with a lower score (upvotes minus downvotes), e.g. 10. Empty = no minimum.

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

Keep posts and communities marked 18+.

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

Add each post's comments, replies included, right after the post. Each comment is one result.

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

Most comments to read per post, replies included, in Reddit's thread order (e.g. 4 for a quick look, 500 for whole threads).

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

Most rows for the whole run: every source, post, comment, user and community counted together. Empty = no total cap (Max posts per source and your spending limit still apply).

## `includeCommunityRules` (type: `boolean`):

For community search results, also read each community's rules (one extra Reddit call per community; free).

## `commentDepth` (type: `integer`):

How deep in reply chains to go: 1 = top-level comments only, 10 = Reddit's maximum.

## `commentSort` (type: `string`):

Order of comments, as on Reddit.

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

Leave as is: Reddit answers Apify's datacenter proxy, the cheapest option. If you pick Residential, the run still reads through datacenter and uses your residential IPs only to retry a call Reddit refuses there.

## Actor input object example

```json
{
  "searches": [
    "Shopify",
    "WooCommerce"
  ],
  "searchType": "posts",
  "searchSort": "relevance",
  "searchTime": "week",
  "matchMode": "any",
  "maxItemsPerSource": 50,
  "maximizeCoverage": false,
  "includeNSFW": true,
  "includeComments": false,
  "maxCommentsPerPost": 100,
  "includeCommunityRules": true,
  "commentDepth": 10,
  "commentSort": "confidence",
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

## `posts` (type: `string`):

No description

## `comments` (type: `string`):

No description

## `communities` (type: `string`):

No description

## `users` (type: `string`):

No description

## `overview` (type: `string`):

No description

## `summary` (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 = {
    "searches": [
        "Shopify",
        "WooCommerce"
    ],
    "searchTime": "week",
    "maxItemsPerSource": 50
};

// Run the Actor and wait for it to finish
const run = await client.actor("deepmine/reddit-search-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 = {
    "searches": [
        "Shopify",
        "WooCommerce",
    ],
    "searchTime": "week",
    "maxItemsPerSource": 50,
}

# Run the Actor and wait for it to finish
run = client.actor("deepmine/reddit-search-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 '{
  "searches": [
    "Shopify",
    "WooCommerce"
  ],
  "searchTime": "week",
  "maxItemsPerSource": 50
}' |
apify call deepmine/reddit-search-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,deepmine/reddit-search-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/IQ2sCwwCJh2D9qtGM/builds/lBG2JllzEvoslKpH9/openapi.json