{ "openapi": "3.0.1", "info": { "title": "Reddit Trends Scraper & Top Comments", "description": "Scrape Reddit trends and top comments to discover trending topics, posts, discussions, engagement, scores, subreddits, and user insights. Analyze community interests, track emerging conversations, research audiences, identify content opportunities, and monitor competitors for marketing and SEO.", "version": "0.1", "x-build-id": "1kX3gmefxeQXlApVX" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapier~reddit-trends-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapier-reddit-trends-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/scrapier~reddit-trends-scraper/runs": { "post": { "operationId": "runs-sync-scrapier-reddit-trends-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/scrapier~reddit-trends-scraper/run-sync": { "post": { "operationId": "run-sync-scrapier-reddit-trends-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", "required": [ "startUrls" ], "properties": { "startUrls": { "title": "🔎 Reddit URLs, Subreddits, Users, or Keywords", "type": "array", "description": "Add Reddit listing URLs (e.g. https://www.reddit.com/r/popular/), subreddits (r/popular), usernames (u/spez), or keywords to search. Each source is expanded into posts; each post is then scraped for comments.", "items": { "type": "string" } }, "sortBy": { "title": "↕️ Post Sort Order", "enum": [ "hot", "new", "top", "rising", "controversial" ], "type": "string", "description": "Server-side sort for the post listing. Example: sortBy=top surfaces the highest-scoring posts. Default is hot.", "default": "hot" }, "maxPosts": { "title": "📦 Maximum Posts (parents)", "minimum": 1, "type": "integer", "description": "Maximum number of parent POSTS per source. Comments do NOT count toward this limit — they are capped separately by Maximum Comments per Post. Example: maxPosts=10 + maxCommentsPerPost=20 → up to 10 posts and up to 200 comment rows. Default is 10.", "default": 10 }, "includeComments": { "title": "💬 Include Comments", "type": "boolean", "description": "When enabled, each post's comment tree is fetched and emitted as child rows (type=comment, isChild=true) interleaved after the parent post. Default is true.", "default": true }, "maxCommentsPerPost": { "title": "🔢 Maximum Comments per Post", "minimum": 0, "type": "integer", "description": "Cap on comment rows collected per post (top-level + nested replies combined). Set 0 for unlimited. Example: maxCommentsPerPost=20 keeps the first 20 comments of each post. Default is 10.", "default": 10 }, "commentSort": { "title": "🧮 Comment Sort", "enum": [ "confidence", "top", "new", "controversial", "old", "qa" ], "type": "string", "description": "How Reddit orders comments before they are collected. 'confidence' = Reddit's Best. Default is confidence.", "default": "confidence" }, "maxCommentDepth": { "title": "🌳 Maximum Comment Depth", "minimum": 0, "type": "integer", "description": "How deep to expand nested reply threads. 0 = top-level comments only, 1 = replies to top-level, etc. Higher values traverse deeper threads. Default is 3.", "default": 3 }, "expandMoreComments": { "title": "➕ Expand Collapsed Threads", "type": "boolean", "description": "Request Reddit to inline more collapsed reply branches (higher fetch limit) so deeper threads are recovered, up to the depth and per-post caps. Default is true.", "default": true }, "proxyConfiguration": { "title": "🌐 Proxy Configuration", "type": "object", "description": "Proxy used for requests. Post listing and comment pages are fetched from old.reddit.com via Apify residential proxy (datacenter fallback, fresh-IP retries)." } } }, "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 } } } } } } } } } }