{ "openapi": "3.0.1", "info": { "title": "Reddit Fast Scraper (posts, comments, search)", "description": "Find public Reddit posts in subreddits and searches. Set a result limit and include comments if needed. Ready to try a subreddit?", "version": "0.1", "x-build-id": "dDh7Zno78s7LKLMmq" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/danielmichalek~reddit-fast/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-danielmichalek-reddit-fast", "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/danielmichalek~reddit-fast/runs": { "post": { "operationId": "runs-sync-danielmichalek-reddit-fast", "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/danielmichalek~reddit-fast/run-sync": { "post": { "operationId": "run-sync-danielmichalek-reddit-fast", "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": "Subreddit names with or without the r/ prefix, e.g. webscraping or r/datascience. Without search terms, the posts of each subreddit are listed with the selected sort. With search terms, every term is searched inside every subreddit.", "items": { "type": "string" } }, "searches": { "title": "Search terms", "type": "array", "description": "Keywords or phrases to search Reddit posts for (put a phrase in quotes for an exact match). Combined with Subreddits, the search is limited to those subreddits.", "items": { "type": "string" } }, "startUrls": { "title": "Reddit URLs", "type": "array", "description": "Subreddit URLs (https://www.reddit.com/r/webscraping/top/?t=week), post URLs (.../comments//..., redd.it or /s/ share links), user URLs (https://www.reddit.com/user//) or search URLs (https://www.reddit.com/search/?q=apify&sort=new). Sort and time given in a URL take precedence over the fields below.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "sort": { "title": "Sort", "enum": [ "hot", "new", "top", "rising", "relevance", "comments" ], "type": "string", "description": "Order of posts. Subreddits support Hot, New, Top and Rising; searches support Relevance, Hot, Top, New and Most comments; users support Hot, New and Top. An unsupported choice falls back to Hot (subreddits), Relevance (searches) or New (users).", "default": "hot" }, "time": { "title": "Time range", "enum": [ "hour", "day", "week", "month", "year", "all" ], "type": "string", "description": "Time window used by Top and by searches (Reddit ignores it for Hot, New and Rising listings).", "default": "all" }, "maxItems": { "title": "Max results", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Hard cap on dataset items per run, posts and comments together. Every item is one billable result, so this also caps the cost. The cap is shared fairly between all subreddits, searches and URLs.", "default": 50 }, "includeComments": { "title": "Include comments", "type": "boolean", "description": "Also store the comments of every post as separate items (type \"comment\") in thread order, with depth, parent id and post id. Costs one extra request per post that has comments.", "default": false }, "maxComments": { "title": "Max comments per post", "minimum": 0, "maximum": 500, "type": "integer", "description": "Upper limit of comments stored per post (0 to 500). Comments hidden behind \"load more\" links are not expanded.", "default": 50 }, "skipNsfw": { "title": "Skip NSFW posts", "type": "boolean", "description": "Leave out posts marked over 18 (NSFW). Turn off to include them.", "default": true }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional and off by default. Only needed when Reddit answers with HTTP 429 or 403 for the server's IP address (very large jobs or blocked IP ranges); requests then go through the selected Apify Proxy group or your own proxy URLs.", "default": { "useApifyProxy": false } } } }, "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 } } } } } } } } } }