# Reddit Scraper - Fast, Comments,Data,Subreddits (`myagizm/reddit-scraper`) Actor Scrape public Reddit posts, comments, users, communities, and search results as structured JSON. No login, no API key. - **URL**: https://apify.com/myagizm/reddit-scraper.md - **Developed by:** [MYM](https://apify.com/myagizm) (community) - **Categories:** Social media - **Stats:** 2 total users, 0 monthly users, 95.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $1.10 / 1,000 reddit item scrapeds 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. - **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use). - **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`. - **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`. - **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`. - **Any other language** — 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 — Scrape Reddit Posts, Comments, Users & Search Results (No API Key, No Login)

Scrape Reddit at scale — turn any subreddit, Reddit URL, user profile, or keyword search into clean, structured data. No API key, no login, no cookies or account required.

Go beyond the limitations of the official Reddit API and scrape posts, comments, users, communities, and search results — all publicly available data — in a single run. 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: plug Reddit data straight into Claude, ChatGPT / Codex, and Cursor through the Apify MCP server — your agent calls the scraper as a tool and gets ready-to-use results.

Try Now Input Schema API Docs

What can it do • AI agents (MCP) • How to scrape Reddit • Output data • Limits • Example • Pricing • Integrations • FAQ • Other actors

*** ### What can Reddit Scraper do? {#what-can-reddit-scraper-do} **Reddit Scraper** is an all-in-one tool to scrape Reddit. Point it at subreddits, paste Reddit URLs, list usernames, or run keyword searches, and it returns clean, structured data you can drop straight into a spreadsheet, database, dashboard, or AI pipeline. There is **no API key to register**, **no login**, and **no cookies or account required** — the actor handles everything for you and just gives you the data. It is the flagship, multi-purpose scraper of the Reddit toolkit: one actor that can scrape Reddit posts, comments, users, communities, and search results in a single run. **Get your first results free in under 2 minutes.** If you need a narrower, single-purpose tool, see the dedicated siblings in [Want other Reddit data?](#want-other-reddit-data). #### ✅ Scrape subreddits by name Give it one or more subreddit names (`AskReddit`, `forhire`, `programming`) and it lists their posts in the sort order you choose — New, Hot, Top, Rising, or Controversial. Scrape a bunch of subreddits at once; the `r/` prefix is optional. #### 🗂️ Scrape any Reddit URL Paste post URLs, subreddit URLs, or user URLs into **Start URLs**. Each link is auto-detected and scraped with the right strategy — you can mix post, subreddit, and profile links in the same list. #### 💬 Scrape nested Reddit comments Turn on **Include comments** to pull threaded comment trees for each post, with full control over how many comments and how deep the nesting goes. Great for sentiment analysis, community research, and Q\&A mining. #### 👤 Scrape Reddit user submissions Provide a list of usernames and the scraper collects the posts each user submitted — perfect for tracking creators, competitors, or public figures. #### 🔍 Scrape Reddit keyword search results Run keyword searches and choose exactly what each query returns: posts, communities, users, or media-only posts. Optionally restrict every search to a specific set of subreddits. #### 🏷️ Scrape Reddit community metadata Fetch subreddit metadata — subscriber counts, descriptions, creation dates — without listing every post, using the **Communities** input. #### 📊 Structured, analysis-ready data Every item comes back with consistent, typed fields — score, author, timestamps, flair, media flags, comment counts and more — so it's ready for BI tools, notebooks, and LLMs without cleanup. No caching; fast, fresh data every run. #### 🔄 Filter, sort, and cap precisely Restrict by date, keyword, and NSFW flag; sort by New/Hot/Top; and cap results per source and per run so you only pay for what you need. *** ### Use Reddit Scraper with AI agents — Claude, ChatGPT & Cursor (MCP) {#use-with-ai-agents-mcp} Reddit Scraper is **MCP-ready**. Through the [Apify MCP server](https://apify.com/apify/actors-mcp-server), any Model Context Protocol client can call this actor as a native tool: - **Claude** (Claude Desktop, Claude Code) — ask Claude to "pull the last 50 hot posts from r/forhire" and it runs the scraper and reasons over the results. - **ChatGPT / Codex** — expose the actor as a tool in your custom GPT or agent stack. - **Cursor** — fetch live Reddit context while you code. Because the output is clean, structured data, it flows on into your favorite **integrations** — **Make, Zapier, n8n, Slack, Airbyte, Gumloop, CrewAI, IFTTT, Lindy, GitHub, Google Sheets, and Google Drive** — so an agent can scrape Reddit and then post, store, or enrich the data without extra glue code. *** ### How to scrape Reddit {#how-to-scrape-reddit} 1. Open **Reddit Scraper** on Apify: [apify.com/myagizm/reddit-scraper](https://apify.com/myagizm/reddit-scraper). 2. Choose your starting points — fill in **Subreddits**, paste **Start URLs**, add **Users**, or type **Search queries**. You can combine several in one run. 3. Set **Sort** and **Time range** to control ordering (e.g. Hot posts from the past week). 4. Optionally turn on **Include comments** and **Include media URLs**, and set date/keyword filters. 5. Set your caps — **Max items**, **Max posts per source**, **Max listing pages**. 6. Click **Start** ▶ and watch results stream into the dataset in real time. 7. Export as **JSON, CSV, Excel, or XML**, or pull the data via API (see [Integrations](#integrations)). No account, cookies, or tokens required — just describe what you want to scrape from Reddit and run. *** ### What data can I scrape from Reddit? {#what-data-can-i-scrape-from-reddit} Each post item includes fields like the following (exact fields depend on the content type and your options): | Field | Type | Description | |---|---|---| | `id` | string | Reddit fullname / thing ID (e.g. `t3_1v0ygr8`). | | `type` | string | Item type — `post`, `comment`, `user`, or `community`. | | `url` | string | Canonical URL of the item. | | `title` | string | Post title. | | `author` | string | Username of the author. | | `subreddit` | string | Subreddit the item belongs to. | | `selftext` | string | Self/body text of the post (when **Include post text** is on). | | `score` | integer/null | Net upvote score. | | `numComments` | integer | Number of comments on the post. | | `flair` | string | Post flair text, if any. | | `domain` | string | Source domain (e.g. `self.AskReddit`). | | `isSelf` | boolean | Whether the post is a text (self) post. | | `nsfw` | boolean | Whether the item is flagged over-18. | | `spoiler` | boolean | Whether the post is marked as a spoiler. | | `stickied` | boolean | Whether the post is pinned/stickied. | | `archived` | boolean | Whether the post is archived. | | `gilded` | boolean | Whether the post received awards. | | `edited` | boolean | Whether the post was edited. | | `thumbnail` | string | Thumbnail image URL, if present. | | `outboundUrl` | string | Outbound link for link posts. | | `createdUtc` | string | Creation timestamp (ISO 8601, UTC). | | `createdText` | string | Human-readable relative time (e.g. `just now`). | | `sourceType` | string | How the item was reached (e.g. `listing`, `search`). | | `scrapedAt` | string | When the item was scraped (ISO 8601). | > Comment items include their own fields (author, body, score, depth, parent), and community items include metadata such as subscriber counts and descriptions. *** ### Use cases — what you can do when you scrape Reddit - **Lead & job scouting** — monitor r/forhire, r/jobbit, and niche hiring subreddits for fresh gigs and clients. - **Market & product research** — track what people say about your product, category, or competitors. - **Sentiment & trend analysis** — feed posts and comments into NLP/LLM pipelines to measure opinion over time. - **Community management** — watch mentions of your brand or keywords across many subreddits at scale. - **Content & SEO ideas** — mine top posts and questions for content inspiration and long-tail keywords. - **AI training & RAG** — collect high-quality, real-world Q\&A and discussion data for retrieval and fine-tuning. *** ### Input examples — how to scrape Reddit your way All examples use the **real input field names** from the actor. Provide only the fields you need. #### Scrape one or more subreddits ```json { "subreddits": ["forhire", "AskReddit"], "sort": "hot", "maxPostsPerSource": 25, "maxItems": 50 } ``` #### Scrape from Reddit URLs (posts, subreddits, or users) ```json { "startUrls": [ { "url": "https://www.reddit.com/r/webdev/" }, { "url": "https://www.reddit.com/r/pics/comments/abc123/" } ], "includeSelftext": true, "maxItems": 50 } ``` #### Scrape Reddit posts and their comments ```json { "subreddits": ["programming"], "sort": "top", "time": "week", "includeComments": true, "maxComments": 50, "maxCommentDepth": 4, "maxItems": 40 } ``` #### Scrape a Reddit user's submissions ```json { "users": ["spez", "kn0thing"], "sort": "new", "maxPostsPerSource": 25 } ``` #### Scrape Reddit keyword search results ```json { "searchQueries": ["python developer", "remote developer"], "searchFor": ["posts"], "searchInSubreddits": ["forhire"], "sort": "relevance", "time": "month", "maxItems": 50 } ``` #### Filter by date, keyword, and NSFW ```json { "subreddits": ["forhire"], "postDateLimit": "2026-01-01", "searchTerms": ["hiring", "developer"], "includeNSFW": false, "includeMedia": true, "maxItems": 50 } ``` *** ### Full input reference | Field | Type | Default | Description | |---|---|---|---| | `subreddits` | array | `["forhire"]` | Subreddit names to scrape (`r/` optional). | | `startUrls` | array | `[{r/webdev}]` | Reddit URLs (post/subreddit/user), auto-detected. | | `users` | array | `["spez"]` | Usernames whose submissions to scrape (`u/` optional). | | `communities` | array | `["technology"]` | Subreddit names to fetch metadata for (no post listing). | | `searchQueries` | array | — | Keywords to search across Reddit. | | `searchFor` | array | `["posts"]` | Entity types per query: `posts`, `comments`, `communities`, `users`, `media`. | | `searchInSubreddits` | array | — | Restrict each search query to these subreddits. | | `sort` | string | `new` | `new`, `hot`, `top`, `rising`, `controversial`, `relevance`. | | `time` | string | `all` | Time window for Top / Controversial / search. | | `postDateLimit` | string | — | Keep only posts on/after `YYYY-MM-DD`. | | `commentDateLimit` | string | — | Keep only comments on/after `YYYY-MM-DD`. | | `searchTerms` | array | — | Keep only posts whose title/body contains one of these words. | | `includeNSFW` | boolean | `false` | Include over-18 / NSFW posts. | | `includeSelftext` | boolean | `true` | Fetch each post's self/body text. | | `includeComments` | boolean | `false` | Scrape nested comments per post. | | `maxComments` | integer | `20` | Max comments per post (0–100). | | `maxCommentDepth` | integer | `4` | Max comment nesting depth (0–15). | | `includeMedia` | boolean | `false` | Extract image/video media URLs. | | `maxItems` | integer | `50` | Hard cap on total items per run (1–100). | | `maxPostsPerSource` | integer | `25` | Cap on posts per subreddit/user/search (1–100). | | `maxPages` | integer | `1` | Listing pages to paginate (25 posts/page, 1–20). | | `ignoreStartUrls` | boolean | `false` | Skip Start URLs even if provided. | | `maxRetries` | integer | `3` | Retry attempts per failed request (0–6). | | `requestDelayMs` | integer | `300` | Politeness delay between requests in ms (0–10000). | | `debug` | boolean | `false` | Verbose per-source logging. | *** ### Limiting results {#limits} Use these fields to keep runs fast and control cost: - **`maxItems`** (default `50`, max `100`) — a hard cap on the total number of items saved in one run. - **`maxPostsPerSource`** (default `25`, max `100`) — caps how many posts are kept from each individual subreddit, user, or search. - **`maxPages`** (default `1`, max `20`) — how many listing pages to paginate through (25 posts per page). - **`maxComments`** (default `20`, max `100`) — comments scraped per post when **Include comments** is on. - **`maxCommentDepth`** (default `4`, max `15`) — how deep into the comment tree to traverse. > Runs are kept intentionally fast and fair: a single run lasts at most ~10 minutes, and one long-running job is processed at a time. For very large collections, split your work into several focused runs (for example, one subreddit or search per run) or schedule them. *** ### Output example {#output-example} A single post item straight from the dataset: ```json { "id": "t3_1v0ygr8", "url": "https://www.reddit.com/r/AskReddit/comments/1v0ygr8/why_would_you_put_coconut_cream_in_cilantro_lime/", "nsfw": false, "type": "post", "flair": "", "score": null, "title": "Why would you put coconut cream in cilantro lime rice?", "author": "In8MoreHours", "domain": "self.AskReddit", "edited": false, "gilded": false, "isSelf": true, "spoiler": false, "archived": false, "selftext": "", "stickied": false, "scrapedAt": "2026-07-19T18:42:43.748Z", "subreddit": "AskReddit", "thumbnail": "", "createdUtc": "2026-07-19T18:42:10+00:00", "sourceType": "listing", "createdText": "just now", "numComments": 1, "outboundUrl": "https://www.reddit.com/r/AskReddit/comments/1v0ygr8/why_would_you_put_coconut_cream_in_cilantro_lime/" } ``` *** ### How much does it cost to scrape Reddit? {#how-much-does-it-cost-to-scrape-reddit} Reddit Scraper uses a simple **pay-per-result** model — you pay for the data you actually collect, not for the time the scraper spends working. Because the actor is optimized to be **fast and efficient**, most runs cost only a few cents, and you stay in full control with `maxItems`, `maxPostsPerSource`, and `maxPages`. There are **no limitations on the number of requests or calls** beyond the per-run caps you set. New Apify accounts include **free monthly usage credits**, so you can **get your first results free in under 2 minutes** at no cost. See the live pricing on the [actor page](https://apify.com/myagizm/reddit-scraper) for exact numbers. *** ### Integrate with n8n, Zapier, and Make {#integrations} Reddit Scraper works anywhere the Apify API works. Trigger it from **n8n, Zapier, Make, or your own code**, and read results from the dataset. #### Run and get results synchronously ```bash curl -X POST "https://api.apify.com/v2/acts/myagizm~reddit-scraper/run-sync-get-dataset-items?token=YOUR_APIFY_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "subreddits": ["forhire"], "sort": "hot", "maxItems": 50 }' ``` This starts the run, waits for it to finish, and returns the dataset items in one call — ideal for automations that need results immediately. #### Start a run asynchronously ```bash curl -X POST "https://api.apify.com/v2/acts/myagizm~reddit-scraper/runs?token=YOUR_APIFY_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "searchQueries": ["python developer"], "searchFor": ["posts"], "maxItems": 50 }' ``` Then poll the run or fetch its dataset once it's ready: ```bash curl "https://api.apify.com/v2/datasets/DATASET_ID/items?token=YOUR_APIFY_TOKEN&format=json" ``` You can also use the official **Apify integrations** for n8n, Zapier, and Make to run the actor and route results into Sheets, Airtable, Slack, Notion, and hundreds of other apps — no code required. *** ### Support {#support} Questions, bugs, or feature requests? Open an issue on the **Issues** tab of the [actor page](https://apify.com/myagizm/reddit-scraper), or contact the developer through Apify. Feedback is welcome and helps improve the scraper. *** ### Want other Reddit data? {#want-other-reddit-data} Need a narrower, single-purpose tool? Reddit Scraper is the all-in-one flagship, but the rest of the Reddit toolkit by **myagizm** targets each job precisely: - [Reddit Comment Scraper](https://apify.com/myagizm/reddit-comment-scraper) — scrape threaded comments from any post or thread. - [Reddit Subreddit Scraper](https://apify.com/myagizm/reddit-subreddit-scraper) — deep-dive a single subreddit's posts and listings. - [Reddit Search Scraper](https://apify.com/myagizm/reddit-search-scraper) — run keyword searches across Reddit and collect matching results. - [Reddit Profile Scraper](https://apify.com/myagizm/reddit-profile-scraper) — collect a user's submitted posts and public activity. - [Reddit Community Scraper](https://apify.com/myagizm/reddit-community-scraper) — fetch subreddit metadata: subscribers, description, and more. Scraping other platforms too? Try [Facebook Page Scraper](https://apify.com/myagizm/facebook-page-scraper), [Instagram Profile Scraper](https://apify.com/myagizm/instagram-profile-scraper), or [YouTube Channel Scraper](https://apify.com/myagizm/youtube-channel-scraper). *** ### FAQ — scraping Reddit {#faq} #### Is it legal to scrape Reddit? Scraping **publicly available** data is generally legal in most jurisdictions. This actor only accesses content that anyone can see on Reddit without logging in. You are responsible for how you use the data — respect privacy laws (such as GDPR/CCPA), Reddit's terms, and copyright. This is not legal advice. #### Do I need a Reddit API key or account to scrape Reddit? No. There is **no API key, no login, and no cookies or account required**. The actor handles access for you — just enter what you want to scrape and run it. #### Can I use Reddit Scraper with the Apify API? Yes. Start runs and fetch datasets programmatically via the [Apify API](https://docs.apify.com/api/v2) using the actor path `myagizm~reddit-scraper`. See the [Integrations](#integrations) section for ready-to-use `curl` snippets. #### Can I scrape Reddit data through an MCP server (AI agents)? Yes. Reddit Scraper is available through the [Apify MCP server](https://apify.com/apify/actors-mcp-server), so MCP-compatible AI agents like Claude, ChatGPT, and Cursor can call it as a tool and work with the results directly. #### Do I need proxies to scrape Reddit? No. The scraper manages connectivity and reliability internally, so you don't need to set up cookies, sessions, or proxies. Everything works out of the box. #### Can I integrate Reddit data with other apps? Yes. Route results into **Make, Zapier, n8n, Slack, Google Sheets, Airtable, Notion**, and hundreds of other apps using Apify's official integrations, webhooks, or the API. #### Can I export Reddit data to CSV, Excel, or JSON? Yes. After a run, open the **Storage / Dataset** tab and export as **JSON, CSV, Excel, or XML** with one click, or pull the data via the API in your preferred format. #### Can I scrape multiple subreddits at once? Yes. You can mix `subreddits`, `startUrls`, `users`, `communities`, and `searchQueries` in a single run — the scraper handles each source type appropriately and scrapes them all at once. #### Can I schedule the Reddit scraper? Yes. Use Apify **Schedules** to run the scraper on any cadence (hourly, daily, weekly) and route new results into your tools automatically. #### Can I scrape data from private subreddits or accounts? No. Reddit Scraper collects only **publicly available data** — content that anyone can view without logging in. Private or restricted communities and content are not accessible. #### How many items can I scrape per run? Up to `maxItems` (max **100** per run), with per-source and per-page caps. A single run lasts at most ~10 minutes. For larger collections, split work across multiple focused runs or schedule them. #### How fast is the Reddit scraper? Very fast. Runs are optimized to complete quickly with fresh data (no caching), and typical result-limited runs finish in well under the 10-minute cap. #### Can I scrape Reddit comments? Yes. Turn on **Include comments** and control volume with `maxComments` and depth with `maxCommentDepth`. #### Can I filter scraped Reddit posts by date? Yes. Use `postDateLimit` and `commentDateLimit` (`YYYY-MM-DD`) to keep only items created on or after a given date, and `time` to bound Top/search windows. #### Can I search only within specific subreddits? Yes. Add subreddit names to `searchInSubreddits` and each `searchQueries` entry is restricted to those subreddits. #### Can I include NSFW posts? By default NSFW posts are excluded. Set `includeNSFW` to `true` to include over-18 content. #### Why is a field like `score` sometimes null? Some values (such as a very fresh post's score) may not yet be finalized by Reddit at scrape time and can come back as `null`. Older posts return stable values. *** ### 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 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. This actor is intended to collect only publicly available data and should be used in compliance with applicable laws and platform terms. *** ### Resources {#resources} - 📘 [Apify API documentation](https://docs.apify.com/api/v2) — run actors and fetch datasets programmatically. - 🤖 [Apify MCP server](https://apify.com/apify/actors-mcp-server) — connect this actor to Claude, ChatGPT, and Cursor. - 📤 [Dataset export docs](https://docs.apify.com/platform/storage/dataset) — export to JSON, CSV, Excel, and XML. - 🔌 [Apify integrations](https://docs.apify.com/platform/integrations) — n8n, Zapier, Make, Slack, Schedules, and more. *** ## 中文说明 —— Reddit 综合抓取工具（V1） > **V1 = 轻量低价线。** 本 Actor 为 V1：自包含、价格最低、尽力而为。若需要更稳定的交付与更全的字段，请使用同一功能的 **V2** 版本（见 [myagizm 商店主页](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 / 数据团队** —— 构建帖子 + 评论语料。 - 🏢 **品牌监测** —— 跟踪品牌在各版块的讨论。 - 📰 **研究者与记者** —— 可复现地采集社区讨论。 ### 可以抓取哪些数据 | 字段 | 类型 | 说明 | |------|------|------| | `id` | string | 记录 ID（帖子如 `t3_...`，评论如 `t1_...`） | | `type` | string | 记录类型（`post` / `comment` / `user` / `community`） | | `url` | string | 永久链接 | | `title` | string | 帖子标题 | | `author` | string | 作者用户名 | | `subreddit` | string | 所属子版块 | | `selftext` | string | 帖子正文（开启 *Include post text* 时返回） | | `numComments` | integer | 评论数 | | `flair` | string | 帖子 flair 标签 | | `domain` | string | 来源域名（如 `self.AskReddit`、`i.redd.it`） | | `isSelf` | boolean | 是否为纯文本自帖 | | `nsfw` | boolean | 是否标记为成人内容 | | `spoiler` | boolean | 是否标记为剧透 | | `stickied` | boolean | 是否在版块内置顶 | | `archived` | boolean | 是否已归档 | | `gilded` | boolean | 是否获得奖励 | | `edited` | boolean | 是否被编辑过 | | `thumbnail` | string | 缩略图地址 | | `outboundUrl` | string | 帖子指向的链接（外链帖为外部地址，自帖为永久链接） | | `createdUtc` | string | 创建时间（ISO 8601，UTC） | | `createdText` | string | 人类可读的相对时间（如 `11 hours ago`） | | `sourceType` | string | 该行的采集方式（如 `listing`） | | `scrapedAt` | string | 该行的抓取时间（ISO 8601） | > 字段取决于该条目公开了什么；不存在的值返回 `null`，数据结构保持稳定。 ### 输入示例 ```json { "subreddits": ["forhire", "AskReddit"], "sort": "hot", "maxPostsPerSource": 25, "maxItems": 50 } ``` ### 输出示例 ```json { "id": "t3_1v0ygr8", "url": "https://www.reddit.com/r/AskReddit/comments/1v0ygr8/why_would_you_put_coconut_cream_in_cilantro_lime/", "nsfw": false, "type": "post", "flair": "", "score": null, "title": "Why would you put coconut cream in cilantro lime rice?", "author": "In8MoreHours", "domain": "self.AskReddit", "edited": false, "gilded": false, "isSelf": true, "spoiler": false, "archived": false, "selftext": "", "stickied": false, "scrapedAt": "2026-07-19T18:42:43.748Z", "subreddit": "AskReddit", "thumbnail": "", "createdUtc": "2026-07-19T18:42:10+00:00", "sourceType": "listing", "createdText": "just now", "numComments": 1, "outboundUrl": "https://www.reddit.com/r/AskReddit/comments/1v0ygr8/why_would_you_put_coconut_cream_in_cilantro_lime/" } ``` ### 价格 采用**按结果计费**：只为真正拿到的数据付费，不按运行时间收费。 - 💸 成本 = 结果数量 × 单价，预算可提前算清。 - 📉 Apify 的 Bronze / Silver / Gold / Platinum / Diamond 套餐享阶梯折扣。 - 🆓 新账号自带每月免费额度，第一次运行不花钱。 - 🚫 无代理附加费、无单次请求费、无最低消费。 实时价格见 [Apify 商店页面](https://apify.com/myagizm/reddit-scraper)。 ### 使用建议 - 📏 **先用小 `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/run-sync-get-dataset-items?token=YOUR_APIFY_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "subreddits": ["forhire", "AskReddit"], "sort": "hot", "maxPostsPerSource": 25, "maxItems": 50 }' ``` 把 `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. ## `startUrls` (type: `array`): Paste any Reddit URLs (post, subreddit, or user). 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. ## `searchQueries` (type: `array`): Keywords to search across Reddit. Each query is run for every type selected in "Search for". ## `searchFor` (type: `array`): Which entity types each search query should return. ## `searchInSubreddits` (type: `array`): If set, each search query is restricted to these subreddits only. ## `sort` (type: `string`): Sort order for listings and search results. ## `time` (type: `string`): Time window used by Top / Controversial / search. ## `postDateLimit` (type: `string`): Keep only posts created on or after this date. Leave empty for no limit. ## `commentDateLimit` (type: `string`): Keep only comments created on or after this date. Leave empty for no limit. ## `searchTerms` (type: `array`): Keep only posts whose title or body contains at least one of these words (case-insensitive). ## `includeNSFW` (type: `boolean`): Include posts flagged as over-18 / NSFW. ## `includeSelftext` (type: `boolean`): Fetch each post's self/body text. ## `includeComments` (type: `boolean`): Scrape nested comments for each post (slower). ## `maxComments` (type: `integer`): Upper bound on comments scraped per post when "Include comments" is on. ## `maxCommentDepth` (type: `integer`): Maximum nesting depth of the comment tree to traverse. ## `includeMedia` (type: `boolean`): Extract image/video media URLs (i.redd.it, v.redd.it, imgur, galleries). ## `maxItems` (type: `integer`): Hard cap on the total number of items saved in one run. 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. ## `maxPages` (type: `integer`): How many pages of a listing to paginate through (25 posts per page). ## `ignoreStartUrls` (type: `boolean`): Skip the Start URLs input even if provided. ## `maxRetries` (type: `integer`): Retry attempts (with backoff) per failed request. ## `requestDelayMs` (type: `integer`): Politeness delay between consecutive requests. ## `debug` (type: `boolean`): Emit verbose per-source logs (useful while testing your input). ## 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").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").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 --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=myagizm/reddit-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification Download the OpenAPI definition: https://api.apify.com/v2/actors/ouzcDf7PtRfmf6F6V/builds/OhGfCrwWFNx41dYIG/openapi.json