{ "openapi": "3.0.1", "info": { "title": "Reddit Scraper", "description": "Scrape Reddit posts and comments without an API key or login: subreddit listings (new, hot, top, rising), searches site-wide or inside one subreddit, and single posts with their comment tree. Score, flair, links, media, dates. Only-new mode for monitoring.", "version": "0.1", "x-build-id": "GWE8Q9edkN1tJ8LO8" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/akatra~reddit-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-akatra-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/akatra~reddit-scraper/runs": { "post": { "operationId": "runs-sync-akatra-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/akatra~reddit-scraper/run-sync": { "post": { "operationId": "run-sync-akatra-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", "properties": { "subreddits": { "title": "Subreddits", "type": "array", "description": "Communities to read, one per line: a name (python), r/python or a link (https://www.reddit.com/r/python/). Join several with a plus sign (python+learnpython) to read them as one feed. Private, quarantined and banned communities cannot be read.", "items": { "type": "string" } }, "sort": { "title": "Sort subreddit posts by", "enum": [ "new", "hot", "top", "rising" ], "type": "string", "description": "Which listing of each subreddit to read.", "default": "new" }, "timeFilter": { "title": "Time range", "enum": [ "hour", "day", "week", "month", "year", "all" ], "type": "string", "description": "Applies to the Top listing and to searches: only posts from this period. Ignored for New, Hot and Rising.", "default": "week" }, "searchQueries": { "title": "Search queries", "type": "array", "description": "Words or phrases to search for, one per line. Each line is a separate search across all of Reddit, or inside one subreddit if you set it below. Searching by username (author:, user:, u/) is not supported.", "items": { "type": "string" } }, "searchInSubreddit": { "title": "Search inside this subreddit", "type": "string", "description": "Optional. A subreddit name or link; the searches above then look only inside it. Leave empty to search all of Reddit." }, "searchSort": { "title": "Sort search results by", "enum": [ "relevance", "hot", "top", "new", "comments" ], "type": "string", "description": "Order of the search results.", "default": "relevance" }, "includeNsfw": { "title": "Include 18+ posts in searches", "type": "boolean", "description": "Reddit leaves 18+ posts out of search results unless asked. Turn this on to include them, and to search inside an 18+ community. Subreddit listings and post links always return 18+ posts as they are, flagged with isNsfw.", "default": false }, "postUrls": { "title": "Post links", "type": "array", "description": "Single posts to read, one link per line (https://www.reddit.com/r/python/comments/abc123/title/ or https://redd.it/abc123). Add comments with the option below.", "items": { "type": "string" } }, "includeComments": { "title": "Include comments", "type": "boolean", "description": "Also save the comments of every post, one record per comment, down to depth 10 (deeper branches are skipped). Needs one or more extra requests per post, so runs take longer. Every comment counts as a result.", "default": false }, "maxCommentsPerPost": { "title": "Max comments per post", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Stop after this many comments for each post. Comments come in thread order: a comment, then its replies, and the limit counts in that order. Deleted and removed comments are skipped.", "default": 50 }, "maxItemsPerQuery": { "title": "Max posts per subreddit or search", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Stop after this many posts for each subreddit and each search query. Reddit ends a listing after about 1000 posts (earlier for Top and searches). Comments are limited separately.", "default": 100 }, "onlyNew": { "title": "Only new items", "type": "boolean", "description": "Remember the posts and comments of previous runs of the same source and return only items not seen before and created since 15 minutes before the previous run started. Made for scheduled runs.", "default": 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 } } } } } } } } } }