{
"openapi": "3.0.1",
"info": {
"title": "Reddit Scraper — Posts, Comments, Search & Users (Reliable)",
"description": "Scrape Reddit posts, comment trees, search results, and user activity as clean JSON — engineered for reliability: rate-limit-aware pacing, host + proxy rotation, and per-target fault isolation. HTTP-only, no browser, no login.",
"version": "0.1",
"x-build-id": "FWDVOqeRStHxZtud8"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/blubberstick~reddit-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-blubberstick-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/blubberstick~reddit-scraper/runs": {
"post": {
"operationId": "runs-sync-blubberstick-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/blubberstick~reddit-scraper/run-sync": {
"post": {
"operationId": "run-sync-blubberstick-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": {
"startUrls": {
"title": "Start URLs",
"type": "array",
"description": "Any Reddit URLs — subreddit pages, individual posts, user profiles, or search-result pages. The type of each URL is detected automatically. Examples: https://www.reddit.com/r/programming/top/?t=week, https://www.reddit.com/r/AskReddit/comments/abc123/some_post/, https://www.reddit.com/user/spez/, https://www.reddit.com/search/?q=apify.",
"items": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"title": "URL of a web page",
"format": "uri"
}
}
}
},
"subreddits": {
"title": "Subreddits",
"uniqueItems": true,
"type": "array",
"description": "Subreddit names to scrape posts from, with or without the r/ prefix — e.g. programming or r/programming.",
"items": {
"type": "string"
}
},
"sort": {
"title": "Sort posts by",
"enum": [
"hot",
"new",
"top",
"rising"
],
"type": "string",
"description": "Which subreddit listing to scrape — same tabs you see on Reddit. new is best for monitoring, top for the most popular posts in a period.",
"default": "new"
},
"topPeriod": {
"title": "Top period",
"enum": [
"hour",
"day",
"week",
"month",
"year",
"all"
],
"type": "string",
"description": "Time window for the top sort (ignored for other sorts).",
"default": "week"
},
"searchQueries": {
"title": "Search queries",
"uniqueItems": true,
"type": "array",
"description": "Keywords or phrases to search Reddit for — e.g. your brand name, a product, a topic. Each query returns matching posts. Great for social listening and brand monitoring.",
"items": {
"type": "string"
}
},
"searchSort": {
"title": "Search sort",
"enum": [
"relevance",
"hot",
"top",
"new",
"comments"
],
"type": "string",
"description": "How to rank search results.",
"default": "relevance"
},
"searchSubreddit": {
"title": "Restrict search to subreddit",
"type": "string",
"description": "Optional: limit all search queries to a single subreddit, e.g. smallbusiness. Leave empty to search all of Reddit.",
"default": ""
},
"users": {
"title": "Users",
"uniqueItems": true,
"type": "array",
"description": "Reddit usernames to scrape, with or without the u/ prefix — e.g. spez.",
"items": {
"type": "string"
}
},
"userDataType": {
"title": "User data to fetch",
"enum": [
"posts",
"comments",
"both"
],
"type": "string",
"description": "Whether to scrape each user's submitted posts, their comments, or both.",
"default": "posts"
},
"includeComments": {
"title": "Include comments",
"type": "boolean",
"description": "For every scraped post, also fetch and flatten its comment tree (one dataset item per comment, with postId, parentId, and depth for re-assembly). Adds one extra request per post.",
"default": false
},
"maxItems": {
"title": "Max items",
"minimum": 1,
"type": "integer",
"description": "Maximum number of posts / user items scraped across all sources combined — the budget is split fairly across your subreddits, queries, users, and URLs. Comments fetched via Include comments are controlled separately by Max comments per post.",
"default": 100
},
"maxCommentsPerPost": {
"title": "Max comments per post",
"minimum": 1,
"type": "integer",
"description": "Cap on comments scraped per post when Include comments is on. Deeply nested \"load more comments\" stubs are skipped and their count is reported on the post item as moreCommentsSkipped.",
"default": 50
},
"proxyConfiguration": {
"title": "Proxy configuration",
"type": "object",
"description": "Proxies to use. Residential proxies (default) are strongly recommended — Reddit aggressively blocks datacenter IP ranges. The actor automatically rotates to a fresh proxy session whenever Reddit rate-limits or blocks a request.",
"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
}
}
}
}
}
}
}
}
}
}