{ "openapi": "3.0.1", "info": { "title": "Reddit Posts & Threads by Date Range | Comments", "description": "2026-10-12 test, 20 matched posts: a 22-day-old archive differed on 9 scores, 5 comment counts. Comments USD 0.00015 each (FREE). Live Reddit posts and threads by UTC date range.", "version": "0.1", "x-build-id": "KLfHoPVxVv8G2w39e" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/danthedataman~reddit-posts-threads-by-date-range/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-danthedataman-reddit-posts-threads-by-date-range", "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/danthedataman~reddit-posts-threads-by-date-range/runs": { "post": { "operationId": "runs-sync-danthedataman-reddit-posts-threads-by-date-range", "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/danthedataman~reddit-posts-threads-by-date-range/run-sync": { "post": { "operationId": "run-sync-danthedataman-reddit-posts-threads-by-date-range", "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": { "subreddits": { "title": "Subreddits", "type": "array", "description": "Public subreddit names, with optional r/ prefix. Personal-disclosure communities listed in the README are refused.", "items": { "type": "string" } }, "startDate": { "title": "Start date (UTC)", "type": "string", "description": "Inclusive UTC date or ISO instant." }, "endDate": { "title": "End date (UTC)", "type": "string", "description": "Inclusive UTC date or ISO instant. A date includes the entire UTC day." }, "mode": { "title": "Mode", "enum": [ "posts", "threads" ], "type": "string", "description": "Live posts, or one post bundle including its live comment tree and coverage.", "default": "posts" }, "includeRemoved": { "title": "Include removed or deleted posts", "type": "boolean", "description": "Include the live removal label. Archived text is never returned.", "default": false }, "maxPosts": { "title": "Maximum posts", "minimum": 0, "type": "integer", "description": "When Reddit blocks direct reads, caps delivered posts; otherwise caps candidate IDs. API omission uses 20; the form example uses 1. Blocked historical reads stop at maxBrowserReads. Filtered candidates use reads and the next available frozen candidate may be attempted within that bound and the deadline. Unreadable reads are not replaced. Archive and replay candidates are oldest first; listings arrive page by page. Frozen candidate pools may exceed the row cap. Zero collects nothing." }, "maxCommentsPerPost": { "title": "Maximum comments per post", "minimum": 0, "maximum": 5000, "type": "integer", "description": "Choose mode threads and raise this cap to include comments (up to 5,000 per post). The form example uses 0; API omission uses 500. Browser threads contain only the page snapshot, with gaps disclosed. Each delivered comment is one comment event; your maximum cost per run caps comments before fetching." }, "maxBrowserReads": { "title": "Maximum historical or comment browser reads", "minimum": 0, "maximum": 10, "type": "integer", "description": "At most 10 page reads shared by historical posts and comment threads. A historical page supplies its post and available comments together. Zero disables these reads. Listing pages have a separate run bound of 10. SUMMARY reports used and remaining allocations and covered range.", "default": 10 }, "replayFrozenSetDatasetId": { "title": "Replay frozen ID dataset", "type": "string", "description": "Read a previous frozen set without discovery. Optional supplied subreddit/date bounds must match its header." }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify residential by default. Optionally supply your own proxy configuration." } } }, "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 } } } } } } } } } }