# Reddit Real-Time Data Scraper – Fast Reddit API Alternative (`b2b_leads/reddit-real-time-data-scraper-fast-reddit-api-alternative`) Actor Scrape Reddit posts, comments, users, subreddits, search & trending in real time. Fast, lightweight, no API key, no browser. Export clean JSON/CSV with rich data points — 8 tools in one. Built-in proxy, MCP-ready, schedule for live monitoring & alerts. - **URL**: https://apify.com/b2b\_leads/reddit-real-time-data-scraper-fast-reddit-api-alternative.md - **Developed by:** [Chidubem Aneke](https://apify.com/b2b_leads) (community) - **Categories:** Social media, Lead generation, MCP servers - **Stats:** 1 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $0.25 / 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. 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 Real-Time Data — The Fastest Reddit Scraper on Apify **Blazing-fast, incredibly light, and packed with rich data.** This Actor delivers **live posts, comments, users, subreddits, search, trending, and keyword matches** as clean, deeply-structured JSON — with **zero Reddit API keys**, **no browser**, and **built-in residential proxy** support. **Stop fighting Reddit blocks and rate limits.** Turn on only the features you need, click **Start**, and export or pipe results to Slack, Sheets, Zapier, or your own API in seconds. > ⚡ **Built for speed & cost.** No Chromium. No Playwright. A lightweight, optimized data engine — so it runs in **milliseconds per request**, uses as little as **256–512 MB RAM**, and costs a fraction of browser-based scrapers. --- ### ⚡ Incredibly fast — here's why Most Reddit scrapers spin up a full headless browser (Chromium) for every page. That's slow, memory-hungry, and expensive. **This Actor doesn't.** It uses a lightweight, purpose-built data engine instead. | Metric | This Actor | Typical browser-based scraper | |--------|-----------|-------------------------------| | **Per-request latency** | **~50–150 ms** | 2–8 seconds (browser boot + render) | | **Engine** | Lightweight, no browser | Playwright + Chromium | | **Default memory** | **512 MB** (runs on 256 MB) | 2–4 GB | | **Startup overhead** | Near-zero | Heavy (launch browser per page) | | **Cost per 1,000 items** | **Pennies** | Multiples higher | | **Pagination** | Bulk fetch — **many items per request** | 1 page per browser render | **Real numbers:** it fetches posts and comments in **efficient bulk batches** and auto-paginates for you, so pulling **thousands of fully-detailed records** takes just a handful of requests — often finishing a run in **under a few seconds**. Set any target you want; the Actor keeps paging until it's done. Schedule it every minute for true real-time monitoring without burning compute. --- ### Why teams choose this Actor - **⚡ Extremely fast** — lightweight engine, ~50–150 ms/request, efficient bulk fetching with auto-pagination - **🪶 Ultra-light & cheap** — 512 MB default, no browser, lowest possible Apify cost - **📊 Very rich data points** — ~45 post fields, nested comment trees, full karma breakdowns, awards, media, galleries, flair, subreddit rules & moderators - **🧰 Eight tools in one** — subreddit posts, post threads, search, user profiles, subreddit info, trending, URL scraper, keyword monitor - **✅ No API key required** — works out of the box with zero Reddit developer setup - **☑️ Checkbox UX** — enable only what you need; pay only for what you scrape - **🤖 MCP-friendly** — documented input/output schemas and copy-paste JSON for Apify MCP & LLM agents - **🔌 Apify-native** — schedule runs, webhooks, REST API, CSV/Excel/JSON export out of the box --- ### Who is this for? | You are… | You get… | |----------|----------| | **Brand / social monitoring team** | Keyword alerts across subreddits on a schedule | | **Market researcher** | Voice-of-customer threads, sentiment corpora, trend feeds | | **Data scientist** | Clean JSON posts + comments for NLP and topic modeling | | **Finance / crypto analyst** | Real-time subreddit pulse (e.g. ticker mentions) | | **Content marketer** | Trend discovery and subreddit targeting | | **Developer / integrator** | A practical **Reddit data API alternative** without developer onboarding | --- ### Rich data points — not just headlines Every record is deep and analysis-ready. We surface a **curated, well-named set of 100+ available data points per post** so you get everything useful without the noise — and you can flip on `includeRaw` to get the complete raw object too. **Per post (~45 fields):** `id`, `fullname`, `title`, `selftext`, `selftextHtml`, `url`, `permalink`, `subreddit`, `subredditId`, `subredditSubscribers`, `author`, `authorFullname`, `authorFlairText`, `authorPremium`, `createdUtc`, `createdAtISO`, `edited`, `score`, `upvoteRatio`, `ups`, `numComments`, `numCrossposts`, `nsfw`, `spoiler`, `locked`, `stickied`, `pinned`, `archived`, `distinguished`, `isOriginalContent`, `isSelf`, `isVideo`, `postHint`, `domain`, `linkFlairText`, `thumbnail`, `media` (video URL + duration + dimensions), `previewImages[]` (multi-resolution), `gallery[]` (album images), `pollData`, `totalAwardsReceived`, `awards[]`, `crosspostParentId`, `removedByCategory`, `contestMode`, `suggestedSort`. **Per comment (~22 fields):** full body + HTML, `score`, `depth`, `parentId`, `postId`, `isSubmitter` (OP flag), `distinguished`, `stickied`, `controversiality`, `permalink`, `awards`, and nested `replies` when you want the whole tree. **Per user (~20 fields):** `linkKarma`, `commentKarma`, `totalKarma`, `awarderKarma`, `awardeeKarma`, `accountAgeDays`, `isGold`, `isMod`, `isEmployee`, `verified`, `hasVerifiedEmail`, avatar images, and profile description. **Per subreddit (~25 fields):** `subscribers`, `activeUserCount`, `publicDescription`, full `description`, `over18`, `lang`, icons/banners, `primaryColor`, `submissionType`, `rules[]`, and `moderators[]`. Every row is tagged with `featureType` and `scrapedAt`. Filter by `featureType`, download CSV/Excel/JSON, or hit the dataset API — the same clean workflow for every feature. --- ### Eight features — use one or all #### 🔥 Subreddit Posts *(on by default)* Posts from any subreddit by `hot`, `new`, `top`, `rising`, or `controversial` with pagination. *Example:* `technology` + `programming`, hot sort, 50 posts each. --- #### 💬 Post & Comments Full post + nested comment thread with depth control and "load more" expansion. *Example:* Paste a viral thread URL → post row + hundreds of comment rows. --- #### 🔎 Search Keyword search site-wide or scoped to subreddits; filter by time and sort. *Example:* `"openai"` across all Reddit, top posts this week. --- #### 👤 User Profile User about page + submitted posts + comments with karma breakdown. *Example:* Track a power user's recent activity and account age. --- #### 🏷️ Subreddit Info Subreddit about page, rules, optional moderators, subscriber counts. *Example:* Due diligence on a community before a campaign. --- #### 📈 Trending / Popular `r/popular`, `r/all`, or Reddit's trending subreddits list. *Example:* Morning pulse of what's rising across Reddit. --- #### 🔗 Scrape By URL Paste any Reddit URL — auto-detect post, subreddit, user, or search page. --- #### 🧵 Keyword Monitor Scan recent posts/comments in subreddits for keyword matches — perfect for **scheduled real-time alerts**. *Example:* Monitor `technology` + `startups` for `"your brand"` every 5 minutes via webhook. --- ### How to run 1. Click **Start** on this Actor page. 2. **Check the features** you need — uncheck Subreddit Posts if you only want search, comments, or monitoring. 3. Fill in subreddits, URLs, queries, or keywords for enabled features. 4. Keep **Proxy → Residential US** (recommended). 5. Run — download results or connect a **webhook** / **schedule**. **Pro tip:** Schedule the Keyword Monitor every few minutes and webhook matches to Slack for real-time brand alerts. --- ### Example inputs (API, MCP, and automation) Use these JSON payloads with the **Apify API**, **Apify MCP** (`call-actor`), or scheduled runs. **Important:** Subreddit Posts is **on by default**. When running a single feature via API or MCP, set `"enableSubredditPosts": false` and enable only what you need. #### Subreddit Posts only ```json { "enableSubredditPosts": true, "subreddits": ["technology", "programming"], "postSort": "hot", "postsPerSubreddit": 25 } ```` #### Post & Comments only ```json { "enableSubredditPosts": false, "enablePostComments": true, "postUrls": ["https://www.reddit.com/r/technology/comments/example/"], "maxCommentsPerPost": 200, "commentTreeFormat": "flat" } ``` #### Search only ```json { "enableSubredditPosts": false, "enableSearch": true, "searchQueries": ["machine learning"], "searchSort": "top", "searchTime": "week", "resultsPerQuery": 50 } ``` #### User Profile only ```json { "enableSubredditPosts": false, "enableUserProfile": true, "usernames": ["spez"], "userContent": "all", "itemsPerUser": 25 } ``` #### Subreddit Info only ```json { "enableSubredditPosts": false, "enableSubredditInfo": true, "infoSubreddits": ["technology"], "includeRules": true, "includeModerators": true } ``` #### Trending only ```json { "enableSubredditPosts": false, "enableTrending": true, "trendingSource": "popular", "trendingSort": "hot", "trendingLimit": 50 } ``` #### Keyword Monitor only ```json { "enableSubredditPosts": false, "enableCommentMonitor": true, "monitorSubreddits": ["technology", "startups"], "monitorKeywords": ["openai", "your brand"], "monitorStream": "both", "monitorLookback": 200 } ``` #### Scrape By URL only ```json { "enableSubredditPosts": false, "enableScrapeByUrl": true, "scrapeUrls": ["https://www.reddit.com/r/technology/"] } ``` Filter output rows by `featureType`. Dataset views: `overview`, `posts`, `comments`, `users`, `subreddits`, `search`, `monitor`. *** ### Output schema (key post fields) | Field | Type | Description | |-------|------|-------------| | `id` | string | Reddit base36 ID | | `fullname` | string | e.g. `t3_abc123` | | `title` | string | Post title | | `selftext` | string | Self-post body | | `url` | string | Link URL | | `permalink` | string | Reddit permalink | | `subreddit` | string | Community name | | `author` | string | Username | | `score` | number | Net upvotes | | `upvoteRatio` | number | 0–1 ratio | | `numComments` | number | Comment count | | `createdAtISO` | string | Post creation time | | `nsfw` | boolean | Over-18 flag | | `media` | object | Video metadata when present | | `previewImages` | array | Multi-resolution preview URLs | | `gallery` | array | Gallery image URLs | | `awards` | array | Award names and counts | | `linkFlairText` | string | Post flair | | `isVideo` | boolean | Native Reddit video | | `stickied` | boolean | Pinned post | Comment rows add: `body`, `depth`, `parentId`, `isSubmitter`, `controversiality`. User rows add: `linkKarma`, `commentKarma`, `totalKarma`, `accountAgeDays`, `isGold`, `isMod`. Subreddit rows add: `subscribers`, `activeUserCount`, `rules[]`, `moderators[]`. Set `"includeRaw": true` to attach the complete raw data object under `raw`. *** ### Example workflows **Brand monitoring** — Keyword Monitor on your subreddit list → schedule every 5 min → Slack webhook on matches. **VOC research** — Post & Comments on product mention threads → CSV export for sentiment analysis. **Trend report** — Trending + Subreddit Posts on niche communities → weekly rank snapshot. **Lead gen / community research** — Subreddit Info + Search → find active communities and top posts. *** ### Integrations Works with the full Apify ecosystem: - **Webhooks** on run success - **REST API** for dataset items - **Apify MCP** for LLM/agent automation - **Slack**, **Google Sheets**, **Zapier**, **Make**, **Airbyte**, custom ETL - **Scheduled runs** for hands-off monitoring *** ### This Actor vs alternatives | Approach | Problem | This Actor | |----------|---------|------------| | Manual copy-paste | Slow, doesn't scale | Automated & repeatable | | Reddit developer API | Paid / restricted / setup friction | **Zero-config** — no API key needed | | DIY Playwright scraper | Heavy, slow (2–8 s/page), 2–4 GB RAM, expensive | **Lightweight** — ~50–150 ms/request, 512 MB | | Generic scrapers | Thin fields, no comment trees | **Rich curated fields** + nested comments | You pay for the scrape you need — enable only the checkboxes that matter. Because it's lightweight and fetches records in efficient bulk batches, **you'll typically pay a fraction of what a browser-based Reddit scraper costs** for the same data. *** ### FAQ **Do I need a Reddit API key?**\ No. The Actor authenticates automatically. Optionally provide `redditClientId` / `redditClientSecret` for dedicated quota. **Which proxy should I use?**\ **Apify Proxy → Residential US** (default). Match proxy country to your target audience. **Can I run multiple features in one run?**\ Yes. Each record is tagged with `featureType` for easy filtering downstream. **How fast is it, really?**\ Very. It uses a lightweight data engine — no browser to boot — so each request lands in roughly **50–150 ms** and pulls **fully-detailed records in efficient bulk batches**. Most runs finish in seconds, making it ideal for minute-by-minute real-time monitoring. **Why is it so cheap to run?**\ No Chromium means a tiny image and as little as **256–512 MB RAM**, versus 2–4 GB for browser-based scrapers. Less compute + efficient bulk fetching = a fraction of the cost. **How do incremental monitor runs work?**\ Pass `sinceId` with the newest `fullname` from your last run — only newer items are returned. **Does Subreddit Posts run by default?**\ Yes. Uncheck it if you only want comments, search, monitoring, etc. **What memory should I use?**\ **512 MB** (default) works for most runs. Increase for large multi-feature batches. *** ### Get started now 1. Click **Try for free** or **Start**. 2. Pick your features and inputs. 3. Use **Residential proxy**. 4. Run — then **schedule** or **integrate**. **Blazing-fast Reddit data. Rich structured JSON. Zero API keys. Lowest cost.** *** ### Contact me Need something built beyond this Actor? I take on **custom projects** — from high-volume scraping actors and data pipelines to full **web applications** of any kind. | | | |---|---| | **Email** | | | **GitHub** | [github.com/DrunkCodes](https://github.com/DrunkCodes) | Reach out with your use case, timeline, and budget — whether it’s a one-off scraper, an Apify actor like this one, or a production web app. I’m happy to discuss scope and quote before we start. # Actor input Schema ## `enableSubredditPosts` (type: `boolean`): Fetch posts from one or more subreddits (hot, new, top, rising, controversial). Enabled by default. ## `subreddits` (type: `array`): Subreddit names or URLs (without r/ prefix is fine). Required when Subreddit Posts is enabled. ## `postSort` (type: `string`): How to sort subreddit post listings. ## `postTime` (type: `string`): Time window for top/controversial sorts. ## `postsPerSubreddit` (type: `integer`): Maximum posts to return per subreddit (1–1000). ## `enablePostComments` (type: `boolean`): Fetch a post plus its full comment thread. ## `postUrls` (type: `array`): Reddit post URLs or post IDs to scrape with comments. ## `commentSort` (type: `string`): Sort order for comments on each post. ## `maxCommentsPerPost` (type: `integer`): Maximum comments to collect per post (1–5000). ## `maxCommentDepth` (type: `integer`): Maximum nesting depth for comment threads. ## `expandMoreComments` (type: `boolean`): Follow Reddit "load more comments" placeholders for deeper threads. ## `commentTreeFormat` (type: `string`): flat = one row per comment; nested = nested replies on parent rows. ## `enableSearch` (type: `boolean`): Search Reddit by keyword site-wide or within subreddits. ## `searchQueries` (type: `array`): Keywords to search (1–20). Required when Search is enabled. ## `searchSubreddits` (type: `array`): Leave empty for site-wide search, or list subreddits to scope each query. ## `searchSort` (type: `string`): How to sort Reddit search results. ## `searchTime` (type: `string`): Time window for search results (applies to top and relevance sorts). ## `searchType` (type: `string`): Whether to return posts, subreddits, or users from search. ## `resultsPerQuery` (type: `integer`): Maximum results to return per search query (1–1000). ## `enableUserProfile` (type: `boolean`): Fetch Reddit user about info, submitted posts, and comments. ## `usernames` (type: `array`): Reddit usernames or profile URLs. ## `userContent` (type: `string`): Which user data to collect: profile about page, posts, comments, or all. ## `userSort` (type: `string`): Sort order for a user's submitted posts and comments. ## `itemsPerUser` (type: `integer`): Maximum posts or comments to return per user (1–1000). ## `enableSubredditInfo` (type: `boolean`): Fetch subreddit about page, rules, and optional moderators. ## `infoSubreddits` (type: `array`): Subreddit names for metadata scraping. ## `includeRules` (type: `boolean`): Fetch and include the subreddit's posted rules. ## `includeModerators` (type: `boolean`): Fetch and include the subreddit's moderator list. ## `enableTrending` (type: `boolean`): Fetch r/popular, r/all, or trending subreddits. ## `trendingSource` (type: `string`): Which Reddit trending feed to scrape: r/popular, r/all, or trending subreddits. ## `trendingSort` (type: `string`): Sort order for r/popular or r/all post listings. ## `trendingLimit` (type: `integer`): Maximum posts or trending subreddits to return (1–1000). ## `enableScrapeByUrl` (type: `boolean`): Paste any Reddit URL — auto-detect post, subreddit, user, or search page. ## `scrapeUrls` (type: `array`): Reddit URLs to scrape. ## `scrapeMaxItems` (type: `integer`): Maximum items to extract when scraping listing-type Reddit URLs. ## `enableCommentMonitor` (type: `boolean`): Scan recent posts or comments in subreddits for keyword matches — ideal for scheduled real-time monitoring. ## `monitorSubreddits` (type: `array`): Subreddits to watch for keyword matches. ## `monitorKeywords` (type: `array`): Case-insensitive keywords to match in titles, bodies, or comments. ## `monitorStream` (type: `string`): Whether to scan recent comments, posts, or both for keyword matches. ## `monitorLookback` (type: `integer`): Number of newest posts/comments to scan per subreddit. ## `sinceId` (type: `string`): Optional Reddit fullname (e.g. t1\_abc123) — only return items newer than this ID for incremental scheduled runs. ## `maxItems` (type: `integer`): Fallback cap used by features that do not define their own max. ## `includeNsfw` (type: `boolean`): Include posts and comments marked as over\_18 (NSFW). ## `includeRaw` (type: `boolean`): Attach the full raw data object under the raw field (larger output). ## `redditClientId` (type: `string`): Optional. Leave empty for zero-config access. Provide your own Reddit app client ID for dedicated quota. ## `redditClientSecret` (type: `string`): Optional companion secret for redditClientId. ## `proxyConfiguration` (type: `object`): Use Apify Proxy with US Residential for best results. Leave the default unless you know you need something else. ## Actor input object example ```json { "enableSubredditPosts": true, "subreddits": [ "technology" ], "postSort": "hot", "postTime": "day", "postsPerSubreddit": 25, "enablePostComments": false, "postUrls": [], "commentSort": "confidence", "maxCommentsPerPost": 100, "maxCommentDepth": 10, "expandMoreComments": true, "commentTreeFormat": "flat", "enableSearch": false, "searchQueries": [], "searchSubreddits": [], "searchSort": "relevance", "searchTime": "all", "searchType": "link", "resultsPerQuery": 25, "enableUserProfile": false, "usernames": [], "userContent": "all", "userSort": "new", "itemsPerUser": 25, "enableSubredditInfo": false, "infoSubreddits": [], "includeRules": true, "includeModerators": false, "enableTrending": false, "trendingSource": "popular", "trendingSort": "hot", "trendingLimit": 50, "enableScrapeByUrl": false, "scrapeUrls": [], "scrapeMaxItems": 50, "enableCommentMonitor": false, "monitorSubreddits": [], "monitorKeywords": [], "monitorStream": "comments", "monitorLookback": 200, "sinceId": "", "maxItems": 50, "includeNsfw": true, "includeRaw": false, "redditClientId": "", "redditClientSecret": "", "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } } ``` # Actor output Schema ## `allResults` (type: `string`): Complete dataset with every field from all enabled features in this run. ## `overview` (type: `string`): Compact table — feature type, subreddit, title, author, score, comments, and URL. ## `posts` (type: `string`): Post rows from subreddit listings, search, trending, and monitoring. ## `comments` (type: `string`): Comment rows from post threads and monitoring. ## `users` (type: `string`): User profile rows. ## `subreddits` (type: `string`): Subreddit info and search rows. ## `search` (type: `string`): Search result rows (featureType = search). ## `monitor` (type: `string`): Keyword monitor matches (featureType = comment\_monitor). # 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "subreddits": [ "technology" ] }; // Run the Actor and wait for it to finish const run = await client.actor("b2b_leads/reddit-real-time-data-scraper-fast-reddit-api-alternative").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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "subreddits": ["technology"] } # Run the Actor and wait for it to finish run = client.actor("b2b_leads/reddit-real-time-data-scraper-fast-reddit-api-alternative").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 '{ "subreddits": [ "technology" ] }' | apify call b2b_leads/reddit-real-time-data-scraper-fast-reddit-api-alternative --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=b2b_leads/reddit-real-time-data-scraper-fast-reddit-api-alternative", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Reddit Real-Time Data Scraper – Fast Reddit API Alternative", "description": "Scrape Reddit posts, comments, users, subreddits, search & trending in real time. Fast, lightweight, no API key, no browser. Export clean JSON/CSV with rich data points — 8 tools in one. Built-in proxy, MCP-ready, schedule for live monitoring & alerts.", "version": "0.0", "x-build-id": "kFX0PXTHU6nc2GNce" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/b2b_leads~reddit-real-time-data-scraper-fast-reddit-api-alternative/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-b2b_leads-reddit-real-time-data-scraper-fast-reddit-api-alternative", "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/b2b_leads~reddit-real-time-data-scraper-fast-reddit-api-alternative/runs": { "post": { "operationId": "runs-sync-b2b_leads-reddit-real-time-data-scraper-fast-reddit-api-alternative", "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/b2b_leads~reddit-real-time-data-scraper-fast-reddit-api-alternative/run-sync": { "post": { "operationId": "run-sync-b2b_leads-reddit-real-time-data-scraper-fast-reddit-api-alternative", "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", "properties": { "enableSubredditPosts": { "title": "Subreddit Posts", "type": "boolean", "description": "Fetch posts from one or more subreddits (hot, new, top, rising, controversial). Enabled by default.", "default": true }, "subreddits": { "title": "Subreddits", "type": "array", "description": "Subreddit names or URLs (without r/ prefix is fine). Required when Subreddit Posts is enabled.", "default": [ "technology" ], "items": { "type": "string" } }, "postSort": { "title": "Post sort", "enum": [ "hot", "new", "top", "rising", "controversial" ], "type": "string", "description": "How to sort subreddit post listings.", "default": "hot" }, "postTime": { "title": "Time filter", "enum": [ "hour", "day", "week", "month", "year", "all" ], "type": "string", "description": "Time window for top/controversial sorts.", "default": "day" }, "postsPerSubreddit": { "title": "Posts per subreddit", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum posts to return per subreddit (1–1000).", "default": 25 }, "enablePostComments": { "title": "Post & Comments", "type": "boolean", "description": "Fetch a post plus its full comment thread.", "default": false }, "postUrls": { "title": "Post URLs or IDs", "type": "array", "description": "Reddit post URLs or post IDs to scrape with comments.", "default": [], "items": { "type": "string" } }, "commentSort": { "title": "Comment sort", "enum": [ "confidence", "best", "top", "new", "controversial", "old", "qa" ], "type": "string", "description": "Sort order for comments on each post.", "default": "confidence" }, "maxCommentsPerPost": { "title": "Max comments per post", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Maximum comments to collect per post (1–5000).", "default": 100 }, "maxCommentDepth": { "title": "Max comment depth", "minimum": 1, "maximum": 50, "type": "integer", "description": "Maximum nesting depth for comment threads.", "default": 10 }, "expandMoreComments": { "title": "Expand \"load more\" comments", "type": "boolean", "description": "Follow Reddit \"load more comments\" placeholders for deeper threads.", "default": true }, "commentTreeFormat": { "title": "Comment output format", "enum": [ "flat", "nested" ], "type": "string", "description": "flat = one row per comment; nested = nested replies on parent rows.", "default": "flat" }, "enableSearch": { "title": "Search", "type": "boolean", "description": "Search Reddit by keyword site-wide or within subreddits.", "default": false }, "searchQueries": { "title": "Search queries", "type": "array", "description": "Keywords to search (1–20). Required when Search is enabled.", "default": [], "items": { "type": "string" } }, "searchSubreddits": { "title": "Restrict search to subreddits", "type": "array", "description": "Leave empty for site-wide search, or list subreddits to scope each query.", "default": [], "items": { "type": "string" } }, "searchSort": { "title": "Search sort", "enum": [ "relevance", "hot", "top", "new", "comments" ], "type": "string", "description": "How to sort Reddit search results.", "default": "relevance" }, "searchTime": { "title": "Search time filter", "enum": [ "hour", "day", "week", "month", "year", "all" ], "type": "string", "description": "Time window for search results (applies to top and relevance sorts).", "default": "all" }, "searchType": { "title": "Search result type", "enum": [ "link", "sr", "user" ], "type": "string", "description": "Whether to return posts, subreddits, or users from search.", "default": "link" }, "resultsPerQuery": { "title": "Results per query", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum results to return per search query (1–1000).", "default": 25 }, "enableUserProfile": { "title": "User Profile", "type": "boolean", "description": "Fetch Reddit user about info, submitted posts, and comments.", "default": false }, "usernames": { "title": "Usernames", "type": "array", "description": "Reddit usernames or profile URLs.", "default": [], "items": { "type": "string" } }, "userContent": { "title": "User content to fetch", "enum": [ "about", "posts", "comments", "all" ], "type": "string", "description": "Which user data to collect: profile about page, posts, comments, or all.", "default": "all" }, "userSort": { "title": "User listing sort", "enum": [ "hot", "new", "top", "rising", "controversial" ], "type": "string", "description": "Sort order for a user's submitted posts and comments.", "default": "new" }, "itemsPerUser": { "title": "Items per user", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum posts or comments to return per user (1–1000).", "default": 25 }, "enableSubredditInfo": { "title": "Subreddit Info", "type": "boolean", "description": "Fetch subreddit about page, rules, and optional moderators.", "default": false }, "infoSubreddits": { "title": "Subreddits to inspect", "type": "array", "description": "Subreddit names for metadata scraping.", "default": [], "items": { "type": "string" } }, "includeRules": { "title": "Include subreddit rules", "type": "boolean", "description": "Fetch and include the subreddit's posted rules.", "default": true }, "includeModerators": { "title": "Include moderators", "type": "boolean", "description": "Fetch and include the subreddit's moderator list.", "default": false }, "enableTrending": { "title": "Trending / Popular", "type": "boolean", "description": "Fetch r/popular, r/all, or trending subreddits.", "default": false }, "trendingSource": { "title": "Trending source", "enum": [ "popular", "all", "trending_subreddits" ], "type": "string", "description": "Which Reddit trending feed to scrape: r/popular, r/all, or trending subreddits.", "default": "popular" }, "trendingSort": { "title": "Trending post sort", "enum": [ "hot", "new", "top", "rising", "controversial" ], "type": "string", "description": "Sort order for r/popular or r/all post listings.", "default": "hot" }, "trendingLimit": { "title": "Trending limit", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum posts or trending subreddits to return (1–1000).", "default": 50 }, "enableScrapeByUrl": { "title": "Scrape By URL", "type": "boolean", "description": "Paste any Reddit URL — auto-detect post, subreddit, user, or search page.", "default": false }, "scrapeUrls": { "title": "Reddit URLs", "type": "array", "description": "Reddit URLs to scrape.", "default": [], "items": { "type": "string" } }, "scrapeMaxItems": { "title": "Max items per URL", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum items to extract when scraping listing-type Reddit URLs.", "default": 50 }, "enableCommentMonitor": { "title": "Comment / Keyword Monitor", "type": "boolean", "description": "Scan recent posts or comments in subreddits for keyword matches — ideal for scheduled real-time monitoring.", "default": false }, "monitorSubreddits": { "title": "Monitor subreddits", "type": "array", "description": "Subreddits to watch for keyword matches.", "default": [], "items": { "type": "string" } }, "monitorKeywords": { "title": "Monitor keywords", "type": "array", "description": "Case-insensitive keywords to match in titles, bodies, or comments.", "default": [], "items": { "type": "string" } }, "monitorStream": { "title": "Monitor stream", "enum": [ "comments", "posts", "both" ], "type": "string", "description": "Whether to scan recent comments, posts, or both for keyword matches.", "default": "comments" }, "monitorLookback": { "title": "Lookback items", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Number of newest posts/comments to scan per subreddit.", "default": 200 }, "sinceId": { "title": "Since fullname (incremental)", "type": "string", "description": "Optional Reddit fullname (e.g. t1_abc123) — only return items newer than this ID for incremental scheduled runs.", "default": "" }, "maxItems": { "title": "Default max items", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Fallback cap used by features that do not define their own max.", "default": 50 }, "includeNsfw": { "title": "Include NSFW content", "type": "boolean", "description": "Include posts and comments marked as over_18 (NSFW).", "default": true }, "includeRaw": { "title": "Include raw Reddit JSON", "type": "boolean", "description": "Attach the full raw data object under the raw field (larger output).", "default": false }, "redditClientId": { "title": "Reddit client ID (advanced)", "type": "string", "description": "Optional. Leave empty for zero-config access. Provide your own Reddit app client ID for dedicated quota.", "default": "" }, "redditClientSecret": { "title": "Reddit client secret (advanced)", "type": "string", "description": "Optional companion secret for redditClientId.", "default": "" }, "proxyConfiguration": { "title": "Proxy settings", "type": "object", "description": "Use Apify Proxy with US Residential for best results. Leave the default unless you know you need something else.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } } } }, "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 } } } } } } } } } } ```