{ "openapi": "3.0.1", "info": { "title": "Reddit Historical Archive Scraper for Posts and Comments", "description": "Collect public Reddit posts and comments from historical date ranges. Search by subreddit, author, post ID, or Reddit URL, then filter by type, phrase, score, and order. Get text, links, dates, engagement, and archive details when available.", "version": "0.0", "x-build-id": "3had6f1HacqUD3rx3" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/maximedupre~reddit-historical-archive-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-maximedupre-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/maximedupre~reddit-historical-archive-scraper/runs": { "post": { "operationId": "runs-sync-maximedupre-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/maximedupre~reddit-historical-archive-scraper/run-sync": { "post": { "operationId": "run-sync-maximedupre-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": [ "resultType", "discoveryMethod" ], "properties": { "resultType": { "title": "Result type", "enum": [ "posts", "comments", "both" ], "type": "string", "description": "Choose whether to return posts, comments, or both." }, "discoveryMethod": { "title": "Find archived content by", "enum": [ "subreddit", "author", "post", "url" ], "type": "string", "description": "Choose the kind of public Reddit target to search." }, "subredditNames": { "title": "Subreddit names", "type": "array", "description": "Enter one or more subreddit names without the r/ prefix. The Actor searches the selected historical date range in each subreddit.", "items": { "type": "string", "minLength": 1 } }, "authorNames": { "title": "Author usernames", "type": "array", "description": "Enter one or more Reddit usernames without the u/ prefix. The Actor searches posts, comments, or both for each author.", "items": { "type": "string", "minLength": 1 } }, "postIds": { "title": "Post IDs", "type": "array", "description": "Enter one or more Reddit post IDs. The Actor retrieves matching archived posts or their comments in the selected date range.", "items": { "type": "string", "minLength": 1 } }, "redditUrls": { "title": "Reddit URLs", "type": "array", "description": "Enter one or more public Reddit URLs for archived targets. Use a full URL that starts with https://.", "items": { "type": "object", "properties": { "url": { "title": "Reddit URL", "type": "string", "description": "A public Reddit URL to search in the archive.", "pattern": "^https://.+", "minLength": 1 } }, "required": [ "url" ] } }, "startDate": { "title": "Start date", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "Optional lower creation-date bound. Records created before this UTC date are skipped. Use YYYY-MM-DD." }, "endDate": { "title": "End date", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "Optional upper creation-date bound. Records created after this UTC date are skipped. Use YYYY-MM-DD." }, "searchPhrase": { "title": "Search phrase", "type": "string", "description": "Optional phrase to find in post titles and body text, or in comment bodies. With Posts and comments, the phrase is checked in both record types." }, "minScore": { "title": "Minimum score", "type": "integer", "description": "Optional minimum engagement score. Records with a lower score are skipped." }, "sortOrder": { "title": "Result order", "enum": [ "newest", "oldest" ], "type": "string", "description": "Choose whether older or newer records appear first.", "default": "newest" }, "maxCommentsPerPost": { "title": "Maximum comments per post", "minimum": 1, "type": "integer", "description": "Optional comment limit for post ID or Reddit URL targets when the selected Result type includes comments. Leave empty to return all available comments until the source is exhausted." }, "maxItems": { "title": "Maximum results", "minimum": 1, "type": "integer", "description": "Optional limit for returned posts or comments in this run. Leave empty to return all available records until the source is exhausted." } } }, "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 } } } } } } } } } }