{ "openapi": "3.0.1", "info": { "title": "Reddit Data Scraper – Scrape Posts, Comments, Upvotes & More", "description": "Extract Reddit posts, comments, upvotes, and subreddit data with this powerful Reddit scraper. Ideal for data analysis, lead generation, trend research, and AI datasets. Scrape Reddit data at scale without API limits and export results in JSON, CSV, or Excel format.", "version": "0.0", "x-build-id": "CNtFLG07taKWZJPxh" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/sovanza.inc~reddit-data-scraper---scrape-posts-comments-upvotes-more/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-sovanza.inc-reddit-data-scraper---scrape-posts-comments-upvotes-more", "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/sovanza.inc~reddit-data-scraper---scrape-posts-comments-upvotes-more/runs": { "post": { "operationId": "runs-sync-sovanza.inc-reddit-data-scraper---scrape-posts-comments-upvotes-more", "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/sovanza.inc~reddit-data-scraper---scrape-posts-comments-upvotes-more/run-sync": { "post": { "operationId": "run-sync-sovanza.inc-reddit-data-scraper---scrape-posts-comments-upvotes-more", "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": { "productUrls": { "title": "Single/Multiple Post URL's", "type": "array", "description": "Enter one or more Reddit URLs to scrape: subreddit (e.g. https://reddit.com/r/python) or direct post URL (one per line). Same as Amazon/eBay scrapers. On Apify, enable Proxy (residential) or Reddit may return no data.", "items": { "type": "string" } }, "startUrls": { "title": "Start URLs (alternate)", "type": "array", "description": "Same as Post URL's; use if you prefer request list format.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "url": { "title": "Single URL (legacy)", "type": "string", "description": "One Reddit URL (subreddit or post)" }, "subreddit": { "title": "Subreddit name", "type": "string", "description": "Alternative to URLs: e.g. python, AskReddit (without r/)" }, "sort": { "title": "Sort (when using Subreddit name)", "enum": [ "hot", "new", "top", "rising", "controversial" ], "type": "string", "description": "Listing sort when input is subreddit name", "default": "hot" }, "maxPostsPerUrl": { "title": "Max posts per URL", "minimum": 1, "maximum": 100, "type": "integer", "description": "Max number of posts to fetch per subreddit listing (1–100)", "default": 25 }, "language": { "title": "Language", "enum": [ "en", "de", "es", "fr", "it", "ja", "pt", "nl", "pl", "tr", "sv", "ko", "ru" ], "type": "string", "description": "Language/locale for requests (Accept-Language header)", "default": "en" }, "proxyCountry": { "title": "Proxy Country", "enum": [ "AUTO_SELECT_PROXY_COUNTRY", "US", "GB", "DE", "FR", "JP", "CA", "IT" ], "type": "string", "description": "Reddit often blocks datacenter IPs. Enable Apify Proxy in the run and set country (required for reliable results on Apify).", "default": "AUTO_SELECT_PROXY_COUNTRY" }, "proxyUrl": { "title": "Custom proxy URL (Webshare etc.)", "type": "string", "description": "Optional. Use your own proxy (e.g. http://user:pass@proxy:80). Overrides Apify proxy when set." } } }, "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 } } } } } } } } } }