{ "openapi": "3.0.1", "info": { "title": "Reddit Comments Scraper: Export Comments and Replies", "description": "Scrape Reddit comments and replies from any post: one row per comment with author, text, score, depth, parent id, time and permalink. Opens \"load more comments\" for up to 10,000 comments per post. Sort by best, top, new, controversial, old or Q&A. No login. Monitor mode for new comments.", "version": "0.1", "x-build-id": "vX9qVATLsFK6dcj4N" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/themineworks~reddit-comments-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-themineworks-reddit-comments-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/themineworks~reddit-comments-scraper/runs": { "post": { "operationId": "runs-sync-themineworks-reddit-comments-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/themineworks~reddit-comments-scraper/run-sync": { "post": { "operationId": "run-sync-themineworks-reddit-comments-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": [ "postUrls" ], "properties": { "postUrls": { "title": "Reddit post URLs", "type": "array", "description": "The posts whose comments you want, one per line. Any of these forms works: https://www.reddit.com/r/AskReddit/comments/1wy51c1/what_cheat_code_for_life_do_you_wish_youd/ (www, old, new or np), https://redd.it/1wy51c1, or just the post id 1wy51c1. Share links (reddit.com/r//s/) are opened to find the post. Up to 1,000 posts per run; the same post given twice is read once.", "items": { "type": "string" } }, "maxCommentsPerPost": { "title": "Max comments per post", "minimum": 1, "maximum": 10000, "type": "integer", "description": "The most comments (top level comments and replies together) to return for each post, 1 to 10,000. The first request returns up to about 490; beyond that the actor opens Reddit's \"load more comments\" links, about 95 comments per extra request. Example: 2000.", "default": 500 }, "maxDepth": { "title": "Reply depth", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many levels of the thread to return: 1 = top level comments only, 2 = plus their direct replies, up to 10 (Reddit's own limit). Default 10 returns every level Reddit serves.", "default": 10 }, "commentSort": { "title": "Comment order", "enum": [ "best", "top", "new", "controversial", "old", "qa" ], "type": "string", "description": "The order Reddit sorts the thread in, which also decides which comments come first when maxCommentsPerPost cuts the thread. Use new with monitor mode to catch fresh comments.", "default": "best" }, "monitorMode": { "title": "Monitor mode (only new comments)", "type": "boolean", "description": "Deliver and charge only comments that earlier runs of this actor in your account have not delivered. Put the same input on a schedule to collect new comments on a thread as they arrive.", "default": false }, "clientId": { "title": "Reddit client ID (optional)", "type": "string", "description": "Leave blank. Optional: your own Reddit app client ID (type 'installed app', from https://www.reddit.com/prefs/apps) so your requests are not counted against the shared client ID's rate limit." } } }, "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 } } } } } } } } } }