{ "openapi": "3.0.1", "info": { "title": "Reddit Scraper - Posts, Comments, Subreddits, No API Key", "description": "Scrape Reddit posts, complete comment threads, search results and user profiles without an API key. Expands every \"load more comments\", 4x more comments than first-page scrapers. Export to CSV, Excel or JSON. For data scientists, engineers and researchers.", "version": "1.5", "x-build-id": "IChEvnLDcADaMkm7d" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/kalilfagundes.w~reddit-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-kalilfagundes.w-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/kalilfagundes.w~reddit-scraper/runs": { "post": { "operationId": "runs-sync-kalilfagundes.w-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/kalilfagundes.w~reddit-scraper/run-sync": { "post": { "operationId": "run-sync-kalilfagundes.w-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", "properties": { "includeComments": { "title": "💬 Extract Comments", "type": "boolean", "description": "Also fetch the comments of each post in Subreddit Posts and Search mode. Uncheck to collect only the posts: one request per 25 posts instead of one extra request per post, so runs are much faster and use far less residential proxy traffic. Comments count toward maxResults, so raise maxResults when this is on; no single post may use more than a fifth of it. Post Comments mode always extracts comments, and User Profile mode uses User Content Type instead.", "default": true }, "mode": { "title": "🎯 Scraping Mode", "enum": [ "subreddit_posts", "search", "user_profile", "post_comments" ], "type": "string", "description": "What type of Reddit data to scrape.", "default": "subreddit_posts" }, "subreddits": { "title": "📌 Subreddits", "type": "array", "description": "List of subreddit names to scrape (without r/ prefix). Example: python, webdev, machinelearning", "items": { "type": "string" } }, "sort": { "title": "🔃 Sort Order", "enum": [ "hot", "new", "top", "rising", "controversial" ], "type": "string", "description": "How to sort subreddit posts.", "default": "hot" }, "timeFilter": { "title": "📅 Time Filter (Top sort only)", "enum": [ "hour", "day", "week", "month", "year", "all" ], "type": "string", "description": "Time range filter. Applies ONLY when the sort is Top: that means sort='top' in Subreddit Posts mode, or searchSort='top' in Search mode. With any other sort value this field is accepted but has no effect.", "default": "week" }, "searchQuery": { "title": "🔍 Search Query", "type": "string", "description": "Keyword or phrase to search across Reddit. IMPORTANT: Reddit matches loose words by default, not phrases. To match an exact phrase, wrap it in double quotes: \"looking for an alternative to\". (When sending input as JSON, the quotes must be escaped.) An unquoted multi-word query returns largely unrelated posts. Use searchQueriesList for multiple queries in one run." }, "searchQueriesList": { "title": "🔍 Search Queries List (Batch Search)", "type": "array", "description": "Run several search queries in one job; overrides Search Query. maxResults is one shared budget used in order, so later queries return nothing once it is spent. Wrap each phrase in double quotes for exact matching, e.g. \"looking for an alternative to\" (escape the quotes in JSON); unquoted phrases return loosely matched, mostly irrelevant posts. Results are merged and deduplicated by post ID. Ideal for brand monitoring and competitor research.", "items": { "type": "string" } }, "searchSubreddit": { "title": "📌 Limit Search to Subreddit", "type": "string", "description": "Optional: restrict search to a specific subreddit (without r/ prefix). Leave empty to search all of Reddit." }, "searchSort": { "title": "🔃 Search Sort Order", "enum": [ "relevance", "hot", "top", "new", "comments" ], "type": "string", "description": "How to sort search results. Relevance, the default, favours highly upvoted posts, which are often several years old. For recent results use Top together with timeFilter, or New for the newest posts regardless of engagement.", "default": "relevance" }, "usernames": { "title": "👤 Usernames", "type": "array", "description": "List of Reddit usernames to scrape (without u/ prefix).", "items": { "type": "string" } }, "userContentType": { "title": "📋 User Content Type", "enum": [ "overview", "submitted", "comments" ], "type": "string", "description": "What type of content to scrape from user profiles.", "default": "overview" }, "postUrls": { "title": "💬 Post URLs", "type": "array", "description": "Full Reddit post URLs to extract comments from.", "items": { "type": "string" } }, "maxCommentsPerPost": { "title": "🔢 Max Comments per Post", "minimum": 0, "type": "integer", "description": "Maximum number of comments to extract per post. Set to 0 for no per-post limit. In Subreddit Posts and Search mode, comments count toward maxResults and a single post may use at most a fifth of it, so one long thread cannot fill the run before the second post is reached. The run log says so when that lowers this number. Post Comments mode is not capped this way: there the thread is the target.", "default": 100 }, "maxResults": { "title": "🔢 Max Results", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum number of results for the whole run. This is a shared total, not a per-query limit: when using searchQueriesList the budget is consumed one query at a time, so allow at least 25 per query you expect results from. Up to 10,000.", "default": 100 }, "includeNsfw": { "title": "🔞 Include NSFW Content", "type": "boolean", "description": "When enabled, adult/NSFW content is included in results. Default is off, which filters out NSFW posts and the comments on them, so a filtered post never leaves its thread behind.", "default": false }, "proxyConfiguration": { "title": "🔒 Proxy Configuration", "type": "object", "description": "Proxy settings. Residential proxies are strongly recommended, Reddit blocks most datacenter IPs." } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }