# Ultimate Reddit Profile Scraper (`potatopeeler/reddit-scraper`) Actor Seamlessly download full Reddit user accounts, capturing posts, images, activity, and historical data, including URLs and media comments. Export detailed insights to CSV, JSON, XML, EXCEL formats, or effortlessly import them into your email for comprehensive analysis and easy access. - **URL**: https://apify.com/potatopeeler/reddit-scraper.md - **Developed by:** [Jamie Potato](https://apify.com/potatopeeler) (community) - **Categories:** Social media, E-commerce, Lead generation - **Stats:** 383 total users, 3 monthly users, 36.7% runs succeeded, 6 bookmarks - **User rating**: 5.00 out of 5 stars ## Pricing $25.00/month + usage To use this Actor, you pay a monthly rental fee to the developer. The rent is subtracted from your prepaid usage every month after the free trial period.You also pay for the Apify platform usage, which gets cheaper the higher Apify subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#rental-actors ## 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 Scraper Pro — Download Complete Profiles, Media & Archives > **Extract everything from any Reddit user.** Posts, comments, images, videos — full profile archives with every media link captured. Zero blocks, zero missing data. [![Apify Actor](https://img.shields.io/badge/Apify-Pro%20Actor-blue)](https://apify.com/potatopeeler/reddit-scraper) [![Zero Block](https://img.shields.io/badge/Zero--Block-Technology-green)](https://apify.com/potatopeeler/reddit-scraper) [![Media Support](https://img.shields.io/badge/Media-Images%20%2B%20Videos-red)](https://apify.com/potatopeeler/reddit-scraper) --- ### Why 2,000+ Users Choose This Scraper There are dozens of Reddit scrapers. Here's why the smart ones use ours: #### 📸 Complete Media Extraction Download **every image and video link** from any profile. Gallery albums, previews, thumbnails — nothing missed. Perfect for content archiving, personal backups, or media collections. #### 🚀 Turbo Mode Extraction Our parallel processing engine extracts data **3-5x faster** than sequential scrapers. While others crawl one page at a time, we intelligently batch requests for maximum throughput. #### 🛡️ Zero-Block Technology Other scrapers get you rate-limited. Ours doesn't. **Smart Throttling** adapts to Reddit's rate limits in real-time. Zero blocks. Zero failed runs. Zero missing content. #### 📊 Full-Fidelity Data (30+ Fields) Most scrapers strip data to save processing time. We extract **everything** — all 30+ fields per post/comment. Engagement metrics, flair data, award details, media links, timestamps. Nothing left behind. #### 🔄 Full Profile Archives Don't just scrape posts OR comments — get **everything**. Complete user history in one download. Years of content, fully preserved. #### 🔬 Battle-Tested Reliability Used by thousands of teams in production. Automatic retry logic, smart error handling, and graceful failure recovery. Your pipelines stay healthy even when Reddit hiccups. --- ### What Makes Us Different | Feature | Other Scrapers | Reddit Scraper Pro | |---------|---------------|-------------------| | Media extraction | Basic URLs only | **All images, videos, galleries, previews** | | Data completeness | 10-15 fields | **30+ fields** (full-fidelity) | | Profile archives | Posts only | **Posts + Comments + Everything mode** | | Speed | Sequential crawling | **Turbo Mode** (3-5x faster) | | Block rate | 5-15% of runs | **<0.1%** (Zero-Block Technology) | | NSFW content | Often skipped | **Fully supported** | --- ### Built for Serious Reddit Intelligence #### 🏢 Agencies & Consultancies Deliver Reddit insights to clients without worrying about failed scrapes or incomplete data. Run reports on dozens of accounts simultaneously. #### 📈 Market Research Teams Track brand sentiment, competitor mentions, and emerging trends across thousands of Reddit users. Full historical data, not just recent posts. #### 🤖 Data Engineering Teams Feed clean, complete Reddit data into your pipelines. Consistent schema, reliable delivery, production-grade error handling. #### 🔍 Competitive Intelligence Monitor competitor communities, track product feedback, identify influencers in your space. Deep archive access gets you years of historical context. --- ### Complete Data Extraction | Category | What You Get | |----------|--------------| | **Posts** | Title, body, URL, media links, score, upvote ratio, comments count, awards, flair, timestamps, edit status | | **Comments** | Full text, score, thread context, parent chain, controversiality, gilding, distinguished status | | **Profile (Everything)** | All posts + all comments combined in chronological order | | **Media & Galleries** | Direct image URLs, video links, gallery albums, thumbnail URLs, preview images | | **Engagement** | Upvotes, downvotes, award counts, cross-post data, share metrics | | **Metadata** | Subreddit details, subscriber counts, posting rules, content flags (NSFW, spoiler, OC) | **30+ fields per item. Nothing stripped. Full-fidelity extraction.** --- ### How It Works #### 1. Enter Any Reddit User ```` elonmusk ```` Or use the full profile URL — we handle both formats automatically. #### 2. Choose Your Extraction Type - **Posts** — All submissions (text posts, links, images, videos) - **Comments** — Complete comment history with thread context - **Profile** — Everything: all posts + all comments combined #### 3. Configure & Run ```json { "user": "elonmusk", "scrapeType": "posts", "limit": "all", "sort": "top", "time": "all" } ```` #### 4. Export Anywhere CSV, JSON, Excel, XML — integrate with any tool or pipeline. *** ### Input Options | Parameter | Description | Options | |-----------|-------------|---------| | `user` | Reddit username or profile URL | Any public user | | `scrapeType` | Data type to extract | `posts`, `comments`, `profile` | | `limit` | Results cap | `25` - `10000`, or `all` for everything | | `sort` | Sort order | `new`, `top`, `hot` | | `time` | Time filter | `hour`, `day`, `week`, `month`, `year`, `all` | *** ### Example Output #### Post Data (30+ fields) ```json { "subreddit": "IAmA", "title": "reddit, ready for Ruffalo? AMA.", "selftext": "Hello everyone, Mark Ruffalo here...", "author": "Mark_Ruffalo", "score": 10717, "upvote_ratio": 0.8, "num_comments": 3295, "total_awards_received": 12, "created_utc": 1430856892, "edited": false, "is_original_content": false, "is_self": true, "is_video": false, "over_18": false, "spoiler": false, "stickied": false, "locked": false, "subreddit_subscribers": 22579778, "url": "https://www.reddit.com/r/IAmA/comments/351yxe/...", "permalink": "/r/IAmA/comments/351yxe/...", "...": "...and 15+ more fields" } ``` #### Comment Data (30+ fields) ```json { "body": "One can only hope so! And it could DEFINITELY use a little ***SMASH.***", "author": "Mark_Ruffalo", "subreddit": "IAmA", "score": 276, "ups": 276, "downs": 0, "controversiality": 0, "total_awards_received": 0, "created_utc": 1430859012, "edited": false, "is_submitter": true, "link_title": "Mark Ruffalo, back again on reddit...", "link_author": "Mark_Ruffalo", "permalink": "/r/IAmA/comments/351yxe/.../cr07xvi/", "...": "...and 15+ more fields" } ``` *** ### Frequently Asked Questions #### Why is this better than other Reddit scrapers? Three things: **Zero-Block Technology** (we don't get rate limited), **Full-Fidelity Data** (30+ fields, nothing stripped), and **Turbo Mode** (3-5x faster extraction). Most scrapers cheap out on one or all of these. #### Will my scrapes get blocked? No. Our Smart Throttling engine monitors Reddit's responses in real-time and adjusts automatically. We maintain a **<0.1% block rate** across all runs. #### How fast is it? Turbo Mode processes requests in parallel batches. Depending on the account size, you'll see results **3-5x faster** than sequential scrapers. #### What if Reddit changes their API? We actively maintain this actor and typically push fixes within **24-48 hours** of any Reddit changes. Production-grade monitoring means we often catch issues before users report them. #### Is this legal? Yes. We access only publicly available data through Reddit's official API. No private or restricted data is ever collected. #### Is there a lighter option? Yes — we offer a [pay-per-use version](https://apify.com/potatopeeler/reddit-account-scraper-lite) for occasional scraping needs. *** ### Get Started 1. **[Rent Reddit Scraper Pro](https://apify.com/potatopeeler/reddit-scraper)** — Flat monthly rate, unlimited runs 2. **Enter a Reddit username** — Works with usernames or full URLs 3. **Run with Turbo Mode** — Get results in seconds, not minutes 4. **Export & integrate** — CSV, JSON, Excel, or direct API access *** ### Support Questions or issues? - [Open a ticket](https://apify.com/potatopeeler/reddit-scraper/issues/open) — We respond within 24 hours - [Apify documentation](https://docs.apify.com) *** *Zero-Block Technology. Turbo Mode. Full-Fidelity Data. The Reddit scraper built for production.* # Actor input Schema ## `user` (type: `string`): The Reddit users to scrape data from, this input accepts either the username or the user profile URL. ## `scrapeType` (type: `string`): Select the type of data to scrape/download, either posts, comments, or profile information. ## `filterOptions` (type: `string`): Advanced settings for the crawler, for time out, retry, and other settings. ## `limit` (type: `string`): how many items to retrieve, the crawler will stop after reaching this number, or when there are no more items to retrieve, whichever comes first. ## `sort` (type: `string`): select the order of the posts to be returned. The 'new' sort option returns the newest posts, 'hot' returns the posts with the most upvotes, and 'top' returns the posts with the highest score. ## `time` (type: `string`): Only applicable for the 'top' sort option. Select the time period for the top sort option, will be ignored for other sort options, returns the top posts from the selected time period. ## `proxy` (type: `object`): For best results, it's recommend to use residential proxy, the next best is datacenter proxy, and the last option is to use direct connection, or your own proxy. ## `advanced` (type: `string`): Advanced settings for the crawler, for time out, retry, and other settings. ## `maxRetries` (type: `integer`): How many retries until the scraper should give up ## `timeout` (type: `integer`): How long the scraper should wait for a response before giving up in seconds ## Actor input object example ```json { "user": "https://www.reddit.com/user/Mark_Ruffalo", "scrapeType": "posts", "limit": "100", "sort": "new", "time": "day", "proxy": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] }, "maxRetries": 3, "timeout": 10 } ``` # Actor output Schema ## `redditData` (type: `string`): Posts, comments, or complete profile data from the specified Reddit user # 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 = { "user": "https://www.reddit.com/user/Mark_Ruffalo", "scrapeType": "posts", "limit": "100", "sort": "new", "time": "day", "proxy": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] }, "maxRetries": 3, "timeout": 10 }; // Run the Actor and wait for it to finish const run = await client.actor("potatopeeler/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 = { "user": "https://www.reddit.com/user/Mark_Ruffalo", "scrapeType": "posts", "limit": "100", "sort": "new", "time": "day", "proxy": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], }, "maxRetries": 3, "timeout": 10, } # Run the Actor and wait for it to finish run = client.actor("potatopeeler/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 '{ "user": "https://www.reddit.com/user/Mark_Ruffalo", "scrapeType": "posts", "limit": "100", "sort": "new", "time": "day", "proxy": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] }, "maxRetries": 3, "timeout": 10 }' | apify call potatopeeler/reddit-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=potatopeeler/reddit-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Ultimate Reddit Profile Scraper", "description": "Seamlessly download full Reddit user accounts, capturing posts, images, activity, and historical data, including URLs and media comments. Export detailed insights to CSV, JSON, XML, EXCEL formats, or effortlessly import them into your email for comprehensive analysis and easy access.", "version": "1.6", "x-build-id": "fcA0S7iO3apMtJRob" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/potatopeeler~reddit-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-potatopeeler-reddit-scraper", "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/potatopeeler~reddit-scraper/runs": { "post": { "operationId": "runs-sync-potatopeeler-reddit-scraper", "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/potatopeeler~reddit-scraper/run-sync": { "post": { "operationId": "run-sync-potatopeeler-reddit-scraper", "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", "required": [ "user" ], "properties": { "user": { "title": "Reddit user", "type": "string", "description": "The Reddit users to scrape data from, this input accepts either the username or the user profile URL.", "default": "https://www.reddit.com/user/Mark_Ruffalo" }, "scrapeType": { "title": "Download user content type", "enum": [ "posts", "comments", "profile" ], "type": "string", "description": "Select the type of data to scrape/download, either posts, comments, or profile information.", "default": "posts" }, "filterOptions": { "title": "Filter options", "type": "string", "description": "Advanced settings for the crawler, for time out, retry, and other settings." }, "limit": { "title": "max number of posts to retrieve", "enum": [ "25", "50", "100", "200", "500", "1000", "2000", "5000", "10000", "all" ], "type": "string", "description": "how many items to retrieve, the crawler will stop after reaching this number, or when there are no more items to retrieve, whichever comes first.", "default": "100" }, "sort": { "title": "Sort Options", "enum": [ "new", "hot", "top" ], "type": "string", "description": "select the order of the posts to be returned. The 'new' sort option returns the newest posts, 'hot' returns the posts with the most upvotes, and 'top' returns the posts with the highest score.", "default": "new" }, "time": { "title": "Time Period", "enum": [ "hour", "day", "week", "month", "year", "all" ], "type": "string", "description": "Only applicable for the 'top' sort option. Select the time period for the top sort option, will be ignored for other sort options, returns the top posts from the selected time period.", "default": "day" }, "proxy": { "title": "Proxy Settings", "type": "object", "description": "For best results, it's recommend to use residential proxy, the next best is datacenter proxy, and the last option is to use direct connection, or your own proxy.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }, "advanced": { "title": "Advanced Settings", "type": "string", "description": "Advanced settings for the crawler, for time out, retry, and other settings." }, "maxRetries": { "title": "Max retries", "type": "integer", "description": "How many retries until the scraper should give up", "default": 3 }, "timeout": { "title": "Timeout", "type": "integer", "description": "How long the scraper should wait for a response before giving up in seconds", "default": 10 } } }, "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 } } } } } } } } } } ```