{ "openapi": "3.0.1", "info": { "title": "Reddit Scraper: Posts, Comments, Search & Monitoring", "description": "Get Reddit posts and full comment threads from subreddits, searches, user profiles and post links: titles, text, scores, flair, media and replies. New-post monitoring built in. No login.", "version": "0.1", "x-build-id": "GMdYVLBUMeB28QxwM" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/stratumics~reddit-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-stratumics-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/stratumics~reddit-scraper/runs": { "post": { "operationId": "runs-sync-stratumics-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/stratumics~reddit-scraper/run-sync": { "post": { "operationId": "run-sync-stratumics-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": "Subreddit names (technology, r/technology) or links (https://www.reddit.com/r/technology/top/?t=week). A link keeps its own sort and time window.", "items": { "type": "string" } }, "sort": { "title": "Subreddit sort", "enum": [ "hot", "new", "top", "rising", "controversial" ], "type": "string", "description": "Order of subreddit posts. New lists the newest first.", "default": "new" }, "timeWindow": { "title": "Time window for Top and Controversial", "enum": [ "hour", "day", "week", "month", "year", "all" ], "type": "string", "description": "Period Top and Controversial rank posts over. Other sorts ignore it.", "default": "day" }, "searchQueries": { "title": "Search queries", "type": "array", "description": "Words to search Reddit posts for, as you would type them in Reddit's search box.", "default": [], "items": { "type": "string" } }, "searchSubreddits": { "title": "Search only in these subreddits", "type": "array", "description": "Optional. Each query runs once in each of these subreddits. Leave empty to search all of Reddit.", "default": [], "items": { "type": "string" } }, "searchSort": { "title": "Search sort", "enum": [ "relevance", "hot", "top", "new", "comments" ], "type": "string", "description": "Order of search results.", "default": "relevance" }, "searchTimeWindow": { "title": "Search time window", "enum": [ "hour", "day", "week", "month", "year", "all" ], "type": "string", "description": "Period searched.", "default": "all" }, "postUrls": { "title": "Post links", "type": "array", "description": "Links to single posts (https://www.reddit.com/r/AskReddit/comments/1x8gese/... or https://redd.it/1x8gese).", "default": [], "items": { "type": "string" } }, "users": { "title": "Users", "type": "array", "description": "Usernames (spez, u/spez) or profile links.", "default": [], "items": { "type": "string" } }, "userContent": { "title": "From users, get", "enum": [ "posts", "comments", "both" ], "type": "string", "description": "Which part of each user's profile to read.", "default": "posts" }, "maxPostsPerSource": { "title": "Max posts per source", "minimum": 0, "maximum": 10000, "type": "integer", "description": "Posts to read from each subreddit, search, user or link (for user comments: comments to read). 0 reads up to 10,000. Reddit ends a listing after about 1,000 posts; see the README for ways around it.", "default": 100 }, "newerThan": { "title": "Only posts newer than", "type": "string", "description": "Optional. A date (2026-10-01) or a span back from now (7 days). Older posts are skipped, and newest-first listings stop there." }, "includeComments": { "title": "Include comments", "type": "boolean", "description": "Also save the comments of each post, as separate rows with their reply level and parent. Each comment is charged as one result.", "default": false }, "maxCommentsPerPost": { "title": "Max comments per post", "minimum": 0, "maximum": 10000, "type": "integer", "description": "Comments to save per post, top-level ones first. 0 saves up to 10,000.", "default": 100 }, "maxCommentDepth": { "title": "Max reply depth", "minimum": 0, "maximum": 50, "type": "integer", "description": "Deepest reply level to save: 0 saves top-level comments only, 1 adds direct replies, and so on.", "default": 10 }, "onlyNewPosts": { "title": "Only new posts", "type": "boolean", "description": "Save only posts earlier runs with the same inputs have not returned (and their comments). The Actor remembers post ids in the key-value store reddit-scraper-monitor in your account. Pair it with a schedule.", "default": false }, "monitorName": { "title": "Monitor name", "type": "string", "description": "Optional. A name for the remembered list, so different schedules keep separate histories even with the same inputs. Leave empty to derive it from the inputs.", "default": "" }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Reddit blocks datacenter and cloud IPs, so the Actor uses Apify residential proxies (US) by default, at no extra charge to you. Change this only to use your own proxies.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } } } } } } } } }