{ "openapi": "3.0.1", "info": { "title": "Best Reddit Scrpaer", "description": "A powerful Apify Actor designed to extract comprehensive data from Reddit. This scraper can fetch subreddit feeds, collect posts with full comment trees, run keyword searches, and extract user profiles, making it perfect for social listening and market research.", "version": "0.0", "x-build-id": "fioTAIHUKfbJvOFPL" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scoutlayer~reddit-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scoutlayer-reddit-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/scoutlayer~reddit-scraper/runs": { "post": { "operationId": "runs-sync-scoutlayer-reddit-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/scoutlayer~reddit-scraper/run-sync": { "post": { "operationId": "run-sync-scoutlayer-reddit-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": [ "scrapeType" ], "properties": { "scrapeType": { "title": "Scrape Type", "enum": [ "subreddit", "post", "comments", "search", "user" ], "type": "string", "description": "Select what type of data to fetch from Reddit.", "default": "subreddit" }, "maxPages": { "title": "Max Pages (Global Default)", "minimum": 1, "type": "integer", "description": "Global fallback for max pages across paginated types (Subreddit Feed, Search) when no type-specific limit is set.", "default": 3 }, "subreddits": { "title": "Subreddits", "type": "array", "description": "Subreddit names or full URLs (e.g. \"programming\" or \"https://reddit.com/r/programming\"). Required for Scrape Type: Subreddit Feed.", "items": { "type": "string" } }, "subredditSort": { "title": "Subreddit Sort Order", "enum": [ "hot", "new", "top", "rising" ], "type": "string", "description": "Sort order for Subreddit Feed.", "default": "hot" }, "maxSubredditPages": { "title": "Max Subreddit Pages", "minimum": 1, "type": "integer", "description": "Maximum number of pages to fetch per subreddit. Falls back to \"Max Pages (Global Default)\" if not set." }, "postIds": { "title": "Post IDs", "type": "array", "description": "Reddit post IDs or full permalink URLs (e.g. \"abc123\" or \"https://reddit.com/r/programming/comments/abc123/title\"). Required for Scrape Type: Post.", "items": { "type": "string" } }, "commentPostIds": { "title": "Post IDs (with Comments)", "type": "array", "description": "Reddit post IDs or full permalink URLs to fetch with their full comment tree. Required for Scrape Type: Post + Comments.", "items": { "type": "string" } }, "searchQueries": { "title": "Search Queries", "type": "array", "description": "Search queries to run, e.g. \"typescript\". Required for Scrape Type: Search.", "items": { "type": "string" } }, "searchSubreddit": { "title": "Search Subreddit (optional)", "type": "string", "description": "Scope Search to a single subreddit instead of all of Reddit." }, "searchSort": { "title": "Search Sort Order", "enum": [ "relevance", "new", "top", "comments" ], "type": "string", "description": "Sort order for Search.", "default": "relevance" }, "maxSearchPages": { "title": "Max Search Pages", "minimum": 1, "type": "integer", "description": "Maximum number of result pages to fetch per query. Falls back to \"Max Pages (Global Default)\" if not set." }, "usernames": { "title": "Usernames", "type": "array", "description": "Reddit usernames or full profile URLs (e.g. \"spez\" or \"https://reddit.com/u/spez\"). Required for Scrape Type: User Profile.", "items": { "type": "string" } } } }, "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 } } } } } } } } } }