{ "openapi": "3.0.1", "info": { "title": "Reddit Historical Archive Scraper", "description": "🗄️ Export old Reddit posts and comments by subreddit, author, keyword, score, and date range from a public archive — no login or API key.", "version": "0.1", "x-build-id": "EhNRC0SKWrwQV81uU" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/automation-lab~reddit-historical-archive-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-automation-lab-reddit-historical-archive-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/automation-lab~reddit-historical-archive-scraper/runs": { "post": { "operationId": "runs-sync-automation-lab-reddit-historical-archive-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/automation-lab~reddit-historical-archive-scraper/run-sync": { "post": { "operationId": "run-sync-automation-lab-reddit-historical-archive-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": [ "after", "before" ], "properties": { "recordTypes": { "title": "Record types", "minItems": 1, "uniqueItems": true, "type": "array", "description": "Select historical Reddit entity types. Posts go to the default dataset and comments to the Comments dataset.", "items": { "type": "string", "enum": [ "posts", "comments" ], "enumTitles": [ "Posts", "Comments" ] }, "default": [ "posts", "comments" ] }, "subreddits": { "title": "Subreddits", "maxItems": 10, "type": "array", "description": "Enter subreddit names without r/, for example python. At least one subreddit or author is required.", "items": { "type": "string" } }, "authors": { "title": "Authors", "maxItems": 10, "type": "array", "description": "Optionally enter Reddit usernames without u/. When subreddits are also set, both constraints apply.", "default": [], "items": { "type": "string" } }, "keyword": { "title": "Keyword or phrase", "type": "string", "description": "Optionally search post titles/selftext or comment bodies inside the selected subreddit or author scope. The Actor requests server-side filtering, falls back safely after repeated archive timeouts, and validates every match before saving.", "default": "" }, "after": { "title": "After date (inclusive)", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "Return records created on or after this UTC date in YYYY-MM-DD format.", "default": "2024-01-01" }, "before": { "title": "Before date (exclusive)", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "Return records created before this UTC date in YYYY-MM-DD format. It must be later than After date.", "default": "2024-01-02" }, "minScore": { "title": "Minimum score", "type": "integer", "description": "Only save records whose numeric Reddit score is at least this value.", "default": 0 }, "sort": { "title": "Chronological order", "enum": [ "asc", "desc" ], "type": "string", "description": "Sort archive records from oldest to newest or newest to oldest.", "default": "asc" }, "maxItems": { "title": "Maximum archive records", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Stop after this many posts and comments combined. Duplicate archive IDs do not count.", "default": 20 }, "batchSize": { "title": "Archive page size", "minimum": 1, "maximum": 100, "type": "integer", "description": "Records requested per Arctic Shift API page. Lower values reduce retry work during upstream instability.", "default": 100 }, "maxPages": { "title": "Maximum archive pages", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Safety limit across all scopes. Keyword search is sent to the archive, while score filtering and match validation happen locally, so sparse searches may still inspect more rows than they save.", "default": 100 } } }, "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 } } } } } } } } } }