{ "openapi": "3.0.1", "info": { "title": "Reddit Comments Scraper - Threads & Replies ($1.29/1K)", "description": "Export every public comment and reply from 1 to 100 Reddit posts as flat rows with text, author, score, dates, parent ID and reply depth, so you can rebuild each thread. Six sort orders plus depth and size limits. Deleted comments are never charged. From $1.29 per 1,000.", "version": "0.2", "x-build-id": "k9i8RYKHLExWSbRvD" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/studioxl~reddit-comments-replies-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-studioxl-reddit-comments-replies-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/studioxl~reddit-comments-replies-scraper/runs": { "post": { "operationId": "runs-sync-studioxl-reddit-comments-replies-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/studioxl~reddit-comments-replies-scraper/run-sync": { "post": { "operationId": "run-sync-studioxl-reddit-comments-replies-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 links", "minItems": 1, "maxItems": 100, "type": "array", "description": "One post per line, up to 100. Full post links, old.reddit and mobile links, redd.it links, comment links and post IDs (like luq9oz) all work. Lines that aren't Reddit posts are skipped and listed in the run summary.", "items": { "type": "string" }, "default": [ "https://www.reddit.com/r/programming/comments/luq9oz/" ] }, "sort": { "title": "Comment order", "enum": [ "CONFIDENCE", "TOP", "NEW", "CONTROVERSIAL", "OLD", "QA" ], "type": "string", "description": "Order Reddit uses for the thread. It decides which comments come first when a limit cuts the thread short.", "default": "CONFIDENCE" }, "maxCommentsPerPost": { "title": "Max comments per post", "minimum": 0, "maximum": 100000, "type": "integer", "description": "Stops one big thread from using the whole run. 0 means no limit.", "default": 100 }, "maxComments": { "title": "Max comments in total", "minimum": 0, "maximum": 100000, "type": "integer", "description": "Most comments to save across all posts. You pay only for saved comments. 0 means no limit.", "default": 500 }, "maxDepth": { "title": "Max reply depth", "minimum": -1, "maximum": 1000, "type": "integer", "description": "0 keeps top-level comments only, 1 adds direct replies, and so on. -1 keeps every level.", "default": 8 }, "includeDeleted": { "title": "List deleted and removed comments", "type": "boolean", "description": "Deleted and removed comments have no text and are never charged. Turn this on to list them in a separate free record (DELETED_AND_REMOVED) so you can see where gaps in a thread are.", "default": false }, "maximizeCoverage": { "title": "Extra passes for more comments", "type": "boolean", "description": "Very large threads show only part of their comments in any one order. With this on, the scraper also reads the thread in the other orders (New, Old, Top, Controversial) and adds only comments it has not seen yet. On automatically when both comment limits are 0." } } }, "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 } } } } } } } } } }