# Reddit Scraper V2 (`myagizm/reddit-scraper-v2`) Actor Reddit Scraper V2 — cached data source (results may lag up to ~1.5h). Structured JSON, no login, no API key. For real-time data use the V1 actor. - **URL**: https://apify.com/myagizm/reddit-scraper-v2.md - **Developed by:** [MYM](https://apify.com/myagizm) (community) - **Categories:** Social media - **Stats:** 2 total users, 0 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $1.10 / 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/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows. 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/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.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/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 Scraper V2 — Scrape Reddit Posts, Comments, Users & Search (No API Key, No Login)

Scrape Reddit posts, comments, subreddits, search results, and user profiles — no API key, no login, no cookies or account required. Get clean, structured public data at scale and export scraped data to JSON, CSV, Excel, or XML, schedule runs via API, and integrate with your tools and AI workflows.

Built for AI agents: works out of the box with Claude, ChatGPT / Codex, and Cursor through the Apify MCP server — clean structured data, no login, no setup.

Try on Apify Input Schema API Docs

What can it do • AI agents (MCP) • How to use • Output data • Search • Subreddits • Comments • Users • Pricing • Other actors • FAQ

--- ### What can Reddit Scraper V2 do? {#what-can-reddit-scraper-v2-do} **Reddit Scraper V2** lets you **scrape Reddit posts, comments, user activity, and community metadata** from [Reddit](https://www.reddit.com/) with **no API key, no login, and no cookies or account required**. Give it subreddits, search queries, user names, or plain Reddit URLs — get back clean, structured records you can export to JSON, CSV, Excel, or XML. This scraper is built to **go beyond the limitations of the official Reddit API**: no OAuth app, no per-app rate quota, and no request caps to juggle. Scrape Reddit at scale, pull many subreddits at once, and build datasets from **publicly available data** in minutes. > **Get your first results free in under 2 minutes** — paste a subreddit like `AskReddit`, click Start, and watch structured posts stream into your dataset. > **V2 vs V1** — V2 reads from a **cached data layer** (results may lag up to ~1.5 h) and is ideal for **bulk historical pulls, search, and dataset building** at high throughput. If you need **real-time, up-to-the-second** posts, use the **[Reddit Scraper V1 actor](https://apify.com/myagizm/reddit-scraper)**. #### ✅ No API keys, no login No Reddit account, no OAuth app, no cookies or account required. Paste what you want to scrape and run. #### 🗂️ Scrape entire subreddits Pull recent, hot, top, rising, or controversial posts from any public subreddit — scrape one or many subreddits at once, with per-source and global limits. #### 💬 Scrape complete Reddit comment threads Optionally expand comment trees per post, with configurable **max comments** and **max depth** — great for sentiment and discussion analysis. #### 🔎 Scrape Reddit search results Search across all of Reddit or restrict to specific subreddits, then filter by keyword, sort, time range, and date. #### 👤 Scrape Reddit user profiles Collect a user's recent posts and comments by username — no login required. #### 📊 Rich, structured Reddit data Every post/comment comes back with score, author, subreddit, timestamps (ISO + epoch), flair, media URLs, NSFW flag, comment counts, and more. #### 🔄 Export scraped Reddit data anywhere Download as **JSON, CSV, Excel, or XML**, or stream results through the Apify API into your own pipeline — no limitations on requests. #### ⚡ Fast, fresh data at scale Multiple sources (subreddits, searches, users, URLs) are fetched **concurrently**, so large jobs finish in seconds to minutes, not hours. --- ### Use with AI agents — Claude, ChatGPT & Cursor (MCP) {#use-with-ai-agents-mcp} Reddit Scraper V2 is exposed through the **Apify MCP server**, so AI agents can call it directly as a tool to scrape Reddit — no glue code. - **Claude / Claude Desktop** — add the Apify MCP server and the agent can scrape Reddit on demand. - **ChatGPT / Codex** — call the actor as a tool inside your agent loop. - **Cursor** — pull live Reddit context into your editor. Point your MCP client at: ```` https://mcp.apify.com ```` …and enable the `myagizm/reddit-scraper-v2` tool. The agent supplies the input (subreddits, queries, users) and receives structured JSON back. #### Send scraped Reddit data straight into Slack, Notion, Airtable & more {#mcp-connectors} Combine with Apify integrations to push scraped Reddit data into **Make, Zapier, n8n, Slack, Notion, Airtable, Airbyte, Gumloop, CrewAI, IFTTT, Lindy, GitHub, Google Sheets, and Google Drive** — no custom code required. --- ### How to scrape Reddit without the API {#how-to-scrape-reddit} 1. Open **[Reddit Scraper V2](https://apify.com/myagizm/reddit-scraper-v2)** on Apify. 2. Choose your input to scrape Reddit — **subreddits**, **search queries**, **users**, or paste **Reddit URLs**. 3. Set limits (`maxItems`, `maxPostsPerSource`) and toggle comments/media if you need them. 4. Click **▶ Start** (or call the API / MCP tool). 5. Export the scraped data as **JSON, CSV, Excel, or XML**, or read it from the dataset via API. No coding required to scrape Reddit — but every option is scriptable through the API. --- ### What data can I scrape from Reddit? {#what-data-can-i-scrape-from-reddit} When you scrape Reddit posts, each **post** record includes: | Field | Description | |---|---| | `id` | Reddit fullname (e.g. `t3_1v203q9`) | | `type` | `post` or `comment` | | `title` | Post title | | `url` | Permalink to the post | | `author` | Username of the poster | | `subreddit` | Subreddit name | | `domain` | Source domain (e.g. `self.webdev`) | | `score` | Net upvotes | | `upvoteRatio` | Upvote ratio (0–1) | | `numComments` | Comment count | | `flair` | Post flair, if any | | `gilded` | Number of awards | | `selftext` | Body text (when `includeSelftext`) | | `isSelf` | Whether it is a self/text post | | `nsfw` | NSFW flag | | `spoiler` / `stickied` / `archived` / `edited` | Post state flags | | `thumbnail` / `outboundUrl` | Thumbnail + linked URL | | `mediaUrls` | Media links (when `includeMedia`) | | `createdUtc` / `createdUtcEpoch` | Creation time (ISO + epoch) | | `scrapedAt` | When the record was captured | | `sourceType` | Origin tag (`reddit`) | When you scrape Reddit comments (`includeComments` or comment search) you also get: `id`, `body`, `author`, `subreddit`, `score`, `createdUtc`, parent/post references, and depth. --- ### Reddit scraping use cases {#use-cases} - **Market & audience research** — scrape Reddit to see what a community actually talks about. - **Brand & reputation monitoring** — track mentions of your product across subreddits. - **Lead generation & outreach** — find people asking for exactly what you sell (e.g. `r/forhire`). - **Sentiment analysis & AI training** — build labeled comment datasets at scale. - **Trend detection** — surface rising posts in a niche. - **Competitor analysis** — watch discussion around competing products. - **Content auditing & campaign tracking** — measure how topics evolve over time. --- ### How to scrape Reddit search results {#scrape-reddit-search-results} #### Search Reddit by keyword Provide one or more `searchQueries`. Control ranking with `sort` (`relevance`, `hot`, `top`, `new`, `rising`, `controversial`) and `time` (`hour`, `day`, `week`, `month`, `year`, `all`). ```json { "searchQueries": ["remote developer", "hiring react"], "sort": "new", "time": "week", "maxItems": 100 } ```` #### Search inside specific subreddits Restrict a query to given communities with `searchInSubreddits`: ```json { "searchQueries": ["salary"], "searchInSubreddits": ["cscareerquestions"], "searchFor": ["posts"], "maxItems": 50 } ``` #### Search posts or comments `searchFor` accepts `["posts"]`, `["comments"]`, `["communities"]`, `["users"]`, or `["media"]` — combine as needed. *** ### How to scrape Reddit posts from a date range {#date-range} Use `postDateLimit` (and `commentDateLimit`) in `YYYY-MM-DD` form to keep only items on or after that date: ```json { "subreddits": ["webdev"], "postDateLimit": "2026-01-01", "maxItems": 200 } ``` *** ### How to scrape a subreddit {#scrape-a-subreddit} #### Recent posts from one subreddit ```json { "subreddits": ["webdev"], "sort": "new", "maxPostsPerSource": 50 } ``` #### Top posts from multiple subreddits at once ```json { "subreddits": ["webdev", "reactjs", "node"], "sort": "top", "time": "month", "maxPostsPerSource": 25, "maxItems": 150 } ``` #### Paginate deeper Increase `maxPages` to walk more listing pages per source (25 posts per page). #### Community (subreddit) info only Use `communities` to fetch subreddit **metadata** (title, subscribers, description, creation date) without pulling posts. *** ### How to scrape Reddit comments {#scrape-reddit-comments} #### All comments on a post Pass the post URL in `startUrls` and enable comments: ```json { "startUrls": [{ "url": "https://www.reddit.com/r/webdev/comments/1v203q9/" }], "includeComments": true, "maxComments": 100, "maxCommentDepth": 6 } ``` #### Comments across a subreddit Combine `subreddits` with `includeComments: true` to attach top comments to each post. *** ### How to scrape Reddit user profiles {#scrape-reddit-users} Pass usernames in `users` to scrape a person's recent posts and comments — public data only, no login: ```json { "users": ["spez"], "maxItems": 50 } ``` *** ### Limiting results {#limits} - `maxItems` — hard cap on total records returned. - `maxPostsPerSource` — cap per subreddit/search/user. - `maxPages` — how many listing pages to walk per source. - `maxComments` / `maxCommentDepth` — comment expansion bounds. - `requestDelayMs` / `maxRetries` — politeness and resilience knobs. *** ### Output example {#output-example} Real sample record returned when you scrape Reddit posts: ```json { "id": "t3_1v203q9", "url": "https://www.reddit.com/r/webdev/comments/1v203q9/do_new_saas_users_need_a_tutorial_or_just_one/", "nsfw": false, "type": "post", "flair": "", "score": 1, "title": "Do new SaaS users need a tutorial, or just one obvious next step?", "author": "Key_Database155", "domain": "self.webdev", "edited": false, "gilded": 0, "isSelf": true, "spoiler": false, "archived": false, "selftext": "I looked through the first few days of usage on a tool I recently launched...", "stickied": false, "scrapedAt": "2026-07-20T22:31:53.518Z", "subreddit": "webdev", "thumbnail": "", "createdUtc": "2026-07-20T22:27:40.000Z", "sourceType": "reddit", "numComments": 0, "outboundUrl": "", "upvoteRatio": 1, "createdUtcEpoch": 1784586460 } ``` *** ### How much does it cost to scrape Reddit? {#how-much-does-it-cost-to-scrape-reddit} #### Pay-per-result You are billed by the Apify platform for the compute your runs use, plus any per-result pricing shown on the actor page. Building a dataset of thousands of posts typically costs only a few dollars — with **pay-per-result pricing** you only pay for the data you actually keep. #### Free to try **Get your first results free in under 2 minutes.** Start with a single subreddit and a small `maxItems` to see the output before scaling up. #### Why it's efficient Parallel fan-out means large multi-source jobs finish in seconds to minutes, not hours — fast, fresh data, and you pay for less compute time. *** ### Integrate with n8n, Zapier, Make & AI workflows {#integrations} Scrape Reddit and push results into your stack with **Make, Zapier, n8n, Slack, Airbyte, Gumloop, CrewAI, IFTTT, Lindy, GitHub, Google Sheets, and Google Drive**, plus webhooks and the Apify MCP server. #### Method 1: Synchronous run (quick scrapes) ``` POST https://api.apify.com/v2/acts/myagizm~reddit-scraper-v2/run-sync-get-dataset-items?token=YOUR_TOKEN Content-Type: application/json { "subreddits": ["webdev"], "maxItems": 50 } ``` #### Method 2: Asynchronous run (large scrapes) ``` POST https://api.apify.com/v2/acts/myagizm~reddit-scraper-v2/runs?token=YOUR_TOKEN ``` Then poll the run and read its dataset when it finishes. You can also **schedule runs via API** or from the Apify console to keep your Reddit data fresh automatically. *** ### Want other Reddit data? {#want-other-reddit-data} Reddit Scraper V2 is part of a full family of Reddit and social scrapers. To get other details from Reddit, try these sibling actors: - **[Reddit Scraper V1](https://apify.com/myagizm/reddit-scraper)** — real-time, up-to-the-second variant of this scraper. - **[Reddit Subreddit Scraper V2](https://apify.com/myagizm/reddit-subreddit-scraper-v2)** — focused subreddit listing extraction. - **[Reddit Search Scraper V2](https://apify.com/myagizm/reddit-search-scraper-v2)** — keyword search across Reddit at scale. - **[Reddit Comment Scraper V2](https://apify.com/myagizm/reddit-comment-scraper-v2)** — deep comment-thread extraction. - **[Reddit Community Scraper V2](https://apify.com/myagizm/reddit-community-scraper-v2)** — subreddit/community metadata. - **[Reddit Profile Scraper V2](https://apify.com/myagizm/reddit-profile-scraper-v2)** — user profile posts and comments. Scraping other platforms too? Try the **[Instagram Profile Scraper](https://apify.com/myagizm/instagram-profile-scraper)**, **[YouTube Channel Scraper](https://apify.com/myagizm/youtube-channel-scraper)**, or **[LinkedIn Jobs Scraper](https://apify.com/myagizm/linkedin-jobs-scraper)**. *** ### Support {#support} Found a bug or need a field added? Open an issue on the actor's **Issues** tab — we actively maintain this scraper. *** ### FAQ {#faq} #### Is it legal to scrape Reddit? Scraping **publicly available data** is generally permitted, but you are responsible for how you use the data. Respect Reddit's terms, copyright, and privacy laws (e.g. GDPR) and avoid collecting personal data you don't have a lawful basis to process. #### Do I need Reddit API keys or authentication to scrape Reddit? No. Reddit Scraper V2 needs **no API key**, no app registration, and **no login** — no cookies or account required. #### Can I use Reddit Scraper V2 with the Apify API? Yes. Trigger runs and read datasets through the Apify API using the path `myagizm~reddit-scraper-v2`, both synchronously and asynchronously. #### Can I scrape Reddit data through an MCP server (AI agents)? Yes — it's available through the Apify MCP server for **Claude, ChatGPT/Codex, and Cursor**, so AI agents can scrape Reddit as a tool. #### Do I need proxies to scrape Reddit? No. Proxy handling is fully managed for you — nothing to configure. #### Can I integrate scraped Reddit data with other apps? Yes — connect to Make, Zapier, n8n, Slack, Google Sheets, Airtable, Notion, and more, plus webhooks. #### Can I export scraped Reddit data to CSV, Excel, or JSON? Yes — JSON, CSV, Excel, and XML are all available from the dataset. #### Can I scrape multiple subreddits at once? Yes. Add several names to `subreddits` (and combine with users, URLs, and searches) to scrape Reddit at scale in one run. #### Can I schedule the Reddit scraper? Yes — schedule runs from the Apify console or via API to keep your Reddit data fresh automatically. #### Can I scrape data from private subreddits or accounts? No. Only **publicly available** posts, comments, and profiles can be scraped. #### What's the difference between V1 and V2? **V2** reads a cached source (may lag ~1.5 h) and is best for bulk/historical/search jobs at high throughput. **V1** is real-time. Pick based on freshness vs. volume. #### How do I scrape an entire subreddit? Add it to `subreddits`, raise `maxPostsPerSource` and `maxPages`, and set `maxItems` to your target. #### How do I scrape Reddit comments? Set `includeComments: true` (with `maxComments` / `maxCommentDepth`), or search with `searchFor: ["comments"]`. #### Can I scrape Reddit posts from a specific date range? Yes — use `postDateLimit` / `commentDateLimit` in `YYYY-MM-DD` form. #### How fresh is the scraped data? V2 serves from a cached layer that may lag up to ~1.5 hours — fast and efficient for volume. For up-to-the-second data, use V1. *** ### Related searches {#related-searches} reddit scraper · scrape reddit posts · reddit data export · subreddit scraper · reddit api alternative · scrape reddit without api key · reddit comments scraper · reddit market research tool · reddit lead generation · reddit dataset builder · reddit brand monitoring · reddit posts to csv · reddit crawler · reddit content mining · reddit sentiment data · reddit scraping tool no login *** ### Disclaimer {#disclaimer} This is an independent tool and is not affiliated with, endorsed by, or sponsored by Reddit. All product names, logos, and brands are property of their respective owners. Use this scraper responsibly and only to collect publicly available data in compliance with applicable laws and Reddit's terms. *** ### Resources {#resources} - [Apify API docs](https://docs.apify.com/api/v2) - [Apify MCP server](https://mcp.apify.com) - [How to export data](https://docs.apify.com/platform/storage/dataset) ***

Scrape Reddit posts, comments, users, and search results with no API key and no login.
Export scraped data to JSON, CSV, Excel, or XML, schedule runs via API, and integrate with your tools and AI workflows.

*** ## 中文说明 —— Reddit 综合抓取工具（V2） > **V2 = 托管交付线。** 本 Actor 为 V2：运行在托管基础设施上，交付更稳定、字段更全。若只需要最低价的尽力而为版本，同一功能的 **V1** 版本也在 [商店主页](https://apify.com/myagizm)。 **免登录抓取 Reddit 公开数据** —— 子版块、用户、社区、关键词搜索四种入口合一，一次运行即可拿到帖子（可选带评论）。不需要 Reddit API Key、不需要 OAuth 应用、不需要登录或 Cookie。结果可导出为 JSON、CSV、Excel、XML，也可通过 Apify API 定时运行并接入 n8n、Zapier、Make 等工具。 > **两分钟内免费拿到第一批数据** —— 填入内容、点击 Start 即可。无需配置，试用不需要信用卡。 ### 能做什么 - 📥 **四种入口**：子版块、用户主页、社区信息、关键词搜索，可在同一次运行中混用。 - 🔀 **排序与时间范围**：`new` / `hot` / `top` / `rising` / `controversial` + `hour`…`all`。 - 💬 **可选带评论**（`includeComments`），并可控制评论数量与层级深度。 - 📝 **可选帖子正文**（`includeSelftext`）与**媒体链接**（`includeMedia`）。 - 🗓️ **按日期截断**（`postDateLimit` / `commentDateLimit`），只要最近内容。 - 🔎 **站内关键词过滤**（`searchTerms`），在抓取时就筛掉无关帖子。 - 🔞 **可选包含成人内容**（`includeNSFW`）。 - 📏 **多层限流**：`maxItems`、`maxPostsPerSource`、`maxPages` 精确控制成本。 ### 谁在用 - 📊 **市场与产品研究** —— 看用户在问什么、夸什么、抱怨什么。 - 💼 **线索挖掘** —— 在求助类版块找到有需求的人。 - 🧑‍💻 **AI / 数据团队** —— 构建帖子 + 评论语料。 - 🏢 **品牌监测** —— 跟踪品牌在各版块的讨论。 - 📰 **研究者与记者** —— 可复现地采集社区讨论。 ### 输入示例 ```json { "searchQueries": ["remote developer", "hiring react"], "sort": "new", "time": "week", "maxItems": 100 } ``` ### 输出示例 ```json { "id": "t3_1v203q9", "url": "https://www.reddit.com/r/webdev/comments/1v203q9/do_new_saas_users_need_a_tutorial_or_just_one/", "nsfw": false, "type": "post", "flair": "", "score": 1, "title": "Do new SaaS users need a tutorial, or just one obvious next step?", "author": "Key_Database155", "domain": "self.webdev", "edited": false, "gilded": 0, "isSelf": true, "spoiler": false, "archived": false, "selftext": "I looked through the first few days of usage on a tool I recently launched...", "stickied": false, "scrapedAt": "2026-07-20T22:31:53.518Z", "subreddit": "webdev", "thumbnail": "", "createdUtc": "2026-07-20T22:27:40.000Z", "sourceType": "reddit", "numComments": 0, "outboundUrl": "", "upvoteRatio": 1, "createdUtcEpoch": 1784586460 } ``` ### 价格 采用**按结果计费**：只为真正拿到的数据付费，不按运行时间收费。 - 💸 成本 = 结果数量 × 单价，预算可提前算清。 - 📉 Apify 的 Bronze / Silver / Gold / Platinum / Diamond 套餐享阶梯折扣。 - 🆓 新账号自带每月免费额度，第一次运行不花钱。 - 🚫 无代理附加费、无单次请求费、无最低消费。 实时价格见 [Apify 商店页面](https://apify.com/myagizm/reddit-scraper-v2)。 ### 使用建议 - 📏 **先用小 `maxItems` 试跑**，确认字段结构再放量。 - 💬 **评论很贵**：只在真正需要时开 `includeComments`，并把 `maxComments` 压低。 - 🗓️ 监控场景用 `postDateLimit` 而不是大 limit，更省钱。 - 🔎 `searchTerms` 在抓取阶段过滤，比抓完再筛便宜得多。 - ⏰ 定时运行 + 按 `id` 去重，即可增量采集。 ### 其他 Reddit 数据 - 🤖 **[Reddit 综合抓取](https://apify.com/myagizm/reddit-scraper-v2)** —— 子版块 / 用户 / 社区 / 搜索四合一。 - 🔎 **[Reddit 搜索抓取](https://apify.com/myagizm/reddit-search-scraper-v2)** —— 全站或指定版块关键词搜索。 - 🏘️ **[子版块抓取](https://apify.com/myagizm/reddit-subreddit-scraper-v2)** —— 按版块抓帖子。 - 💬 **[评论抓取](https://apify.com/myagizm/reddit-comment-scraper-v2)** —— 可控深度的评论采集。 - 📇 **[社区信息抓取](https://apify.com/myagizm/reddit-community-scraper-v2)** —— 版块规模与简介。 - 👤 **[用户资料抓取](https://apify.com/myagizm/reddit-profile-scraper-v2)** —— karma、账号年龄、徽章。 其他平台同样采用免登录、按结果计费的方式：**[Instagram](https://apify.com/myagizm/instagram-profile-scraper-v2)** · **[TikTok](https://apify.com/myagizm/tiktok-profile-scraper-v2)** · **[X（推特）](https://apify.com/myagizm/x-tweets-scraper)** · **[LinkedIn](https://apify.com/myagizm/linkedin-profile-scraper)** · **[YouTube](https://apify.com/myagizm/youtube-channel-scraper)** · **[Google 地图](https://apify.com/myagizm/google-maps-scraper)**。完整工具家族见 **[myagizm 商店主页](https://apify.com/myagizm)**。 ### 配合 AI 智能体使用（MCP） 本 Actor 已接入 **Apify MCP 服务器**，Claude、ChatGPT、Cursor 等助手可以把它当作工具直接调用，用自然语言提问即可拿到结构化结果，无需写胶水代码。 ### 集成与 API 支持 **Make、Zapier、n8n、Slack、Airbyte、Gumloop、CrewAI、IFTTT、Lindy、GitHub、Google Sheets、Google Drive**，以及 Webhook、定时任务与 MCP 服务器。 ```bash curl -X POST "https://api.apify.com/v2/acts/myagizm~reddit-scraper-v2/run-sync-get-dataset-items?token=YOUR_APIFY_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "searchQueries": ["remote developer", "hiring react"], "sort": "new", "time": "week", "maxItems": 100 }' ``` 把 `format` 改成 `json`、`csv`、`xlsx` 或 `xml` 即可导出不同格式。 ### 常见问题 **需要 Reddit API Key 或登录吗？** 不需要。没有 API Key、没有 OAuth 应用、不登录、不用 Cookie。 **抓取 Reddit 合法吗？** 只采集公开可见的数据，即任何未登录访客都能看到的内容。不登录、不访问私密版块或私信。合规责任由使用者承担：如涉及个人数据请遵守 GDPR / CCPA 与平台条款。 **能抓私密版块或已删除内容吗？** 不能，会被跳过并记录在运行日志中。 **需要配置代理吗？** 不需要，已内置托管。 **支持导出 CSV / Excel / JSON 吗？** 支持 JSON、CSV、Excel、XML。 **可以通过 Apify API 调用吗？** 可以，见上方示例。 **支持 AI 智能体（MCP）吗？** 支持，Claude、ChatGPT、Cursor 均可当作工具调用。 **可以定时运行吗？** 可以，支持 Apify Schedules、API 与 Webhook；按 `id` 去重即可实现增量采集。 **V1 和 V2 有什么区别？** V1 轻量自包含、价格最低、尽力而为；V2 运行在托管基础设施上，交付更稳定、字段更全。两者输入基本一致，可以先用 V1 广筛、再用 V2 精查。 **数据有多新？** 不缓存，每次运行都读取当前公开页面。 ### 免责声明 本工具为独立第三方工具，与 Reddit, Inc. 无任何隶属、认可或赞助关系，所有商标归各自所有者。 本 Actor 只采集**公开可见**的数据，不登录、不绕过访问控制、不获取私密内容。数据使用的合规责任由使用者承担。 ### 相关搜索 reddit 抓取 · reddit 数据采集 · 子版块抓取 · reddit 帖子导出 · reddit 评论抓取 · reddit api 替代 · 免登录抓取 reddit · reddit 市场研究 · reddit 线索挖掘 · reddit 数据集 · reddit 品牌监测 · reddit csv 导出 # Actor input Schema ## `subreddits` (type: `array`): Subreddit names to scrape, e.g. "AskReddit", "forhire". The r/ prefix is optional (both "webdev" and "r/webdev" work). ## `startUrls` (type: `array`): Paste any Reddit URLs (post, subreddit, or user), e.g. "https://www.reddit.com/r/webdev/". Each is auto-detected and scraped accordingly. ## `users` (type: `array`): Usernames whose submitted posts to scrape, e.g. "spez". The u/ prefix is optional. ## `communities` (type: `array`): Subreddit names to fetch metadata for (subscribers, description, creation date) without listing posts, e.g. "technology". ## `searchQueries` (type: `array`): Keywords to search across Reddit, e.g. "remote developer". Each query is run for every type selected in "Search for". ## `searchFor` (type: `array`): Which entity types each search query should return, e.g. select "Posts" and "Comments" to get both. ## `searchInSubreddits` (type: `array`): If set, each search query is restricted to these subreddits only, e.g. "cscareerquestions". ## `sort` (type: `string`): Sort order for listings and search results, e.g. "hot" for trending posts or "new" for the latest. ## `time` (type: `string`): Time window used by Top / Controversial / search, e.g. "week" to get the best posts of the past 7 days. ## `postDateLimit` (type: `string`): Keep only posts created on or after this date, e.g. "2026-01-01". Leave empty for no limit. ## `commentDateLimit` (type: `string`): Keep only comments created on or after this date, e.g. "2026-01-01". Leave empty for no limit. ## `searchTerms` (type: `array`): Keep only posts whose title or body contains at least one of these words (case-insensitive), e.g. "hiring", "developer". ## `includeNSFW` (type: `boolean`): Include posts flagged as over-18 / NSFW. Example: set to true to keep adult-flagged posts in the results. ## `includeSelftext` (type: `boolean`): Fetch each post's self/body text, e.g. the full write-up of a text post. Turn off to keep records lightweight. ## `includeComments` (type: `boolean`): Scrape nested comments for each post (slower). Example: set to true to attach discussion threads to each post. ## `maxComments` (type: `integer`): Upper bound on comments scraped per post when "Include comments" is on, e.g. 20. ## `maxCommentDepth` (type: `integer`): Maximum nesting depth of the comment tree to traverse, e.g. 4 to include replies four levels deep. ## `includeMedia` (type: `boolean`): Extract image/video media URLs (i.redd.it, v.redd.it, imgur, galleries). Example: set to true to collect a post's attached image links. ## `maxItems` (type: `integer`): Hard cap on the total number of items saved in one run, e.g. 50. Keep this reasonable — a single run is limited to ~10 minutes. ## `maxPostsPerSource` (type: `integer`): Cap on posts kept from each individual subreddit, user, or search, e.g. 25. ## `maxPages` (type: `integer`): How many pages of a listing to paginate through (25 posts per page), e.g. 2 to walk 50 posts. ## `ignoreStartUrls` (type: `boolean`): Skip the Start URLs input even if provided. Example: set to true to reuse a saved input but scrape only subreddits this time. ## `maxRetries` (type: `integer`): Retry attempts (with backoff) per failed request, e.g. 3. ## `requestDelayMs` (type: `integer`): Politeness delay between consecutive requests, e.g. 300 for a 0.3s pause. ## `debug` (type: `boolean`): Emit verbose per-source logs (useful while testing your input). Example: set to true to see why a source returned no items. ## Actor input object example ```json { "subreddits": [ "AskReddit", "programming" ], "startUrls": [ { "url": "https://www.reddit.com/r/pics/" } ], "users": [ "spez", "kn0thing" ], "communities": [ "technology", "science" ], "searchQueries": [ "python developer" ], "searchFor": [ "posts" ], "searchInSubreddits": [ "forhire" ], "sort": "hot", "time": "week", "postDateLimit": "2026-01-01", "commentDateLimit": "2026-01-01", "searchTerms": [ "hiring", "developer" ], "includeNSFW": false, "includeSelftext": true, "includeComments": false, "maxComments": 20, "maxCommentDepth": 4, "includeMedia": false, "maxItems": 50, "maxPostsPerSource": 25, "maxPages": 1, "ignoreStartUrls": false, "maxRetries": 3, "requestDelayMs": 300, "debug": false } ``` # Actor output Schema ## `results` (type: `string`): All scraped items as structured JSON. # 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": [ "forhire" ], "startUrls": [ { "url": "https://www.reddit.com/r/webdev/" } ], "users": [ "spez" ], "communities": [ "technology" ], "searchQueries": [ "remote developer" ], "searchFor": [ "posts" ], "sort": "hot", "time": "week", "includeNSFW": false, "includeSelftext": true, "includeComments": false, "maxComments": 20, "maxCommentDepth": 4, "includeMedia": false, "maxItems": 50, "maxPostsPerSource": 25, "maxPages": 1, "ignoreStartUrls": false, "maxRetries": 3, "requestDelayMs": 300, "debug": false }; // Run the Actor and wait for it to finish const run = await client.actor("myagizm/reddit-scraper-v2").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": ["forhire"], "startUrls": [{ "url": "https://www.reddit.com/r/webdev/" }], "users": ["spez"], "communities": ["technology"], "searchQueries": ["remote developer"], "searchFor": ["posts"], "sort": "hot", "time": "week", "includeNSFW": False, "includeSelftext": True, "includeComments": False, "maxComments": 20, "maxCommentDepth": 4, "includeMedia": False, "maxItems": 50, "maxPostsPerSource": 25, "maxPages": 1, "ignoreStartUrls": False, "maxRetries": 3, "requestDelayMs": 300, "debug": False, } # Run the Actor and wait for it to finish run = client.actor("myagizm/reddit-scraper-v2").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": [ "forhire" ], "startUrls": [ { "url": "https://www.reddit.com/r/webdev/" } ], "users": [ "spez" ], "communities": [ "technology" ], "searchQueries": [ "remote developer" ], "searchFor": [ "posts" ], "sort": "hot", "time": "week", "includeNSFW": false, "includeSelftext": true, "includeComments": false, "maxComments": 20, "maxCommentDepth": 4, "includeMedia": false, "maxItems": 50, "maxPostsPerSource": 25, "maxPages": 1, "ignoreStartUrls": false, "maxRetries": 3, "requestDelayMs": 300, "debug": false }' | apify call myagizm/reddit-scraper-v2 --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=myagizm/reddit-scraper-v2", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Reddit Scraper V2", "description": "Reddit Scraper V2 — cached data source (results may lag up to ~1.5h). Structured JSON, no login, no API key. For real-time data use the V1 actor.", "version": "0.1", "x-build-id": "Zg25oMqCLKpQGgtFR" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/myagizm~reddit-scraper-v2/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-myagizm-reddit-scraper-v2", "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/myagizm~reddit-scraper-v2/runs": { "post": { "operationId": "runs-sync-myagizm-reddit-scraper-v2", "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/myagizm~reddit-scraper-v2/run-sync": { "post": { "operationId": "run-sync-myagizm-reddit-scraper-v2", "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": { "subreddits": { "title": "🎯 Subreddits", "type": "array", "description": "Subreddit names to scrape, e.g. \"AskReddit\", \"forhire\". The r/ prefix is optional (both \"webdev\" and \"r/webdev\" work).", "items": { "type": "string" } }, "startUrls": { "title": "🔗 Start URLs", "type": "array", "description": "Paste any Reddit URLs (post, subreddit, or user), e.g. \"https://www.reddit.com/r/webdev/\". Each is auto-detected and scraped accordingly.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "users": { "title": "👤 Users", "type": "array", "description": "Usernames whose submitted posts to scrape, e.g. \"spez\". The u/ prefix is optional.", "items": { "type": "string" } }, "communities": { "title": "🏘️ Communities (metadata only)", "type": "array", "description": "Subreddit names to fetch metadata for (subscribers, description, creation date) without listing posts, e.g. \"technology\".", "items": { "type": "string" } }, "searchQueries": { "title": "🔎 Search queries", "type": "array", "description": "Keywords to search across Reddit, e.g. \"remote developer\". Each query is run for every type selected in \"Search for\".", "items": { "type": "string" } }, "searchFor": { "title": "🧭 Search for", "type": "array", "description": "Which entity types each search query should return, e.g. select \"Posts\" and \"Comments\" to get both.", "items": { "type": "string", "enum": [ "posts", "comments", "communities", "users", "media" ], "enumTitles": [ "Posts", "Comments (Reddit returns posts)", "Communities", "Users", "Media posts only" ] }, "default": [ "posts" ] }, "searchInSubreddits": { "title": "📍 Restrict search to subreddits", "type": "array", "description": "If set, each search query is restricted to these subreddits only, e.g. \"cscareerquestions\".", "items": { "type": "string" } }, "sort": { "title": "↕️ Sort", "enum": [ "new", "hot", "top", "rising", "controversial", "relevance" ], "type": "string", "description": "Sort order for listings and search results, e.g. \"hot\" for trending posts or \"new\" for the latest.", "default": "new" }, "time": { "title": "📅 Time range", "enum": [ "hour", "day", "week", "month", "year", "all" ], "type": "string", "description": "Time window used by Top / Controversial / search, e.g. \"week\" to get the best posts of the past 7 days.", "default": "all" }, "postDateLimit": { "title": "📆 Only posts on/after (YYYY-MM-DD)", "type": "string", "description": "Keep only posts created on or after this date, e.g. \"2026-01-01\". Leave empty for no limit." }, "commentDateLimit": { "title": "📆 Only comments on/after (YYYY-MM-DD)", "type": "string", "description": "Keep only comments created on or after this date, e.g. \"2026-01-01\". Leave empty for no limit." }, "searchTerms": { "title": "🔤 Keyword filter", "type": "array", "description": "Keep only posts whose title or body contains at least one of these words (case-insensitive), e.g. \"hiring\", \"developer\".", "items": { "type": "string" } }, "includeNSFW": { "title": "🔞 Include NSFW", "type": "boolean", "description": "Include posts flagged as over-18 / NSFW. Example: set to true to keep adult-flagged posts in the results.", "default": false }, "includeSelftext": { "title": "📝 Include post text", "type": "boolean", "description": "Fetch each post's self/body text, e.g. the full write-up of a text post. Turn off to keep records lightweight.", "default": true }, "includeComments": { "title": "💬 $ Include comments", "type": "boolean", "description": "Scrape nested comments for each post (slower). Example: set to true to attach discussion threads to each post.", "default": false }, "maxComments": { "title": "💯 Max comments per post", "minimum": 0, "maximum": 100, "type": "integer", "description": "Upper bound on comments scraped per post when \"Include comments\" is on, e.g. 20.", "default": 20 }, "maxCommentDepth": { "title": "🪜 Max comment depth", "minimum": 0, "maximum": 15, "type": "integer", "description": "Maximum nesting depth of the comment tree to traverse, e.g. 4 to include replies four levels deep.", "default": 4 }, "includeMedia": { "title": "🎬 $ Include media URLs", "type": "boolean", "description": "Extract image/video media URLs (i.redd.it, v.redd.it, imgur, galleries). Example: set to true to collect a post's attached image links.", "default": false }, "maxItems": { "title": "💯 Max items", "minimum": 1, "maximum": 100, "type": "integer", "description": "Hard cap on the total number of items saved in one run, e.g. 50. Keep this reasonable — a single run is limited to ~10 minutes.", "default": 50 }, "maxPostsPerSource": { "title": "💯 Max posts per source", "minimum": 1, "maximum": 100, "type": "integer", "description": "Cap on posts kept from each individual subreddit, user, or search, e.g. 25.", "default": 25 }, "maxPages": { "title": "📄 Max listing pages", "minimum": 1, "maximum": 20, "type": "integer", "description": "How many pages of a listing to paginate through (25 posts per page), e.g. 2 to walk 50 posts.", "default": 1 }, "ignoreStartUrls": { "title": "🚫 Ignore start URLs", "type": "boolean", "description": "Skip the Start URLs input even if provided. Example: set to true to reuse a saved input but scrape only subreddits this time.", "default": false }, "maxRetries": { "title": "🔁 Max request retries", "minimum": 0, "maximum": 6, "type": "integer", "description": "Retry attempts (with backoff) per failed request, e.g. 3.", "default": 3 }, "requestDelayMs": { "title": "⏱️ Delay between requests (ms)", "minimum": 0, "maximum": 10000, "type": "integer", "description": "Politeness delay between consecutive requests, e.g. 300 for a 0.3s pause.", "default": 300 }, "debug": { "title": "🐞 Debug logging", "type": "boolean", "description": "Emit verbose per-source logs (useful while testing your input). Example: set to true to see why a source returned no items.", "default": false } } }, "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 } } } } } } } } } } ```