{ "openapi": "3.0.1", "info": { "title": "Reddit Scraper: Subreddit Posts, Comments, Search - No Login", "description": "Extract Reddit posts, comments and search results at scale. Up to 1,000 posts per subreddit across hot/new/top/rising, full comment threads, and keyword search. Flat JSON, 33 always-present fields, agent-ready. No login or credentials. SFW only. No start fee, $0.60 per 1,000 posts.", "version": "0.0", "x-build-id": "a4J4sKy6Qf3bO20Yr" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/santhej~reddit-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-santhej-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/santhej~reddit-scraper/runs": { "post": { "operationId": "runs-sync-santhej-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/santhej~reddit-scraper/run-sync": { "post": { "operationId": "run-sync-santhej-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": "Communities", "type": "array", "description": "Communities to harvest, one per line. Accepts 'programming', 'r/programming', '/r/programming' or a full reddit.com URL — all are normalised to the bare name. Supply this, a search keyword, or both. Adult and quarantined communities are refused.", "items": { "type": "string" } }, "searchQuery": { "title": "Search keyword (optional)", "type": "string", "description": "Keyword search. On its own it runs site-wide and returns posts from any community. If communities are also supplied, the search runs once PER community — and the plain listing for each community still runs as well, so communities + a keyword is twice as many sources, and twice as many billable rows, as either on its own. Every row records which it came from in `sourceType` (`subreddit` or `search`) and `sourceQuery`. A single keyword returns roughly 240 results at most — split broad topics into several keywords." }, "sort": { "title": "Sort", "enum": [ "hot", "new", "top", "rising", "controversial", "best" ], "type": "string", "description": "Listing order. 'best' is served as 'hot' and the row field sortUsed echoes what actually ran. For a keyword search these map to relevance / top / new / most comments.", "default": "hot" }, "timeRange": { "title": "Time range", "enum": [ "hour", "day", "week", "month", "year", "all" ], "type": "string", "description": "Only meaningful for Top, Controversial and keyword search. It widens the history window but does not raise the 1,000-post ceiling — the windows are nested subsets of each other.", "default": "all" }, "maxPostsPerSource": { "title": "Max posts per source", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Posts to return per SOURCE, not per run. A source is one community listing, or one keyword search within one community, or one site-wide search — so 2 communities plus a keyword is 4 sources and returns up to 4× this number. 1,000 is the hard ceiling per source — a community listing stops delivering beyond that no matter what is requested.", "default": 100 }, "includeComments": { "title": "Include comment threads", "type": "boolean", "description": "Fetch the comment thread of every harvested post and append the comments to the same dataset as rows with type = 'comment'. Off by default so a plain listing run stays cheap.", "default": false }, "maxCommentsPerPost": { "title": "Max comments per post", "minimum": 1, "maximum": 500, "type": "integer", "description": "Upper bound per post, not a guarantee — 500 is the hard ceiling and a request for 50 typically returns slightly fewer on deep threads. Ignored when comment threads are switched off.", "default": 50 }, "minCommentsToFetch": { "title": "Minimum comments before fetching a thread", "minimum": 0, "maximum": 500, "type": "integer", "description": "Skip the thread request entirely for posts whose declared comment count is below this number. At the default of 1, posts with zero comments cost nothing. This is the direct lever on the per-thread charge.", "default": 1 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Advanced. Residential US is the shipped default and is what the published reliability figures are based on.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } } } }, "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 } } } } } } } } } }