{ "openapi": "3.0.1", "info": { "title": "Reddit Scraper Lite - $0.5/1k results", "description": "Pay Per Result, unlimited Reddit web scraper to crawl posts, comments, communities, subreddits, and users without login. Limit web scraping by number of posts or items and extract all data in a dataset in multiple formats.", "version": "0.0", "x-build-id": "e5xUNuBH1c5R75jh9" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/microworlds~reddit-scraper-lite/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-microworlds-reddit-scraper-lite", "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/microworlds~reddit-scraper-lite/runs": { "post": { "operationId": "runs-sync-microworlds-reddit-scraper-lite", "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/microworlds~reddit-scraper-lite/run-sync": { "post": { "operationId": "run-sync-microworlds-reddit-scraper-lite", "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": { "queries": { "title": "Search keywords", "type": "array", "description": "Keywords or phrases to search across all of Reddit, e.g. \"Cheesecake\" or \"Swimming Pool\". Duplicates are ignored.", "items": { "type": "string" } }, "subreddits": { "title": "Subreddits", "type": "array", "description": "Subreddit names or URLs, e.g. \"saas\", \"r/saas\" or \"https://www.reddit.com/r/saas/\". Returns the community info plus its posts.", "items": { "type": "string" } }, "users": { "title": "Users", "type": "array", "description": "Usernames or profile URLs, e.g. \"spez\", \"u/spez\" or \"https://www.reddit.com/user/spez/\". Returns the user profile plus their posts.", "items": { "type": "string" } }, "sort_by": { "title": "Search sort", "enum": [ "relevance", "hot", "top", "new", "comments" ], "type": "string", "description": "Order of search results (keywords only).", "default": "relevance" }, "listing_sort": { "title": "Subreddit / user posts sort", "enum": [ "hot", "new", "top", "controversial" ], "type": "string", "description": "Order of posts from subreddits and users.", "default": "new" }, "time_frame": { "title": "Time range", "enum": [ "all", "year", "month", "week", "day", "hour" ], "type": "string", "description": "Only return posts created within this time range. Applies to search, and to the Top/Controversial sorts of subreddits and users.", "default": "all" }, "max_posts": { "title": "Max posts per keyword / subreddit / user", "minimum": 1, "type": "integer", "description": "Maximum number of posts collected for each keyword, subreddit and user. Reddit itself stops listings at roughly 1000 posts. Leave empty for no limit.", "default": 100 }, "include_nsfw": { "title": "Include NSFW posts", "type": "boolean", "description": "Also collect posts marked 18+.", "default": false }, "scrape_comments": { "title": "Include comments from each post", "type": "boolean", "description": "Also scrape the comment tree of every post found. Each comment is a separate result.", "default": false }, "max_comments_per_post": { "title": "Max comments per post", "minimum": 0, "type": "integer", "description": "Maximum number of comments collected per post. Only used when comments are enabled. Leave empty for no limit.", "default": 1000 }, "max_comment_depth": { "title": "Max comment depth", "minimum": 0, "type": "integer", "description": "Maximum nesting depth of replies to collect. 0 collects top-level comments only, 1 adds their direct replies, and so on. Only used when comments are enabled. Leave empty for the full thread depth.", "default": 10 }, "comment_sort": { "title": "Comment sort", "enum": [ "top", "new", "controversial", "old", "qa" ], "type": "string", "description": "Ordering of comments on the post page. Determines which comments are collected first when a limit is set.", "default": "top" } } }, "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 } } } } } } } } } }