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

Reddit keyword search scraper that finds viral posts across communities and exports 40 post fields with engagement metrics, media, and crosspost spread. Five sort modes, time windows, optional bounded comments; Reddit search caps near 250 results per query. From $3.75 per 1,000 posts.

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

## Pricing

from $3.75 / 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

**Reddit Viral Scraper is a reddit keyword search scraper that turns one topic into structured post records from communities returned by Reddit search, including engagement, media, polls, crosspost spread, and optional comments.** It is designed for research workflows that begin with a subject rather than a known account or community.

[![Apify Users](https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fapi.apify.com%2Fv2%2Facts%2Fagentx~reddit-viral-scraper\&query=%24.data.stats.totalUsers\&style=for-the-badge\&label=Apify%20Users\&color=ff9013)](https://apify.com/agentx/reddit-viral-scraper) [![Apify Runs](https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fapi.apify.com%2Fv2%2Facts%2Fagentx~reddit-viral-scraper\&query=%24.data.stats.totalRuns\&style=for-the-badge\&label=Apify%20Runs\&color=ff9013)](https://apify.com/agentx/reddit-viral-scraper) [![price](https://img.shields.io/badge/%240.00500%20%2F%20result-4285f4?style=for-the-badge)](https://apify.com/agentx/reddit-viral-scraper/pricing) [![capability](https://img.shields.io/badge/52%20post%20fields-34a853?style=for-the-badge)](https://console.apify.com/actors/dM1WGhL57QQWIRlJG/input) [![API + MCP ready](https://img.shields.io/badge/API%20%2B%20MCP%20ready-fbbc05?style=for-the-badge)](https://apify.com/agentx/reddit-viral-scraper/api)

- **Five required controls** define the keyword, Reddit sort mode, source time window, post cap, and optional comment depth.
- **52 top-level Dataset fields** retain post identity, community and author IDs, engagement, media, gallery, video, poll, state, crosspost, discussion, and provenance facts.
- **Viral discovery stays explainable** because the Actor returns Reddit's source ordering, scores, comment counts, upvote ratio, and duplicate-link spread instead of inventing a proprietary virality label.
- **Large comment threads stay bounded by input** while a 2,000-comment built-image probe returned 2,000 unique comments with resolved reply levels.

The smallest useful FREE-tier run uses one post and no comments; one Actor Start plus one Result costs at most **$0.01500** under the configured price contract.

### Why Choose Reddit Viral Scraper

**Topic-first discovery.** Search a product, event, organization, phrase, or research theme across the communities Reddit returns instead of choosing a subreddit in advance.

**Source ranking without invented scores.** Select relevance, hot, top, new, or comments and keep the source-reported values needed to build your own downstream threshold.

**Cross-community spread.** `crossposts`, `crosspost_id`, `crosspost_url`, and `duplicates` show when a post or target link appears in other communities.

**Rich media and discussion context.** Results can carry image arrays, gallery captions, Reddit-hosted video facts, poll options and vote totals, and an optional nested comment sample.

**Stable automation shape.** Every Dataset row uses the same 52-field contract and ends with `processor` and an ISO `processed_at` timestamp.

### Quick Start Guide

#### Configure

Open the Actor input and enter the topic you want to monitor. Choose the ordering and time window that match the question: `new/day` for recent mentions, `comments/week` for active discussions, or `top/year` for strong historical engagement.

#### Run

The public prefill is deliberately small enough for a recurring liveness test:

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

#### Collect

Open the default Dataset after the run succeeds. JSON or JSONL preserves nested comments, galleries, polls, images, and duplicate arrays; CSV or Excel is convenient when only flat post metrics are needed.

### Input Parameters

Reddit Viral Scraper exposes five required inputs in schema order and sends no hidden keyword, community, or date filters.

| Parameter | Type | Required | Description | Prefill |
| --- | --- | --- | --- | --- |
| `keyword` | string, 1–512 characters | Yes | Topic or phrase sent to Reddit search | `artificial intelligence` |
| `sort_by` | enum | Yes | `relevance`, `hot`, `top`, `new`, or `comments` | `relevance` |
| `time_filter` | enum | Yes | `all`, `hour`, `day`, `week`, `month`, or `year` | `all` |
| `max_posts` | integer, minimum 1 | Yes | Maximum post rows requested | `1` |
| `max_comments` | integer, minimum 0 | Yes | Maximum comments retained per post; `0` skips comment reads | `0` |

Neither numeric input has a configured maximum. The cap is a request boundary rather than a source-inventory promise: in a real broad-query probe, Reddit returned 230 posts and then ended even when 300 or 1,000 were requested.

### Output Data Schema

One Dataset row represents one Reddit post; the public contract has 52 top-level fields.

| Group | Fields |
| --- | --- |
| Community | `subreddit`, `subreddit_id`, `subreddit_type`, `subreddit_subscribers` |
| Post identity and text | `id`, `url`, `title`, `body`, `flair_text`, `created`, `edited` |
| Author | `author`, `author_id`, `author_flair` |
| Engagement and spread | `score`, `score_hidden`, `upvote_ratio`, `comment_count`, `crossposts`, `crosspost_id`, `crosspost_url`, `duplicates` |
| State | `archived`, `locked`, `stickied`, `over_18`, `spoiler`, `original`, `removed_by`, `gilded`, `distinguished`, `categories` |
| Media | `media_type`, `domain`, `thumbnail`, `images`, `gallery`, `media_url`, `video_url`, `video_duration`, `video_width`, `video_height`, `video_bitrate`, `has_audio`, `is_gif`, `is_self`, `is_video`, `is_gallery` |
| Discussion and polls | `poll`, `comments` |
| Provenance | `processor`, `processed_at` |

An abbreviated post row:

```json
{
  "subreddit": "AskReddit",
  "id": "1ub2f4v",
  "author": "example_user",
  "url": "https://www.reddit.com/r/AskReddit/comments/1ub2f4v/example/",
  "title": "What scares you most about artificial intelligence?",
  "score": 2,
  "upvote_ratio": 0.67,
  "comment_count": 98,
  "crossposts": 0,
  "is_self": true,
  "media_url": null,
  "duplicates": [],
  "comments": [],
  "processed_at": "2026-08-12T11:31:12+00:00"
}
```

Unavailable values remain null or empty according to the schema. Reddit can fuzz or hide engagement values, so `score` is a source snapshot rather than an audited vote count.

### Integration Examples

Reddit Viral Scraper can run from Console, the Apify API, official clients, schedules, webhooks, Make, n8n, or the Apify MCP server.

#### Actor ID

```text
dM1WGhL57QQWIRlJG
```

Also addressable by name as `agentx/reddit-viral-scraper` — both forms work in the API, the SDKs, Make.com, and n8n.

#### HTTP

```bash
curl -X POST "https://api.apify.com/v2/acts/dM1WGhL57QQWIRlJG/runs?token=YOUR_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"keyword":"artificial intelligence","sort_by":"relevance","time_filter":"all","max_posts":1,"max_comments":0}'
```

#### Python

```python
from apify_client import ApifyClient

client = ApifyClient("YOUR_APIFY_TOKEN")
run = client.actor("dM1WGhL57QQWIRlJG").call(run_input={
    "keyword": "artificial intelligence",
    "sort_by": "relevance",
    "time_filter": "all",
    "max_posts": 1,
    "max_comments": 0,
})
items = list(client.dataset(run["defaultDatasetId"]).iterate_items())
```

#### JavaScript

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

const client = new ApifyClient({ token: 'YOUR_APIFY_TOKEN' });
const run = await client.actor('dM1WGhL57QQWIRlJG').call({
  keyword: 'artificial intelligence',
  sort_by: 'relevance',
  time_filter: 'all',
  max_posts: 1,
  max_comments: 0,
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
```

#### Make.com and n8n

Use the Apify integration to run Actor ID `dM1WGhL57QQWIRlJG`, wait for completion, and pass default Dataset items to the next module or node. Preserve JSON when nested arrays matter.

#### MCP

Connect the official [Apify MCP server](https://docs.apify.com/integrations/mcp), expose this Actor, and give the agent the same five-field input object. Keep post and comment limits small until the workflow is verified.

### Pricing

Reddit Viral Scraper uses pay-per-event pricing with one start event and separate post Result and retained Comment events.

| Event | FREE | BRONZE | SILVER | GOLD | PLATINUM | DIAMOND |
| --- | ---: | ---: | ---: | ---: | ---: | ---: |
| Actor Start | $0.01000 | $0.01000 | $0.01000 | $0.01000 | $0.01000 | $0.01000 |
| Result | $0.00500 | $0.00450 | $0.00400 | $0.00375 | $0.00375 | $0.00375 |
| Comment | $0.00100 | $0.00090 | $0.00080 | $0.00075 | $0.00075 | $0.00075 |

The start event is one-time, subject to the configured memory rule. A comment is charged only when it is retained in a post result. Use `max_comments: 0` for post-only discovery and set a maximum total charge before scaling.

### Use Cases

Reddit Viral Scraper supports topic monitoring and research where public Reddit search results are an appropriate source.

- **Brand and product monitoring** — find posts that mention a name across returned communities.
- **Trend research** — compare `new`, `top`, and `comments` within fixed time windows.
- **Community spread analysis** — inspect crosspost identifiers and duplicate target links.
- **Content research** — collect titles, text, media, galleries, videos, and polls around a theme.
- **Discussion sampling** — retain a bounded comment set for downstream classification or review.
- **Scheduled snapshots** — rerun a stable query and compare `processed_at`, ranking, and engagement fields.

### Alternatives

Choose the access method that matches the workflow and authorization model.

| Alternative | Best when | Trade-off |
| --- | --- | --- |
| Reddit Data API | You have OAuth credentials and the permissions required for your use | Official integration surface; commercial use may require Reddit approval or a contract |
| An API-styled Reddit search product | Your developer workflow is organized around API-style structured search | Same source capability under a different product shape and price |
| Subreddit Posts Scraper | You already know the community to crawl | Community-first rather than keyword-first discovery |
| Manual Reddit search | You need a few results once | No repeatable Dataset, scheduling, API, or provenance |

This Actor is not Reddit's official API and is not affiliated with Reddit.

### Limits and Troubleshooting

Reddit source availability, ranking, and public visibility determine what a run can return.

- **Fewer posts than requested:** Reddit ended the search, the keyword/window has fewer visible matches, or duplicate IDs were removed. A measured broad query stopped at 230.
- **No result:** try a broader keyword, `time_filter: all`, or a different sort after a few minutes; a temporary browser/proxy wall is reported separately from a valid empty search.
- **Slow comment runs:** reduce `max_comments` or the number of posts. A 2,000-comment probe completed in about 24 seconds, but source and network conditions vary.
- **Empty comments with a nonzero source count:** local or platform event limits can retain fewer comments than collected; the terminal status distinguishes shipped from collected counts.
- **Null media or author fields:** the post may be text-only, deleted, removed, or missing that source value. Null is not replaced with an invented value.
- **Large requests:** the Actor has no configured numeric maximum, but a larger cap does not extend Reddit's own result inventory.

### Trust and Reliability

The Actor preserves source facts, bounded failure states, and explicit provenance instead of silently converting unread paths into empty content.

The 2026-08-12 built-image design run sampled 1,199 posts across all sort modes and time windows, including galleries, videos, polls, crossposts, comment trees, withheld comment IDs, and duplicate paths. The 52-field Dataset contract, input validation, pricing cutover, browser gate, memory floor, and real lifecycle were validated before this README update.

### Legal and Compliance

Use Reddit Viral Scraper only for lawful workflows that respect Reddit's terms, privacy expectations, intellectual-property rights, and applicable data-protection rules.

Reddit's official [Data API wiki](https://support.reddithelp.com/hc/en-us/articles/16160319875092-Reddit-Data-API-Wiki) explains OAuth access, while its [data access guidance](https://support.reddithelp.com/hc/en-us/articles/14945211791892-Developer-Platform-Accessing-Reddit-Data) describes approval requirements for commercial uses. This Actor uses its own public signed-out browser path and does not grant official API rights or permission to republish personal data. Minimize stored data, protect exports, and honor valid deletion or access requests that apply to your workflow.

### Frequently Asked Questions

#### How do I search reddit posts by keyword?

Set `keyword`, choose `sort_by` and `time_filter`, keep `max_posts` small for the first run, and set `max_comments` to `0` unless thread content is required.

#### How do I find viral reddit posts?

Use source signals rather than a hidden label: try `top` or `comments` inside a fixed time window, then rank the returned `score`, `comment_count`, `upvote_ratio`, `crossposts`, and `duplicates` according to your own definition.

#### Does the Actor predict which post will become viral?

No. It returns Reddit search ordering and source-reported engagement facts; forecasting and thresholds belong in downstream analysis.

#### Can I search one subreddit only?

No subreddit input is exposed. Use Subreddit Posts Scraper when the community is already known.

#### Do I need a Reddit account or API key?

No Reddit credential is requested from the user. You need an Apify account and token for API-based Actor runs.

#### Why did a request for 1,000 posts return about 230?

`max_posts` controls the Actor's stop point, not Reddit's source inventory. In the measured broad query, Reddit ended after 230 unique posts.

#### Are comments complete discussion archives?

Only up to `max_comments` are retained for each post, and source availability still applies. Use the limit as a bounded sample unless your run evidence proves otherwise.

#### Are Reddit scores exact vote totals?

No. Reddit can fuzz or hide engagement values; treat each value as a time-stamped source observation.

### Related AgentX Actors

AgentX publishes 77 Actors — the three closest Reddit workflows first, then the full catalog by category.

Closest to this Actor:

- [Subreddit Posts Scraper](https://apify.com/agentx/subreddit-posts-scraper) — collects posts from a community you already know.
- [Reddit Profile Scraper](https://apify.com/agentx/reddit-profile-scraper) — turns a known username into profile and activity data.
- [SubReddit Info Scraper](https://apify.com/agentx/subreddit-info-scraper) — returns community identity, audience, rules, and settings.

#### Business and Market Intelligence

- **[All Web Search Scraper](https://apify.com/agentx/all-web-search-scraper)** — multi-engine web search across ten independent indexes
- **[Google Keyword Trends](https://apify.com/agentx/google-keyword-trends)** — Google Trends keyword interest, compared five at a time
- **[Google Trends Scraper](https://apify.com/agentx/google-trends-scraper)** — Google Trends trending searches
- **[Google Maps Store Scraper](https://apify.com/agentx/google-maps-store-scraper)** — Google Maps business listings
- **[LinkedIn Company Lookup](https://apify.com/agentx/linkedin-company-lookup)** — LinkedIn company records
- **[LinkedIn Profile Lookup](https://apify.com/agentx/linkedin-profile-lookup)** — LinkedIn profile records
- **[Weather Forecast API](https://apify.com/agentx/weather-forecast-api)** — forecast and historical weather data

#### Jobs and Hiring

- **[All Jobs Scraper](https://apify.com/agentx/all-jobs-scraper)** — multi-platform job listings
- **[Bayt Jobs Scraper](https://apify.com/agentx/bayt-jobs-scraper)** — Bayt job listings
- **[Glassdoor Jobs Scraper](https://apify.com/agentx/glassdoor-jobs-scraper)** — Glassdoor job listings
- **[Indeed Jobs Scraper](https://apify.com/agentx/indeed-jobs-scraper)** — Indeed job listings
- **[JobStreet Company Profile](https://apify.com/agentx/jobstreet-company-profile)** — JobStreet employer records
- **[Jooble Jobs Scraper](https://apify.com/agentx/jooble-jobs-scraper)** — Jooble job listings
- **[LinkedIn Jobs Scraper](https://apify.com/agentx/linkedin-jobs-scraper)** — LinkedIn job listings
- **[Naukri Jobs Scraper](https://apify.com/agentx/naukri-jobs-scraper)** — Naukri job listings
- **[Talent Jobs Scraper](https://apify.com/agentx/talent-jobs-scraper)** — Talent.com job listings
- **[ZipRecruiter Jobs Scraper](https://apify.com/agentx/ziprecruiter-jobs-scraper)** — ZipRecruiter job listings

#### Social Media

- **[All Forums Thread Scraper](https://apify.com/agentx/all-forums-thread-scraper)** — multi-platform forum and Q\&A threads
- **[Instagram Creator Scraper](https://apify.com/agentx/instagram-creator-scraper)** — Instagram creator profiles
- **[Instagram Reels Scraper](https://apify.com/agentx/instagram-reels-scraper)** — Instagram Reels metadata
- **[Instagram Trending Scraper](https://apify.com/agentx/instagram-trending-scraper)** — Instagram trending content
- **[Medium Scraper](https://apify.com/agentx/medium-scraper)** — Medium articles
- **[Medium Profile Scraper](https://apify.com/agentx/medium-profile-scraper)** — Medium author profiles
- **[Reddit Profile Scraper](https://apify.com/agentx/reddit-profile-scraper)** — Reddit user profiles
- **[SubReddit Info Scraper](https://apify.com/agentx/subreddit-info-scraper)** — subreddit metadata
- **[Subreddit Members Scraper](https://apify.com/agentx/subreddit-members-scraper)** — subreddit member lists
- **[Subreddit Posts Scraper](https://apify.com/agentx/subreddit-posts-scraper)** — subreddit post feeds
- **[Telegram Chat Scraper](https://apify.com/agentx/telegram-chat-scraper)** — Telegram chat messages
- **[Telegram Info Scraper](https://apify.com/agentx/telegram-info-scraper)** — Telegram channel metadata
- **[Telegram Member Adder](https://apify.com/agentx/telegram-member-adder)** — Telegram group membership management
- **[Telegram Member Scraper](https://apify.com/agentx/telegram-member-scraper)** — Telegram group members
- **[Telegram Private Group Scraper](https://apify.com/agentx/telegram-private-group-scraper)** — private Telegram group data
- **[TikTok Creator API](https://apify.com/agentx/tiktok-creator-api)** — TikTok creator profiles
- **[TikTok User Lookup](https://apify.com/agentx/tiktok-user-lookup)** — TikTok account records
- **[X Twitter Community API](https://apify.com/agentx/x-twitter-community-api)** — X community data
- **[X Twitter Profile Lookup](https://apify.com/agentx/x-twitter-profile-lookup)** — X profile records
- **[YouTube Creator Email Scraper](https://apify.com/agentx/youtube-creator-email-scraper)** — YouTube creator contact data

#### Video, Transcripts and Downloads

- **[All Video Scraper](https://apify.com/agentx/all-video-scraper)** — multi-platform video metadata
- **[All Short Videos Scraper](https://apify.com/agentx/all-short-videos-scraper)** — short-video keyword search across two independent indexes
- **[All Image Scraper](https://apify.com/agentx/all-image-scraper)** — image search and download across five engines
- **[All Short Drama Downloader](https://apify.com/agentx/all-short-drama-downloader)** — short-drama episodes from fifteen official apps
- **[Video Transcript](https://apify.com/agentx/video-transcript)** — multi-platform transcripts
- **[Video Captions Downloader](https://apify.com/agentx/video-captions-downloader)** — caption files
- **[Video to Social Post](https://apify.com/agentx/video-to-social-post)** — video repurposed into social copy
- **[YouTube Transcript](https://apify.com/agentx/youtube-transcript)** — YouTube transcripts
- **[TikTok Transcript](https://apify.com/agentx/tiktok-transcript)** — TikTok transcripts
- **[X Twitter Transcript](https://apify.com/agentx/x-twitter-transcript)** — X video transcripts
- **[Facebook Transcript](https://apify.com/agentx/facebook-transcript)** — Facebook video transcripts
- **[Bilibili Transcript](https://apify.com/agentx/bilibili-transcript)** — Bilibili transcripts
- **[Dailymotion Transcript](https://apify.com/agentx/dailymotion-transcript)** — Dailymotion transcripts
- **[Rutube Transcript](https://apify.com/agentx/rutube-transcript)** — Rutube transcripts
- **[Loom Transcript](https://apify.com/agentx/loom-transcript)** — Loom transcripts
- **[Wistia Transcript](https://apify.com/agentx/wistia-transcript)** — Wistia transcripts
- **[Instagram Reels Downloader](https://apify.com/agentx/instagram-reels-downloader)** — Reels downloads
- **[Kick Clip Downloader](https://apify.com/agentx/kick-clip-downloader)** — Kick clip downloads
- **[Linkedin Video Downloader](https://apify.com/agentx/linkedin-video-downloader)** — LinkedIn video downloads
- **[Pinterest Video Downloader](https://apify.com/agentx/pinterest-video-downloader)** — Pinterest video downloads
- **[Reddit Video Downloader](https://apify.com/agentx/reddit-video-downloader)** — Reddit video downloads
- **[Snapchat Video Downloader](https://apify.com/agentx/snapchat-video-downloader)** — Snapchat video downloads
- **[TED Talk Downloader](https://apify.com/agentx/ted-talk-downloader)** — TED talk downloads
- **[TikTok Live Downloader](https://apify.com/agentx/tiktok-live-downloader)** — TikTok live downloads
- **[Twitch VOD Downloader](https://apify.com/agentx/twitch-vod-downloader)** — Twitch VOD downloads
- **[Zoom Recording Downloader](https://apify.com/agentx/zoom-recording-downloader)** — Zoom recording downloads

#### E-Commerce and Retail

- **[All Shopping Scraper](https://apify.com/agentx/all-shopping-scraper)** — multi-platform product data
- **[AliExpress Product Scraper](https://apify.com/agentx/aliexpress-product-scraper)** — AliExpress products
- **[Amazon Storefront Scraper](https://apify.com/agentx/amazon-storefront-scraper)** — Amazon Brand Store pages
- **[Bol Product Scraper](https://apify.com/agentx/bol-product-scraper)** — Bol.com products
- **[eBay Seller Leads API](https://apify.com/agentx/ebay-seller-leads-api)** — eBay seller records
- **[Hepsiburada Product Scraper](https://apify.com/agentx/hepsiburada-product-scraper)** — Hepsiburada products
- **[Kakaku Product Scraper](https://apify.com/agentx/kakaku-product-scraper)** — Kakaku.com products
- **[Rakuten Product Scraper](https://apify.com/agentx/rakuten-product-scraper)** — Rakuten products

#### Classifieds and Automotive

- **[All Vehicle Scraper](https://apify.com/agentx/all-vehicle-scraper)** — multi-platform vehicle listings
- **[AutoTrader Vehicle Search](https://apify.com/agentx/autotrader-vehicle-search)** — AutoTrader US listings
- **[AutoTrader UK Vehicle Search](https://apify.com/agentx/autotrader-uk-vehicle-search)** — AutoTrader UK listings

#### Real Estate

- **[All Property Scraper](https://apify.com/agentx/all-property-scraper)** — multi-platform property listings
- **[Homes Property Scraper](https://apify.com/agentx/homes-property-scraper)** — Homes.com listings
- **[MagicBricks Property Scraper](https://apify.com/agentx/magicbricks-property-scraper)** — MagicBricks listings
- **[NoBroker Property Scraper](https://apify.com/agentx/nobroker-property-scraper)** — NoBroker listings
- **[Property24 Property Scraper](https://apify.com/agentx/property24-property-scraper)** — Property24 listings
- **[Realtor Property Scraper](https://apify.com/agentx/realtor-property-scraper)** — Realtor.com listings
- **[Zillow Property Scraper](https://apify.com/agentx/zillow-property-scraper)** — Zillow listings

### Support and Community

Ask about Reddit keyword searches, result limits, billing, and exports in the [AgentX community on Telegram](https://t.me/Apify_Actor); for a reproducible bug, open an Issue with the run ID and exact input.

AgentX is an Arcyton brand — [arcyton.com](https://arcyton.com).

**Last Updated:** August 15, 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`):

Posts to return, minimum 1 and no upper limit. A broad measured search stopped at 230 unique posts after three pages even when 300 or 1,000 were requested.

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

Comments per post, minimum 0 and no upper limit. A comment tree returns about 450 in one read and names the rest, which this actor then resolves in bounded rounds. Set 0 to skip comments entirely.

## Actor input object example

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

# Actor output Schema

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

Browse the normalized Reddit posts, media, engagement, crosspost sources, polls, galleries, and retained comments.

# 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(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 '{
  "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": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,agentx/reddit-viral-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/dM1WGhL57QQWIRlJG/builds/fAr8oe81OIi3d7tbV/openapi.json