{ "openapi": "3.0.1", "info": { "title": "Reddit Scraper: Subreddit Posts, Comments, Search - No Login", "description": "Extract Reddit posts, comments and search results. Up to 1,000 posts per subreddit across hot/new/top/rising with full post text, comment threads, and keyword search. Flat JSON, 33 always-present keys, agent-ready. No login or credentials. SFW only. No start fee, $1.00 per 1,000 posts.", "version": "0.0", "x-build-id": "dmUqLBypJqnbeE3Te" }, "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 179 results at most — split broad topics into several keywords." }, "sort": { "title": "Sort", "enum": [ "hot", "new", "top", "rising", "controversial", "best" ], "type": "string", "description": "Listing order. Community listings serve 'controversial' as 'top'. A keyword search runs Hot/Best/Rising as relevance, Top as top, New as new and Controversial as most comments — pick Best for on-topic search results, since a Top search ranks every loosely matching post by score. The row field sortUsed echoes what actually ran.", "default": "hot" }, "timeRange": { "title": "Time range", "enum": [ "hour", "day", "week", "month", "year", "all" ], "type": "string", "description": "Only meaningful for Top, Controversial and keyword search. On community listings 'Past hour' is served as 'Past 24 hours'. It widens the history window but does not raise the 1,000-post ceiling.", "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. Each thread returns its first page of comments — typically up to ~25, top-level plus some replies — so values above that return what the thread's first page holds. 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 }, "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 } } } } } } } } } }