Reddit Viral Scraper

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.

• 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:

{
  "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:

{
  "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

dM1WGhL57QQWIRlJG

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

HTTP

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

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

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, 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 explains OAuth access, while its data access guidance 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 — collects posts from a community you already know.
• Reddit Profile Scraper — turns a known username into profile and activity data.
• SubReddit Info Scraper — returns community identity, audience, rules, and settings.

Business and Market Intelligence

• Google Keyword Trends — Google Trends keyword interest, compared five at a time
• Google Trends Scraper — Google Trends trending searches
• Google Maps Store Scraper — Google Maps business listings
• LinkedIn Company Lookup — LinkedIn company records
• LinkedIn Profile Lookup — LinkedIn profile records
• Weather Forecast API — forecast and historical weather data

Jobs and Hiring

• All Jobs Scraper — multi-platform job listings
• Bayt Jobs Scraper — Bayt job listings
• Glassdoor Jobs Scraper — Glassdoor job listings
• Indeed Jobs Scraper — Indeed job listings
• JobStreet Company Profile — JobStreet employer records
• Jooble Jobs Scraper — Jooble job listings
• LinkedIn Jobs Scraper — LinkedIn job listings
• Naukri Jobs Scraper — Naukri job listings
• Talent Jobs Scraper — Talent.com job listings
• ZipRecruiter Jobs Scraper — ZipRecruiter job listings

Social Media

• Instagram Creator Scraper — Instagram creator profiles
• Instagram Reels Scraper — Instagram Reels metadata
• Instagram Trending Scraper — Instagram trending content
• Medium Scraper — Medium articles
• Medium Profile Scraper — Medium author profiles
• Reddit Profile Scraper — Reddit user profiles
• SubReddit Info Scraper — subreddit metadata
• Subreddit Members Scraper — subreddit member lists
• Subreddit Posts Scraper — subreddit post feeds
• Telegram Chat Scraper — Telegram chat messages
• Telegram Info Scraper — Telegram channel metadata
• Telegram Member Adder — Telegram group membership management
• Telegram Member Scraper — Telegram group members
• Telegram Private Group Scraper — private Telegram group data
• TikTok Creator API — TikTok creator profiles
• X Twitter Community API — X community data
• X Twitter Profile Lookup — X profile records
• YouTube Creator Email Scraper — YouTube creator contact data

Video, Transcripts and Downloads

• All Video Scraper — multi-platform video metadata
• Video Transcript — multi-platform transcripts
• Video Captions Downloader — caption files
• Video to Social Post — video repurposed into social copy
• YouTube Transcript — YouTube transcripts
• TikTok Transcript — TikTok transcripts
• X Twitter Transcript — X video transcripts
• Facebook Transcript — Facebook video transcripts
• Bilibili Transcript — Bilibili transcripts
• Dailymotion Transcript — Dailymotion transcripts
• Rutube Transcript — Rutube transcripts
• Loom Transcript — Loom transcripts
• Wistia Transcript — Wistia transcripts
• Live Stream Transcript — live stream transcripts
• Instagram Reels Downloader — Reels downloads
• Kick Clip Downloader — Kick clip downloads
• Linkedin Video Downloader — LinkedIn video downloads
• Pinterest Video Downloader — Pinterest video downloads
• Reddit Video Downloader — Reddit video downloads
• Snapchat Video Downloader — Snapchat video downloads
• TED Talk Downloader — TED talk downloads
• TikTok Live Downloader — TikTok live downloads
• Twitch VOD Downloader — Twitch VOD downloads
• Zoom Recording Downloader — Zoom recording downloads

E-Commerce and Retail

• All Shopping Scraper — multi-platform product data
• AliExpress Product Scraper — AliExpress products
• Amazon Storefront Scraper — Amazon Brand Store pages
• Bol Product Scraper — Bol.com products
• eBay Seller Leads API — eBay seller records
• Hepsiburada Product Scraper — Hepsiburada products
• Kakaku Product Scraper — Kakaku.com products
• Rakuten Product Scraper — Rakuten products

Classifieds and Automotive

• All Vehicle Scraper — multi-platform vehicle listings
• AutoTrader Vehicle Search — AutoTrader US listings
• AutoTrader UK Vehicle Search — AutoTrader UK listings

Real Estate

• All Property Scraper — multi-platform property listings
• Homes Property Scraper — Homes.com listings
• MagicBricks Property Scraper — MagicBricks listings
• NoBroker Property Scraper — NoBroker listings
• Property24 Property Scraper — Property24 listings
• Realtor Property Scraper — Realtor.com listings
• Zillow Property Scraper — Zillow listings

Support and Community

Ask about Reddit keyword searches, result limits, billing, and exports in the AgentX community on Telegram; for a reproducible bug, open an Issue with the run ID and exact input.

AgentX is an Arcyton brand — arcyton.com.

Last Updated: August 15, 2026