{ "openapi": "3.0.1", "info": { "title": "Reddit Posts Scraper: Subreddits, Search & URLs", "description": "Reddit posts scraper and Reddit posts API: scrape Reddit posts and subreddit posts from any subreddit, search, user or post URL, no login. Title, full text, score, upvote ratio, comment count, flair, author, images, video and links, plus each post's comments if you want them. You pay per post.", "version": "0.1", "x-build-id": "gajRCSEE0hgv9vhiM" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/deepmine~reddit-posts-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-deepmine-reddit-posts-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/deepmine~reddit-posts-scraper/runs": { "post": { "operationId": "runs-sync-deepmine-reddit-posts-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/deepmine~reddit-posts-scraper/run-sync": { "post": { "operationId": "run-sync-deepmine-reddit-posts-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": { "startUrls": { "title": "🔗 Reddit URLs", "type": "array", "description": "Any Reddit link, one per row: a subreddit (r/technology/top/?t=week), a search (reddit.com/search/?q=...), a user (u/spez) or a post. You get their posts.", "items": { "type": "object", "properties": { "url": { "title": "URL", "type": "string", "description": "A Reddit link.", "pattern": "\\S" } } } }, "searches": { "title": "🔍 Search terms", "type": "array", "description": "Words to search all of Reddit's posts for, one per line, e.g. chatgpt alternative. Sort, period and one-subreddit search are under Search options.", "items": { "type": "string", "pattern": "\\S" } }, "maxItemsPerSource": { "title": "📊 Max posts per source", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Most posts per URL, search term, subreddit or user. Reddit lists about 1,000 posts per subreddit sort and about 250 per search sort; 'Maximize coverage' gets more from a search.", "default": 100 }, "maxResults": { "title": "🧮 Max results (total)", "minimum": 1, "maximum": 10000000, "type": "integer", "description": "Most rows for the whole run, every source counted together (comments too, if you turn them on). Empty = no total cap." }, "subreddits": { "title": "Subreddits", "type": "array", "description": "Subreddit names (Python or r/Python), one per line. Their posts are read in the order set by 'Subreddit sort'.", "items": { "type": "string", "pattern": "\\S" } }, "sort": { "title": "Subreddit sort", "enum": [ "hot", "new", "top", "rising", "controversial" ], "type": "string", "description": "Order of subreddit posts, as on Reddit.", "default": "hot" }, "time": { "title": "Subreddit period", "enum": [ "hour", "day", "week", "month", "year", "all" ], "type": "string", "description": "Period for the Top and Controversial sorts.", "default": "day" }, "users": { "title": "Users", "type": "array", "description": "Reddit usernames (spez or u/spez), one per line. You get their posts, newest first.", "items": { "type": "string", "pattern": "\\S" } }, "searchSort": { "title": "Search sort", "enum": [ "relevance", "new", "top", "comments", "hot" ], "type": "string", "description": "Order of search results.", "default": "relevance" }, "searchTime": { "title": "Search period", "enum": [ "hour", "day", "week", "month", "year", "all" ], "type": "string", "description": "How far back a search looks.", "default": "all" }, "withinSubreddit": { "title": "Search only in this subreddit", "type": "string", "description": "Optional subreddit name (e.g. technology) to limit search terms to." }, "maximizeCoverage": { "title": "Maximize coverage", "type": "boolean", "description": "Reddit stops a search at about 250 posts per sort. On: each search is also read in other sorts and periods (new, top by year, month, week...) and merged without duplicates.", "default": false }, "postedAfter": { "title": "Posted after", "type": "string", "description": "Only posts from after this date: 2026-09-01, 2026-09-01T12:00:00Z, or a period like '7 days' or '12 hours'." }, "postedBefore": { "title": "Posted before", "type": "string", "description": "Only posts from before this date (same formats)." }, "minScore": { "title": "Minimum score", "minimum": -100000, "maximum": 10000000, "type": "integer", "description": "Skip posts with a lower score (upvotes minus downvotes), e.g. 10. Empty = no minimum." }, "includeNSFW": { "title": "Include NSFW (18+)", "type": "boolean", "description": "Keep posts and communities marked 18+.", "default": true }, "includeComments": { "title": "💬 Include comments", "type": "boolean", "description": "Add each post's comments, replies included, right after the post. Each comment is one result.", "default": false }, "maxCommentsPerPost": { "title": "💬 Max comments per post", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Most comments to read per post, replies included, in Reddit's thread order (e.g. 4 for a quick look, 500 for whole threads).", "default": 100 }, "commentDepth": { "title": "Comment depth", "minimum": 1, "maximum": 10, "type": "integer", "description": "How deep in reply chains to go: 1 = top-level comments only, 10 = Reddit's maximum.", "default": 10 }, "commentSort": { "title": "Comment sort", "enum": [ "confidence", "top", "new", "controversial", "old", "qa" ], "type": "string", "description": "Order of comments, as on Reddit.", "default": "confidence" }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Leave as is: Reddit answers Apify's datacenter proxy, the cheapest option. If you pick Residential, the run still reads through datacenter and uses your residential IPs only to retry a call Reddit refuses there.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }