# Reddit Search Scraper: Keyword Monitoring & Brand Mentions 🔍 (`unitbytes/reddit-search-scraper`) Actor

Real-time Reddit search across 5 dimensions: Posts, Communities, Users, Media, and Comments. Monitor brand keywords and competitor mentions with zero API keys. Export instant CSV/JSON alerts.

- **URL**: https://apify.com/unitbytes/reddit-search-scraper.md
- **Developed by:** [UnitBytes | Enterprise Web Data](https://apify.com/unitbytes) (community)
- **Categories:** Lead generation, Marketing, Social media
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.50 / 1,000 result scrapeds

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

<p align="center">
  <a href="https://console.apify.com/actors/bfr9TmCR0hYlnho8b/input" target="_blank">
    <img src="https://raw.githubusercontent.com/unitbytes/.github/main/assets/banners/unitbytes-reddit-scraper-subreddits-posts-comments-api-banner.jpg" alt="Reddit Search Scraper API by UnitBytes" width="100%" />
  </a>
</p>

<p align="center">
  <a href="https://console.apify.com/actors/bfr9TmCR0hYlnho8b/input" target="_blank">
    <img src="https://raw.githubusercontent.com/unitbytes/.github/main/assets/try-it-for-free.svg" width="240" height="48" alt="Try it for Free">
  </a>
  <br>
  <sub>⚡ <b>1-Click Free Trial:</b> Search across Posts, Subreddits, Users, Media & Comments • No API keys required • Instant results</sub>
</p>

***

## 🔍 Reddit Search Scraper \[From $0.50💰] — Keyword & Topic Intelligence Across 5 Dimensions

<p align="center">
  <strong>The easiest, fastest way to search all of Reddit across posts, communities, users, media, and comments.</strong><br>
  Monitor brand mentions, find high-intent buyers, uncover viral topics, and discover niche communities with zero API keys or logins.
</p>

<p align="center">
  <a href="#-predictable-pricing--volume-discounts"><img src="https://img.shields.io/badge/Pricing-From_$0.50/1k-brightgreen.svg" alt="Pricing" /></a>
  <a href="#-30-second-quick-start-no-code-required"><img src="https://img.shields.io/badge/Setup-Zero_API_Keys-blue.svg" alt="Zero API Keys" /></a>
  <a href="#-5-powerful-search-dimensions"><img src="https://img.shields.io/badge/Search_Surfaces-5_Dimensions-blue.svg" alt="5 Dimensions" /></a>
  <a href="#-why-use-reddit-search-intelligence"><img src="https://img.shields.io/badge/Speed-Instant_1--2s-orange.svg" alt="Speed" /></a>
  <a href="#-why-use-reddit-search-intelligence"><img src="https://img.shields.io/badge/Data_Export-1--Click_Excel_&_CSV-purple.svg" alt="Excel & CSV" /></a>
</p>

***

### ⚡ 30-Second Quick Start (No Code Required)

Search all of Reddit in 3 simple steps:

1. **Enter Your Keyword**: Type any search query into **`searchQuery`** (e.g. `"Notion alternative"` or `"AI agents"`).
2. **Select Search Dimension**: Pick your target tab in **`searchTab`**:
   - `posts`: Discussions, upvotes, scores, and permanent media links.
   - `communities`: Matching subreddits with subscriber counts and member activity.
   - `people`: Key creators, influencers, and profile bios.
   - `media`: Visual images, infographics, and videos with permanent links.
   - `comments`: Real-time conversational replies matching your keyword.
3. **Click "Start" & Export**: Hit **Start** to extract up to thousands of results in 1–2 seconds, then download clean **Excel** or **CSV** files.

***

### 💡 How Reddit Search Powers Your Business

- 🎯 **High-Intent Lead Generation** — Search for buying signals like *"alternative to"*, *"recommend a tool for"*, or *"switching from"* to find potential customers right when they are looking for solutions.
- 🔍 **Comprehensive Brand & Competitor Monitoring** — Track your product name, competitors, founder mentions, or campaign keywords across millions of Reddit discussions in real time.
- 👥 **Target Audience & Community Discovery** — Search the **Communities** tab to discover fast-growing, high-engagement subreddits for marketing, organic community building, and ad targeting.
- 👤 **Influencer & Thought Leader Sourcing** — Search the **People** tab to find active contributors, top community creators, and domain authorities in any industry.

***

### ⚡ 5 Dedicated Search Dimensions

Extract specialized intelligence across 5 distinct search surfaces:

| Search Dimension (`searchTab`) | What You Get | Primary Business Use Case |
| :--- | :--- | :--- |
| 📝 **Posts (`posts`)** | Titles, body text, upvotes, scores, author flair, permanent media links | Content research, viral trends & brand sentiment |
| 👥 **Communities (`communities`)** | Subreddit names, subscriber counts, descriptions, active visitors | Influencer marketing & niche audience targeting |
| 👤 **People (`people`)** | Usernames, karma scores, avatar photos, profile URLs | KOL sourcing & top contributor outreach |
| 🖼️ **Media (`media`)** | Photos, galleries, videos with 100% permanent HD links | Creative asset research & visual trend analysis |
| 💬 **Comments (`comments`)** | Discussion comments matching your exact keyword | Real-time question answering & customer objections |

***

> ### 💡 Why Businesses Choose This Over Reddit Official API
>
> - **5 Search Surfaces vs 1**: The official Reddit API restricts search primarily to basic post endpoints. UnitBytes unlocks all 5 native search tabs—including Subreddits, Users, Media, and Comments—in one unified interface.
> - **No Commercial Approval Gate**: Official API access requires commercial licensing agreements and rigorous developer verification. UnitBytes operates instantly with zero credentials.
> - **Permanent HD Media CDN Links**: Standard API queries return media URLs that expire in a matter of hours. UnitBytes rewrites all media assets to permanent CDN URLs (`i.redd.it`), ensuring your reports and dashboards never show broken images.
> - **Unbeatable Unit Economics**: At **$0.50–$1.00 per 1,000 results** with no monthly commitments, you can run daily brand monitoring at 90% lower cost than official enterprise licensing.

### 🏆 How It Compares to Other Options

| Feature / Capability | **UnitBytes Search Scraper** | Official Reddit API | Other Scraping Tools |
| :--- | :--- | :--- | :--- |
| **Search Dimensions** | **✅ 5 Tabs (Posts, Subreddits, Users, Media, Comments)** | ⚠️ Posts & Comments only | ❌ Posts only |
| **Setup & Approvals** | **✅ Instant 1-click start (Zero setup)** | 🛑 Strict approvals & developer contracts | ❌ None needed |
| **Cost per 1,000 Results** | **💰 $0.50 – $1.00** | 💵 $0.24 + Enterprise monthly fees | 💸 $2.00 – $5.00 |
| **Permanent Media Links** | **✅ 100% Permanent HD Links (`i.redd.it`)** | ⚠️ Expiring signed URLs | ❌ Often broken preview links |
| **Data Format** | **✅ 1-Click Clean CSV, Excel & JSON** | Complex nested JSON | Inconsistent columns |
| **Time to Results** | **⚡ 1–2 seconds (Instant)** | ~3–5 seconds | 🐢 30–60 seconds |
| **Extra Compute Fees** | **✅ $0.00 (No hidden server fees)** | N/A | 💸 High hourly compute bills |
| **Empty Search Runs** | **✅ $0.00 (Guaranteed Zero Charge)** | ❌ Charged per call | ⚠️ Charged start fees |

***

### 💎 Predictable Pricing & Volume Discounts

We use Apify **Pay-Per-Event (PPE)** pricing with active **Store Discounts**. Users on higher subscription tiers automatically unlock substantial volume discounts:

| Plan Tier | Apify Discount Tier | Unit Price per Item | Price / 1,000 Results | Included Monthly Capacity |
| :--- | :--- | :--- | :--- | :--- |
| 🟢 **Free Plan** | `FREE` | **$0.0010** | **$1.00** | **Up to 5,000 results/mo FREE** ($5 credit) |
| 🥉 **Starter Plan** | `BRONZE` | **$0.0008** | **$0.80 (20% OFF)** | **Up to 23,750 results/mo** ($19 credit) |
| 🥈 **Scale Plan** | `SILVER` | **$0.0006** | **$0.60 (40% OFF)** | **Up to 331,600 results/mo** ($199 credit) |
| 🥇 **Business Plan** | `GOLD` / `PLATINUM` | **$0.0005** | **$0.50 (50% OFF)** | **Up to 1,998,000 results/mo** ($999 credit) |

#### 💰 What Does This Cost in Real Life?

| Search Scenario | Results Extracted | Estimated Cost (Starter / Scale) | Time to Complete |
| :--- | :--- | :--- | :--- |
| **High-Intent B2B Lead Search** | 300 Posts (`"switching from [X]"`) | **$0.18 – $0.24** | ~1 second |
| **Niche Subreddit Directory** | 500 Communities for Ad Targeting | **$0.25 – $0.40** | ~1–2 seconds |
| **KOL & Influencer Discovery** | 1,000 User Profiles | **$0.50 – $0.80** | ~2 seconds |
| **Full Cross-Tab Brand Audit** | 5,000 Posts, Media & Comments | **$2.50 – $4.00** | ~4 seconds |
| **Apify Free Tier Users** | Up to **5,000 results/month** | **$0.00 FREE** *(Included with $5 credit)* | Instant |

> **Fair Billing Guarantee**: Zero charges on empty search results. Startup fee is capped at the platform minimum ($0.00005).

***

### 🚀 3 Ready-to-Run Workflows

#### Workflow 1: High-Intent Lead Discovery

Find users actively asking for recommendations or complaining about competitors.

1. Enter `searchQuery`: `"alternative to notion"` or `"switching from zapier"`.
2. Set `searchTab` to `posts` or `comments`.
3. Set `sort` to `relevance` or `new` and `timeFilter` to `month` or `year`.
4. Click **Start** — export hot sales opportunities directly to CSV/Excel.

#### Workflow 2: Discover Niche Subreddits for Marketing

Find relevant, high-engagement communities to promote your product or service.

1. Enter your industry keyword: `"generative ai"`, `"indie hacker"`, or `"productivity"`.
2. Set `searchTab` to `communities`.
3. Download a ready-to-use directory of subreddits complete with member counts and descriptions.

#### Workflow 3: Scrape Within a Specific Community

Filter search results to a specific subreddit of interest.

1. Enter `searchQuery`: `"pricing feedback"`.
2. Enter `subreddit`: `"SaaS"` or `"startups"`.
3. Extract only the discussions happening inside that targeted community.

***

### 📥 Input Parameters

| Parameter | Type | Default | Description |
| :--- | :--- | :--- | :--- |
| `searchQuery` | String | `"artificial intelligence"` | Keyword or phrase you want to search Reddit for. |
| `searchTab` | Select | `"posts"` | Which dimension to search: `posts`, `communities`, `people`, `media`, or `comments`. |
| `subreddit` | String | `""` | Optional: Restrict search results to a specific community (e.g. `technology`). |
| `sort` | Select | `"relevance"` | Sort results by: `relevance`, `hot`, `top`, or `new`. |
| `timeFilter` | Select | `"all"` | Filter by time period: `all`, `year`, `month`, `week`, `day`, or `hour`. |
| `maxItems` | Integer | `50` | Maximum number of results to extract (1 – 5,000). |
| `proxyConfiguration` | Object | `Default` | Recommended proxy settings for high-speed, reliable extraction. |
| `customProxyUrl` | String | `""` | Optional custom proxy URL if you prefer your own provider. |

***

### 📤 Sample Output Datasets

#### 1. Post Search Result Record

```json
{
  "itemType": "post",
  "id": "t3_1x0b0f5",
  "title": "Top AI tools changing small business operations in 2026",
  "subreddit": "smallbusiness",
  "author": "digital_growth_lead",
  "score": 420,
  "upvoteRatio": 0.94,
  "numComments": 85,
  "url": "https://www.reddit.com/r/smallbusiness/comments/1x0b0f5/...",
  "permalink": "https://www.reddit.com/r/smallbusiness/comments/1x0b0f5/...",
  "createdAt": "2026-10-10T14:20:00Z",
  "mediaUrls": ["https://i.redd.it/example_asset.jpg"],
  "searchQuery": "AI tools",
  "scrapedAt": "2026-10-11T16:00:00Z"
}
```

#### 2. Community Search Result Record

```json
{
  "itemType": "community",
  "id": "t5_2qh16",
  "name": "technology",
  "title": "Technology",
  "subscribers": 16400000,
  "activeVisitors": 2400,
  "description": "Dedicated to the news and discussions about the creation and use of technology.",
  "url": "https://www.reddit.com/r/technology/",
  "searchQuery": "technology",
  "scrapedAt": "2026-10-11T16:00:00Z"
}
```

***

### 📊 Instant Analysis in Excel, Google Sheets & Python

The pre-flattened dataset requires zero manual cleanup:

- **In Google Sheets / Excel**: Download CSV or Excel with 1 click. Filter by `score` or sort by `createdAt` to spot emerging trends.
- **In Python / Pandas**:
  ```python
  import pandas as pd
  from apify_client import ApifyClient

  client = ApifyClient("YOUR_APIFY_TOKEN")
  items = client.dataset("DATASET_ID").list_items().items
  df = pd.DataFrame(items)

  # Filter top-performing posts
  top_posts = df.sort_values(by="score", ascending=False).head(10)
  print(top_posts[["title", "score", "url"]])
  ```

***

### ❓ Frequently Asked Questions (FAQ)

#### Can I search within a specific subreddit?

**Yes.** Fill in both `searchQuery` and `subreddit`. The scraper will restrict search results strictly to that community.

#### Can I search for user profiles or communities?

**Yes.** Change `searchTab` to `communities` to find subreddits, or `people` to find user accounts and authors.

#### What happens if no results match my search?

The actor finishes cleanly with exit code `0`, outputs an empty dataset, and **charges $0.00**.

#### Are the media links permanent?

**Yes.** All image and video links are automatically converted to permanent high-definition CDN links that never expire in your spreadsheets or dashboards.

***

### ⚖️ Compliance & Privacy

This scraper extracts only publicly accessible search results that Reddit provides to web users. It does not access private content or restricted data. Please ensure your usage complies with relevant data privacy laws (such as GDPR / CCPA) and Reddit terms.

# Actor input Schema

## `searchQuery` (type: `string`):

Keyword, phrase, or topic to search across Reddit.

## `searchTab` (type: `string`):

Select which Reddit search tab to extract: Posts, Communities, People/Profiles, Media, or Comments.

## `subreddit` (type: `string`):

Restrict keyword search within a specific subreddit (e.g. 'technology', 'SaaS', 'wallstreetbets'). Leave blank to search all of Reddit.

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

Sorting criteria for search results.

## `timeFilter` (type: `string`):

Time filter applied when sorting by 'top' or 'relevance'.

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

Maximum number of search results to extract.

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

Residential proxy configuration. Reddit blocks datacenter IPs, so residential proxies are automatically enforced by default for high reliability.

## `customProxyUrl` (type: `string`):

Optional custom residential proxy URL (e.g. MrScraper). If provided, it will be prioritized before falling back to Apify Residential.

## Actor input object example

```json
{
  "searchQuery": "artificial intelligence",
  "searchTab": "posts",
  "sort": "relevance",
  "timeFilter": "all",
  "maxItems": 50,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}
```

# Actor output Schema

## `redditDataset` (type: `string`):

Structured dataset of extracted Reddit posts, user submissions, search results, and comment trees with permanent media links.

# 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 = {
    "searchQuery": "artificial intelligence",
    "subreddit": ""
};

// Run the Actor and wait for it to finish
const run = await client.actor("unitbytes/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 = {
    "searchQuery": "artificial intelligence",
    "subreddit": "",
}

# Run the Actor and wait for it to finish
run = client.actor("unitbytes/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 '{
  "searchQuery": "artificial intelligence",
  "subreddit": ""
}' |
apify call unitbytes/reddit-search-scraper --silent --output-dataset

```

## MCP server setup

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