{ "openapi": "3.0.1", "info": { "title": "Reddit Scraper", "description": "Scrape Reddit posts from any subreddit or search query: titles, scores, comment counts, authors, flair, timestamps, outbound links and NSFW/spoiler/OC flags. No login, no browser.", "version": "0.1", "x-build-id": "6gIgvb3KePZmNnvLt" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/muhammad4hmed~reddit-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-muhammad4hmed-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/muhammad4hmed~reddit-scraper/runs": { "post": { "operationId": "runs-sync-muhammad4hmed-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/muhammad4hmed~reddit-scraper/run-sync": { "post": { "operationId": "run-sync-muhammad4hmed-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": "Subreddits to scrape, as \"technology\", \"r/technology\" or a subreddit URL. Multireddits such as \"technology+science\" work too. If you also fill in search queries, each query is searched inside these subreddits instead of the feed being listed.", "items": { "type": "string" } }, "searchQueries": { "title": "Search queries", "type": "array", "description": "Optional Reddit search queries. With subreddits filled in, every query is searched inside every subreddit; on their own, queries search all of Reddit. Reddit search operators work, e.g. \"nsfw:yes\" or \"flair:Discussion\".", "items": { "type": "string" } }, "sort": { "title": "Sort by", "enum": [ "hot", "new", "top", "rising", "controversial" ], "type": "string", "description": "Order posts the way Reddit does. Searches have no rising or controversial order — if you pick one of those, searches fall back to relevance while subreddit listings still use it. Rising is also a short feed: Reddit publishes only about 25 rising posts per subreddit and offers no further pages, so Max posts per source cannot be reached with it.", "default": "hot" }, "timeRange": { "title": "Time range", "enum": [ "hour", "day", "week", "month", "year", "all" ], "type": "string", "description": "Time window for the ranking. Reddit applies this to Top and Controversial listings and to every search; it silently ignores it on Hot, New and Rising feeds.", "default": "day" }, "maxPostsPerSource": { "title": "Max posts per source", "minimum": 1, "maximum": 1000, "type": "integer", "description": "How many posts to collect from each subreddit or query. Reddit hard-stops a subreddit feed at 1000 posts and a search at roughly 250, so higher values simply finish early.", "default": 100 }, "includeNsfw": { "title": "Include NSFW posts", "type": "boolean", "description": "Reddit hides over-18 posts from logged-out visitors. Turn this on to send the adult-content signal (an over18 cookie on feeds, include_over_18 on searches) so NSFW posts are returned. Fully 18+ subreddits still cannot be listed as a feed — search them instead.", "default": false }, "skipPromoted": { "title": "Skip promoted and pinned posts", "type": "boolean", "description": "Drop sponsored posts and the moderator announcements pinned to the top of a subreddit. In practice only the pinned half fires: logged-out old.reddit no longer serves promoted links, so the isPromoted column is false on every row we have ever seen.", "default": true }, "fetchPostDetails": { "title": "Fetch upvote ratio and self-post text", "type": "boolean", "description": "Reddit does not publish the upvote ratio or the body of a text post in its listings. Turn this on to open each post's own page and fill in upvoteRatio and selfText. It costs one extra request per post, so runs take much longer and are billed per hydrated post.", "default": false }, "maxItems": { "title": "Max items (whole run)", "minimum": 0, "type": "integer", "description": "Hard cap on total posts across all subreddits and queries. 0 means no cap.", "default": 0 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Reddit blocks Apify's datacenter IPs and answers roughly half of all residential addresses with a login page, so residential proxy plus session rotation is required. Leave this as it is unless you know what you are changing.", "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 } } }, "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 } } } } } } } } } }