# Reddit Viral Scraper (`agentx/reddit-viral-scraper`) Actor

Search Reddit across every subreddit by keyword, sorted by relevance, hot, top, new, or comment count, scoped to the last hour, day, week, month, year, or all time. Returns up to 1,000,000 matching posts with full metadata and optional comment threads for brand-mention monitoring.

- **URL**: https://apify.com/agentx/reddit-viral-scraper.md
- **Developed by:** [AgentX](https://apify.com/agentx) (community)
- **Categories:** Social media, AI, Agents
- **Stats:** 41 total users, 5 monthly users, 100.0% runs succeeded, 4 bookmarks
- **User rating**: 5.00 out of 5 stars

## Pricing

from $7.20 / 1,000 posts

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/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
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.
Actors are written with capital "A".

## 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.
The best way to integrate Actors is as follows.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).

If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).


# README

## Reddit Viral Scraper - Reddit Trend Detection & Viral Content Intelligence API

**Reddit Viral Scraper is a Reddit trend-detection and viral-content intelligence API that extracts structured cross-subreddit posts, engagement signals, and comment threads from any keyword/brand term in a single search-driven run.** Reddit Viral Scraper returns structured records per post, including post title, body, author, post URL, post ID, score, upvotes, downvotes, upvote ratio, comment count, crosspost count, flair, NSFW flag, moderation status, subreddit name, subreddit subscriber count, posting timestamp, time-window match, attached media URLs, and full comment thread (up to configurable max_comments per post). Coverage spans all public Reddit communities across all topics and languages with hour/day/week/month/year time windows. Built for marketing signal mining, viral-trend forecasting, PR and crisis monitoring, competitive intelligence, brand-sentiment analysis, meme-trend research, and content-strategy pipelines. Pay-per-result pricing at $0.00773 per post with no monthly minimum.

[![Reddit](https://img.shields.io/badge/Reddit-FF4500?style=for-the-badge&color=FF4500)](https://apify.com/agentx/reddit-viral-scraper?fpr=aiagentapi) [![Viral Intelligence](https://img.shields.io/badge/Viral_Intelligence-FF4500?style=for-the-badge&color=FF4500)](https://apify.com/agentx/reddit-viral-scraper?fpr=aiagentapi) [![Trend Forecasting](https://img.shields.io/badge/Trend_Forecasting-FF4500?style=for-the-badge&color=FF4500)](https://apify.com/agentx/reddit-viral-scraper?fpr=aiagentapi)

---

### Why Choose This API

#### Structured Reddit Viral Intelligence for B2B Signal Mining Pipelines

**📊 Engagement Scoring & Viral Velocity**
The `score`, `upvotes`, `downvotes`, and `crossposts` fields deliver granular engagement signals per post — enabling viral velocity scoring, trending content detection, and engagement quality assessment for marketing signal mining and content trend forecasting pipelines.

**🔍 Cross-Subreddit Keyword Search**
A single keyword query surfaces posts across all of Reddit simultaneously — enabling brand mention monitoring, competitor tracking, emerging trend detection, and topic sentiment mapping across thousands of communities in one extraction run.

**⏱️ Time-Window Trend Filtering**
The `time_filter` parameter (hour / day / week / month / year / all) combined with `sort_by` (relevance / hot / top / new / comments) delivers precision temporal trend analysis — enabling rapid sentiment shift detection, viral spike identification, and trend velocity forecasting.

**💬 Full Comment Thread Extraction**
Configure `max_comments` to extract complete discussion threads per post — enabling deep audience sentiment analysis, topic clustering, competitive feedback mining, and community voice capture for qualitative research pipelines.

**🏷️ Flair Taxonomy & Subreddit Context**
The `flair_text`, `subreddit`, `subreddit_type`, and `subreddit_subscribers` fields provide rich community context per post — enabling subreddit audience segmentation, content category classification, and topic taxonomy mapping for market research.

**🔒 Moderation Status Intelligence**
The `archived`, `locked`, `stickied`, and `pinned` flags reveal content moderation states — enabling viral content lifecycle analysis, post longevity scoring, and community governance intelligence for Reddit ecosystem research.

---

### Quick Start Guide

#### How to Extract Reddit Viral Intelligence in 3 Steps

##### Step 1: Define Your Keyword

Enter a keyword, brand name, product name, or topic. The API searches across all public Reddit communities simultaneously.

##### Step 2: Configure Sorting and Volume

Select sort mode and time window to target viral, trending, or recent content. Set max posts and max comments to match your pipeline volume.

##### Step 3: Download Structured Results

[Open Actor Input](https://console.apify.com/actors/dM1WGhL57QQWIRlJG/input?fpr=aiagentapi)

Export results as JSON or CSV, or consume via the Apify dataset API.

---

### Input Parameters

#### Configuration Fields

| Parameter      | Type    | Required | Description                                         | Example Values                         |
| -------------- | ------- | -------- | --------------------------------------------------- | -------------------------------------- |
| `keyword`      | string  | ✅       | Search keyword across all Reddit subreddits         | `"artificial intelligence"`, `"Tesla"` |
| `sort_by`      | select  | ✅       | Sort order: relevance / hot / top / new / comments  | `"top"`, `"hot"`, `"new"`              |
| `time_filter`  | select  | ✅       | Time window: all / hour / day / week / month / year | `"week"`, `"month"`, `"all"`           |
| `max_posts`    | integer | ✅       | Maximum posts to extract (1–1,000,000)              | `100`, `1000`, `10000`                 |
| `max_comments` | integer | optional | Maximum comments per post (0 = disabled)            | `50`, `200`, `0`                       |

#### Example Input Configuration

```json
{
  "keyword": "ChatGPT",
  "sort_by": "top",
  "time_filter": "week",
  "max_posts": 500,
  "max_comments": 50
}
````

***

### Output Data Schema

#### Complete Viral Post Record Structure

Each extracted Reddit viral post record contains the following fields:

[Open Actor Output](https://console.apify.com/actors/dM1WGhL57QQWIRlJG/input?fpr=aiagentapi)

#### Core Post Metadata Fields

| Field                   | Type    | Description                                         |
| ----------------------- | ------- | --------------------------------------------------- |
| `processor`             | string  | Apify actor URL that processed this record          |
| `processed_at`          | string  | ISO 8601 timestamp (UTC) when scraped               |
| `subreddit`             | string  | Subreddit community name                            |
| `subreddit_type`        | string  | Access level (public/private/restricted/archived)   |
| `subreddit_subscribers` | integer | Total subscribers of the subreddit                  |
| `id`                    | string  | Unique Reddit post ID                               |
| `author`                | string  | Reddit username of post author                      |
| `created`               | string  | ISO 8601 post creation timestamp                    |
| `edited`                | string  | ISO 8601 last edit timestamp (null if never edited) |
| `link`                  | string  | Permalink to the Reddit post                        |
| `flair_text`            | string  | Post flair/category tag                             |
| `title`                 | string  | Post headline text                                  |
| `body`                  | string  | Full selftext content (null for link posts)         |
| `score`                 | integer | Net karma score (upvotes minus downvotes)           |
| `upvotes`               | integer | Total positive votes                                |
| `downvotes`             | integer | Total negative votes                                |
| `crossposts`            | integer | Number of times crossposted to other subreddits     |
| `archived`              | boolean | Post archived status                                |
| `locked`                | boolean | Moderator lock status                               |
| `stickied`              | boolean | Subreddit sticky/pinned status                      |
| `pinned`                | boolean | User profile pinned status                          |
| `hidden`                | boolean | Post hidden status                                  |

#### Example JSON Output

```json
{
  "processor": "https://apify.com/agentx/reddit-viral-scraper?fpr=aiagentapi",
  "processed_at": "2026-05-01T10:30:00.000Z",
  "subreddit": "technology",
  "subreddit_type": "public",
  "subreddit_subscribers": 15200000,
  "id": "1abc23",
  "author": "tech_researcher",
  "created": "2026-04-29T08:15:00+00:00",
  "link": "https://www.reddit.com/r/technology/comments/1abc23/",
  "flair_text": "AI",
  "title": "ChatGPT surpasses 500M users in Q1 2026",
  "body": "According to OpenAI's latest report...",
  "score": 14500,
  "upvotes": 15200,
  "downvotes": 700,
  "crossposts": 12,
  "archived": false,
  "locked": false,
  "stickied": false
}
```

#### Export Formats

- **JSON** - Complete structured data with all engagement metadata
- **CSV** - Spreadsheet-compatible for BI and analytics tools
- **API Access** - Programmatic access via Apify Client SDK
- **Cloud Storage** - Automatic upload to Apify Dataset

***

### Integration Examples

#### Actor ID for Platform Integration

```text
dM1WGhL57QQWIRlJG
```

#### Ⓜ️ [Make.com Setup:](https://www.make.com/en/register?pc=marketingme)

1. Login to **[Make.com (Get 1000 Free Credits)](https://www.make.com/en/register?pc=marketingme)**
2. Add module **"Run an Actor"**
3. Turn **'Map'** on - right side of the 'Actor\*'
4. Paste **Actor ID** - from above
5. Click the **'⟳ Refresh'** - left side of Map
6. **Input JSON\*** - Modify the parameters as needed
7. Set **"Run synchronously"** to **YES**
8. Add module **"Get Dataset Items"** - receive the result
9. In **Dataset ID\*** select **defaultDatasetId**

#### 🎱 [N8N.io Setup:](https://n8n.io/)

1. Add **'Run an Actor and get dataset'** - from the apify node
2. **Actor** → **By ID** → **Paste Actor ID** - from above
3. **Input JSON** - Modify the parameters as needed

#### Python Integration Example

```python
from apify_client import ApifyClient

client = ApifyClient('YOUR_API_TOKEN')

run_input = {
    "keyword": "ChatGPT",
    "sort_by": "top",
    "time_filter": "week",
    "max_posts": 500,
    "max_comments": 50
}

run = client.actor("dM1WGhL57QQWIRlJG").call(run_input=run_input)

for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)
```

#### JavaScript/Node.js Integration

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

const client = new ApifyClient({ token: "YOUR_API_TOKEN" });

const input = {
  keyword: "artificial intelligence",
  sort_by: "hot",
  time_filter: "day",
  max_posts: 100,
  max_comments: 20,
};

const run = await client.actor("dM1WGhL57QQWIRlJG").call(input);
const { items } = await client.dataset(run.defaultDatasetId).listItems();

items.forEach((item) => console.log(item));
```

#### JSON-LD Metadata

```json
{
  "@context": "https://schema.org",
  "@graph": [
    {
      "@type": "SoftwareApplication",
      "@id": "https://apify.com/agentx/reddit-viral-scraper#software",
      "name": "Reddit Viral Scraper",
      "description": "Reddit Viral Scraper is a Reddit trend-detection and viral-content intelligence API extracting structured cross-subreddit posts with engagement scoring, comment threads, flair taxonomy, and moderation status for marketing signal mining and content trend forecasting.",
      "applicationCategory": "BusinessApplication",
      "applicationSubCategory": "Web Scraping API",
      "operatingSystem": "Web, Cloud",
      "url": "https://apify.com/agentx/reddit-viral-scraper?fpr=aiagentapi",
      "softwareVersion": "1.0.0",
      "datePublished": "2024-08-01",
      "dateModified": "2026-05-01",
      "featureList": [
        "Cross-subreddit single-keyword search",
        "Score, upvotes, downvotes, upvote ratio, crossposts",
        "Hour, day, week, month, year time windows",
        "Configurable max_comments comment thread extraction",
        "Flair, NSFW flag, and moderation status",
        "Subreddit subscriber-count signal",
        "Per-post pay-per-result at $0.00773",
        "Native integrations with Make.com, n8n, LangChain, and CrewAI"
      ],
      "offers": {
        "@type": "Offer",
        "price": "0.00773",
        "priceCurrency": "USD",
        "availability": "https://schema.org/InStock"
      },
      "author": { "@id": "https://apify.com/agentx#person" },
      "publisher": { "@id": "https://apify.com#organization" }
    },
    {
      "@type": "Person",
      "@id": "https://apify.com/agentx#person",
      "name": "AgentX",
      "url": "https://apify.com/agentx",
      "sameAs": [
        "https://apify.com/agentx",
        "https://t.me/AiAgentApi",
        "https://t.me/Apify_Actor"
      ],
      "knowsAbout": [
        "web scraping",
        "Reddit",
        "viral content",
        "trend detection",
        "social listening"
      ]
    },
    {
      "@type": "BreadcrumbList",
      "itemListElement": [
        {
          "@type": "ListItem",
          "position": 1,
          "name": "Apify",
          "item": "https://apify.com"
        },
        {
          "@type": "ListItem",
          "position": 2,
          "name": "AgentX",
          "item": "https://apify.com/agentx"
        },
        {
          "@type": "ListItem",
          "position": 3,
          "name": "Reddit Viral Scraper",
          "item": "https://apify.com/agentx/reddit-viral-scraper"
        }
      ]
    }
  ]
}
```

***

### Pricing & Cost Calculator

#### Pay-Per-Result Pricing

| Event                 | Rate                 |
| --------------------- | -------------------- |
| Actor Start           | $0.005 per GB memory |
| Post (per post)       | $0.00773 (BRONZE)    |
| Comment (per comment) | $0.00016 (BRONZE)    |

#### Cost Calculator Examples

| Posts       | Comments/Post | Estimated Cost |
| ----------- | ------------- | -------------- |
| 100 posts   | 0 comments    | ~$0.78         |
| 500 posts   | 0 comments    | ~$3.87         |
| 1,000 posts | 0 comments    | ~$7.73         |
| 500 posts   | 50 comments   | ~$7.87         |
| 1,000 posts | 100 comments  | ~$23.73        |

> Tip: Set `max_comments: 0` to extract post metadata only and minimize cost per run.

***

### Use Cases & Applications

#### Marketing Signal Mining & Brand Intelligence

**Brand Mention Monitoring**
Track brand names, product names, or competitor terms across all Reddit communities — capturing organic sentiment, user feedback, product complaints, and advocacy signals at scale for PR monitoring and brand intelligence pipelines.

**Viral Content Trend Forecasting**
Use `sort_by: "top"` with `time_filter: "day"` or `"week"` to surface the highest-engagement Reddit posts per topic — enabling early viral trend detection, content briefing, and editorial intelligence for content strategy teams.

**Competitive Intelligence Research**
Search competitor brand names and product terms — extracting structured sentiment data, user complaint patterns, feature request discussions, and competitive comparison posts for product intelligence and market research pipelines.

#### Content & Community Intelligence

**Audience Sentiment Analysis**
Extract `body` text and comments from high-score posts — building topic sentiment datasets, community voice corpora, and audience language analysis for NLP model training and market research.

**Subreddit Segmentation**
The `subreddit` and `subreddit_subscribers` fields per post enable audience segmentation by community size — identifying niche vs. mainstream distribution patterns for content targeting and community intelligence.

**PR Crisis Detection**
Monitor brand keywords with `time_filter: "hour"` or `"day"` and `sort_by: "hot"` — detecting rapidly rising negative sentiment, viral complaint threads, and PR crisis signals before they escalate.

***

### FAQ

#### Can I search for multiple keywords in one run?

Each run supports one keyword. For multi-keyword monitoring, run parallel Actor calls with different keyword inputs and merge datasets downstream.

#### What does `sort_by: "comments"` do?

It sorts results by comment count — surfacing the most discussed posts for a keyword, ideal for capturing deep community discussion threads and high-engagement content.

#### How do I detect viral spikes?

Use `sort_by: "top"` + `time_filter: "day"` or `"hour"` to surface posts gaining the most upvotes in the shortest time window — the most direct signal for viral velocity detection.

#### How does this compare to SubReddit Post Scraper?

[SubReddit Post Scraper](https://apify.com/agentx/subreddit-post-scraper?fpr=aiagentapi) extracts posts from a specific subreddit. This actor performs cross-subreddit keyword search — ideal for brand monitoring, trend detection, and topic tracking across all of Reddit.

***

### SEO Keywords & Search Terms

#### Primary Keywords

Reddit viral scraper API, Reddit trend detection API, Reddit keyword search API, Reddit post extraction API, Reddit engagement data API, Reddit viral content intelligence, Reddit brand monitoring API, Reddit signal mining API, Reddit post scraper, Reddit cross-subreddit search API

#### Long-Tail Keywords

how to track viral Reddit posts programmatically, Reddit keyword monitoring API, Reddit brand mention scraper, Reddit trend forecasting API, Reddit post engagement data extraction, Reddit viral velocity scoring API, Reddit sentiment analysis data API, Reddit PR monitoring tool, cross-subreddit search API, Reddit hot post extractor

#### Industry Terms

Reddit viral intelligence API, engagement scoring pipeline, Reddit trend detection, brand mention monitoring, viral velocity scoring, content trend forecasting, Reddit signal mining, PR crisis detection API, Reddit sentiment data, community voice extraction

#### Use Case Keywords

Reddit marketing intelligence, Reddit competitive analysis, Reddit content briefing, Reddit product feedback scraper, Reddit audience sentiment, Reddit trending topic API, Reddit brand monitoring pipeline, Reddit viral post API, Reddit discussion thread extractor, Reddit engagement analytics

***

### Trust & Certifications

- ✅ **Production-Grade Infrastructure** — runs on the Apify cloud platform with managed proxy rotation and automatic retries
- ✅ **GDPR & CCPA-Region Aligned** — extracts only publicly available Reddit posts and comments; no personal contact data retained beyond the run session
- ✅ **Pay-Per-Result Billing** — transparent $0.00773 per post with no monthly minimum or seat fees
- ✅ **Continuously Maintained** — schema and selector updates released as Reddit evolves

***

### Legal & Compliance

#### Data Rights & Usage

All data extracted by this actor originates from publicly available Reddit posts and communities. Users are responsible for ensuring their use of extracted data complies with applicable laws and Reddit terms of service.

#### Privacy Compliance

- **GDPR**: Compliant with EU GDPR for data processing workflows.
- **CCPA**: Compliant with California Consumer Privacy Act requirements.

#### Platform Terms of Service

Users must review and comply with Reddit's developer terms of service when using extracted data.

#### Enterprise Support

For enterprise licensing, custom integrations, or compliance inquiries:

- **Telegram**: [@AiAgentApi](https://t.me/AiAgentApi)

***

### Related Tools

#### Jobs & Hiring

- **[All Jobs Scraper](https://apify.com/agentx/all-jobs-scraper?fpr=aiagentapi)** - Multi-Platform Job Listings Intelligence API
- **[Glassdoor Hiring Scraper](https://apify.com/agentx/glassdoor-hiring-scraper?fpr=aiagentapi)** - Glassdoor Job Listings Intelligence API
- **[Glints Employer Data Extractor](https://apify.com/agentx/glints-employer-data-extractor?fpr=aiagentapi)** - Glints Employer Intelligence API
- **[Glints Jobs Data Extractor](https://apify.com/agentx/glints-jobs-data-extractor?fpr=aiagentapi)** - Glints Job Listings Intelligence API
- **[Indeed Hiring Scraper](https://apify.com/agentx/indeed-hiring-scraper?fpr=aiagentapi)** - Indeed Job Listings Intelligence API
- **[JobStreet Employer Data Extractor](https://apify.com/agentx/jobstreet-employer-data-extractor?fpr=aiagentapi)** - JobStreet Employer Intelligence API
- **[JobStreet Jobs Data Extractor](https://apify.com/agentx/jobstreet-jobs-data-extractor?fpr=aiagentapi)** - JobStreet Job Listings Intelligence API
- **[LinkedIn Hiring Scraper](https://apify.com/agentx/linkedin-hiring-scraper?fpr=aiagentapi)** - LinkedIn Job Listings Intelligence API
- **[StepStone Employer Data Extractor](https://apify.com/agentx/stepstone-employer-data-extractor?fpr=aiagentapi)** - StepStone Employer Intelligence API
- **[StepStone Jobs Data Extractor](https://apify.com/agentx/stepstone-jobs-data-extractor?fpr=aiagentapi)** - StepStone Job Listings Intelligence API

#### Social Media

- **[Instagram Creator Scraper](https://apify.com/agentx/instagram-creator-scraper?fpr=aiagentapi)** - Instagram Creator Intelligence API
- **[Instagram Post Reel Scraper](https://apify.com/agentx/instagram-post-reel-scraper?fpr=aiagentapi)** - Instagram Post & Reel Intelligence API
- **[Instagram Trending Scraper](https://apify.com/agentx/instagram-trending-scraper?fpr=aiagentapi)** - Instagram Trending Content Intelligence API
- **[LinkedIn Company Scraper](https://apify.com/agentx/linkedin-company-scraper?fpr=aiagentapi)** - LinkedIn Company Intelligence API
- **[LinkedIn Profile Scraper](https://apify.com/agentx/linkedin-profile-scraper?fpr=aiagentapi)** - LinkedIn Profile Intelligence API
- **[Medium Author Data Extractor](https://apify.com/agentx/medium-author-data-extractor?fpr=aiagentapi)** - Medium Author Intelligence API
- **[Medium Content Data Extractor](https://apify.com/agentx/medium-content-data-extractor?fpr=aiagentapi)** - Medium Content Intelligence API
- **[Reddit Author Scraper](https://apify.com/agentx/reddit-author-scraper?fpr=aiagentapi)** - Reddit Author Intelligence API
- **[Reddit Viral Scraper](https://apify.com/agentx/reddit-viral-scraper?fpr=aiagentapi)** - Reddit Viral Content Intelligence API
- **[SubReddit Info Scraper](https://apify.com/agentx/subreddit-info-scraper?fpr=aiagentapi)** - Subreddit Intelligence API
- **[Subreddit Member Scraper](https://apify.com/agentx/subreddit-member-scraper?fpr=aiagentapi)** - Subreddit Member Intelligence API
- **[SubReddit Post Scraper](https://apify.com/agentx/subreddit-post-scraper?fpr=aiagentapi)** - Subreddit Post Intelligence API
- **[Telegram Chat Scraper](https://apify.com/agentx/telegram-chat-scraper?fpr=aiagentapi)** - Telegram Chat Intelligence API
- **[Telegram Group Inviter](https://apify.com/agentx/telegram-group-inviter?fpr=aiagentapi)** - Telegram Group Invitation API
- **[Telegram Info Scraper](https://apify.com/agentx/telegram-info-scraper?fpr=aiagentapi)** - Telegram Channel Intelligence API
- **[Telegram Member Scraper](https://apify.com/agentx/telegram-member-scraper?fpr=aiagentapi)** - Telegram Member Intelligence API
- **[Telegram Private Group Scraper](https://apify.com/agentx/telegram-private-group-scraper?fpr=aiagentapi)** - Telegram Private Group Intelligence API
- **[TikTok Creator Scraper](https://apify.com/agentx/tiktok-creator-scraper?fpr=aiagentapi)** - TikTok Creator Intelligence API
- **[Twitter Community Scraper](https://apify.com/agentx/twitter-community-scraper?fpr=aiagentapi)** - Twitter Community Intelligence API
- **[Twitter Info Scraper](https://apify.com/agentx/twitter-info-scraper?fpr=aiagentapi)** - Twitter Account Intelligence API
- **[YouTube Market Intelligence](https://apify.com/agentx/youtube-market-intelligence?fpr=aiagentapi)** - YouTube Channel Intelligence API

#### Video & Transcript

- **[All Video Scraper](https://apify.com/agentx/all-video-scraper?fpr=aiagentapi)** - Multi-Platform Video Intelligence API
- **[Live Stream Transcript](https://apify.com/agentx/live-stream-transcript?fpr=aiagentapi)** - Live Stream Transcript Intelligence API
- **[TikTok Live Downloader](https://apify.com/agentx/tiktok-live-downloader?fpr=aiagentapi)** - TikTok Live Stream Download API
- **[TikTok Transcript](https://apify.com/agentx/tiktok-transcript?fpr=aiagentapi)** - TikTok Video Transcript Intelligence API
- **[Video Caption Scraper](https://apify.com/agentx/video-caption-scraper?fpr=aiagentapi)** - Multi-Platform Video Caption Extraction API
- **[Video to Social Post](https://apify.com/agentx/video-to-social-post?fpr=aiagentapi)** - Video to Social Post Generation API
- **[Video Transcript](https://apify.com/agentx/video-transcript?fpr=aiagentapi)** - Multi-Platform Video Transcript Intelligence API
- **[YouTube Transcript](https://apify.com/agentx/youtube-transcript?fpr=aiagentapi)** - YouTube Video Transcript Intelligence API

#### E-Commerce & Retail

- **[Amazon Product Data Extractor](https://apify.com/agentx/amazon-product-data-extractor?fpr=aiagentapi)** - Amazon Product Intelligence API
- **[Amazon Storefront Data Extractor](https://apify.com/agentx/amazon-storefront-data-extractor?fpr=aiagentapi)** - Amazon Storefront Intelligence API
- **[Argos Retail Data Extractor](https://apify.com/agentx/argos-retail-data-extractor?fpr=aiagentapi)** - Argos Product Intelligence API
- **[ASOS Product Catalog Extractor](https://apify.com/agentx/asos-product-catalog-extractor?fpr=aiagentapi)** - ASOS Product Catalog Intelligence API
- **[eBay Marketplace Data Extractor](https://apify.com/agentx/ebay-marketplace-data-extractor?fpr=aiagentapi)** - eBay Marketplace Intelligence API
- **[eBay Seller Leads API](https://apify.com/agentx/ebay-seller-leads-api?fpr=aiagentapi)** - eBay Seller Lead Intelligence API
- **[Flipkart Product Data Extractor](https://apify.com/agentx/flipkart-product-data-extractor?fpr=aiagentapi)** - Flipkart Product Intelligence API
- **[John Lewis Retail Data Extractor](https://apify.com/agentx/john-lewis-retail-data-extractor?fpr=aiagentapi)** - John Lewis Product Intelligence API
- **[Lidl Offers Data Extractor](https://apify.com/agentx/lidl-offers-data-extractor?fpr=aiagentapi)** - Lidl Offers Intelligence API
- **[Magalu Product Data Extractor](https://apify.com/agentx/magalu-product-data-extractor?fpr=aiagentapi)** - Magalu Product Intelligence API
- **[MediaMarkt Product Data Extractor](https://apify.com/agentx/mediamarkt-product-data-extractor?fpr=aiagentapi)** - MediaMarkt Product Intelligence API
- **[Mercado Livre Marketplace Data Extractor](https://apify.com/agentx/mercado-livre-marketplace-data-extractor?fpr=aiagentapi)** - Mercado Livre Marketplace Intelligence API
- **[Nykaa Product Data Extractor](https://apify.com/agentx/nykaa-product-data-extractor?fpr=aiagentapi)** - Nykaa Product Intelligence API
- **[OTTO Product Data Extractor](https://apify.com/agentx/otto-product-data-extractor?fpr=aiagentapi)** - OTTO Product Intelligence API
- **[Target Product Data Extractor](https://apify.com/agentx/target-product-data-extractor?fpr=aiagentapi)** - Target Product Intelligence API
- **[Walmart Product Data Extractor](https://apify.com/agentx/walmart-product-data-extractor?fpr=aiagentapi)** - Walmart Product Intelligence API

#### Classifieds & Automotive

- **[AutoTrader Dealer Leads API](https://apify.com/agentx/autotrader-dealer-leads-api?fpr=aiagentapi)** - AutoTrader Dealer Lead Intelligence API
- **[AutoTrader Vehicle Listings API](https://apify.com/agentx/autotrader-vehicle-listings-api?fpr=aiagentapi)** - AutoTrader Vehicle Listings Intelligence API
- **[Cars.com Dealer Leads API](https://apify.com/agentx/cars-com-dealer-leads-api?fpr=aiagentapi)** - Cars.com Dealer Lead Intelligence API
- **[Cars.com Vehicle Listings API](https://apify.com/agentx/cars-com-vehicle-listings-api?fpr=aiagentapi)** - Cars.com Vehicle Listings Intelligence API
- **[Kleinanzeigen Classifieds Data Extractor](https://apify.com/agentx/kleinanzeigen-classifieds-data-extractor?fpr=aiagentapi)** - Kleinanzeigen Classifieds Intelligence API
- **[Kleinanzeigen Seller Leads API](https://apify.com/agentx/kleinanzeigen-seller-leads-api?fpr=aiagentapi)** - Kleinanzeigen Seller Lead Intelligence API
- **[OLX Classifieds Data Extractor](https://apify.com/agentx/olx-classifieds-data-extractor?fpr=aiagentapi)** - OLX Classifieds Intelligence API
- **[OLX Seller Leads API](https://apify.com/agentx/olx-seller-leads-api?fpr=aiagentapi)** - OLX Seller Lead Intelligence API
- **[Webmotors Vehicle Listings API](https://apify.com/agentx/webmotors-vehicle-listings-api?fpr=aiagentapi)** - Webmotors Vehicle Listings Intelligence API

#### Real Estate

- **[MagicBricks Builder Leads API](https://apify.com/agentx/magicbricks-builder-leads-api?fpr=aiagentapi)** - MagicBricks Builder Lead Intelligence API
- **[MagicBricks Property Data Extractor](https://apify.com/agentx/magicbricks-property-data-extractor?fpr=aiagentapi)** - MagicBricks Real Estate Data API
- **[Realtor Property Scraper](https://apify.com/agentx/realtor-property-scraper?fpr=aiagentapi)** - Realtor.com Property Listings Intelligence API
- **[Zillow For Sale Scraper](https://apify.com/agentx/zillow-for-sale-scraper?fpr=aiagentapi)** - Zillow Property Listings Intelligence API

#### Business Intelligence & Reviews

- **[BBB Business Data Extractor](https://apify.com/agentx/bbb-business-data-extractor?fpr=aiagentapi)** - BBB Business Intelligence API
- **[BBB Reputation Data Extractor](https://apify.com/agentx/bbb-reputation-data-extractor?fpr=aiagentapi)** - BBB Reputation Intelligence API
- **[Google Maps Store Scraper](https://apify.com/agentx/google-maps-store-scraper?fpr=aiagentapi)** - Google Maps Business Intelligence API
- **[Reclame Aqui Company Data Extractor](https://apify.com/agentx/reclame-aqui-company-data-extractor?fpr=aiagentapi)** - Reclame Aqui Company Intelligence API
- **[TradeIndia Product Data Extractor](https://apify.com/agentx/tradeindia-product-data-extractor?fpr=aiagentapi)** - TradeIndia Product Intelligence API
- **[TradeIndia Supplier Leads API](https://apify.com/agentx/tradeindia-supplier-leads-api?fpr=aiagentapi)** - TradeIndia Supplier Lead Intelligence API
- **[Zomato Menu Data Extractor](https://apify.com/agentx/zomato-menu-data-extractor?fpr=aiagentapi)** - Zomato Restaurant Menu Intelligence API
- **[Zomato Restaurant Data Extractor](https://apify.com/agentx/zomato-restaurant-data-extractor?fpr=aiagentapi)** - Zomato Restaurant Search Intelligence API

#### Other

- **[Global Weather Scraper](https://apify.com/agentx/global-weather-scraper?fpr=aiagentapi)** - Global Weather Intelligence API

***

### Support & Community

- **👥 Community**: [@Apify\_Actor](https://t.me/Apify_Actor)
- **👤 Contact Team**: [@AiAgentApi](https://t.me/AiAgentApi)

***

**Last Updated:** May 01, 2026

# Actor input Schema

## `keyword` (type: `string`):

Search keyword to find Reddit posts across all subreddits

## `sort_by` (type: `string`):

Sort results by relevance, hot, top, new, or comment count

## `time_filter` (type: `string`):

Filter results to posts published within a set time period

## `max_posts` (type: `integer`):

Maximum number of posts to find per search

## `max_comments` (type: `integer`):

Maximum number of comments to get per post, 0 to skip

## Actor input object example

```json
{
  "keyword": "artificial intelligence",
  "sort_by": "relevance",
  "time_filter": "all",
  "max_posts": 1
}
```

# Actor output Schema

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

Reddit posts matching keyword search with comments, votes, and community details

# 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 = {
    "keyword": "artificial intelligence",
    "sort_by": "relevance",
    "time_filter": "all",
    "max_posts": 1,
    "max_comments": 0
};

// Run the Actor and wait for it to finish
const run = await client.actor("agentx/reddit-viral-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 = {
    "keyword": "artificial intelligence",
    "sort_by": "relevance",
    "time_filter": "all",
    "max_posts": 1,
    "max_comments": 0,
}

# Run the Actor and wait for it to finish
run = client.actor("agentx/reddit-viral-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "keyword": "artificial intelligence",
  "sort_by": "relevance",
  "time_filter": "all",
  "max_posts": 1,
  "max_comments": 0
}' |
apify call agentx/reddit-viral-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=agentx/reddit-viral-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Reddit Viral Scraper",
        "description": "Search Reddit across every subreddit by keyword, sorted by relevance, hot, top, new, or comment count, scoped to the last hour, day, week, month, year, or all time. Returns up to 1,000,000 matching posts with full metadata and optional comment threads for brand-mention monitoring.",
        "version": "1.0",
        "x-build-id": "SC6MeywUzrCRbwmWE"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/agentx~reddit-viral-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-agentx-reddit-viral-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/agentx~reddit-viral-scraper/runs": {
            "post": {
                "operationId": "runs-sync-agentx-reddit-viral-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/agentx~reddit-viral-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-agentx-reddit-viral-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "required": [
                    "keyword",
                    "sort_by",
                    "time_filter",
                    "max_posts"
                ],
                "properties": {
                    "keyword": {
                        "title": "🔍 Keyword",
                        "type": "string",
                        "description": "Search keyword to find Reddit posts across all subreddits"
                    },
                    "sort_by": {
                        "title": "🔄 Sort By",
                        "enum": [
                            "relevance",
                            "hot",
                            "top",
                            "new",
                            "comments"
                        ],
                        "type": "string",
                        "description": "Sort results by relevance, hot, top, new, or comment count"
                    },
                    "time_filter": {
                        "title": "⏰ Time Filter",
                        "enum": [
                            "all",
                            "hour",
                            "day",
                            "week",
                            "month",
                            "year"
                        ],
                        "type": "string",
                        "description": "Filter results to posts published within a set time period"
                    },
                    "max_posts": {
                        "title": "📊 Max Posts",
                        "minimum": 1,
                        "maximum": 1000000,
                        "type": "integer",
                        "description": "Maximum number of posts to find per search"
                    },
                    "max_comments": {
                        "title": "💬 Max Comments",
                        "minimum": 0,
                        "maximum": 1000000,
                        "type": "integer",
                        "description": "Maximum number of comments to get per post, 0 to skip"
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
