{ "openapi": "3.0.1", "info": { "title": "Reddit Trends Scraper By Sort, Time & Score Filter", "description": "Reddit Trends Scraper collects trending posts, topics, and engagement data from Reddit. Extract titles, upvotes, comments, and timestamps to analyze discussions, track viral content, and identify emerging trends across subreddits.", "version": "0.1", "x-build-id": "qNWht73v98trsYK1Q" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scraper-engine~reddit-trends-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scraper-engine-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/scraper-engine~reddit-trends-scraper/runs": { "post": { "operationId": "runs-sync-scraper-engine-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/scraper-engine~reddit-trends-scraper/run-sync": { "post": { "operationId": "run-sync-scraper-engine-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 Targets (subreddits, users, keywords or URLs)", "type": "array", "description": "Add subreddits (e.g. `r/popular`), usernames (e.g. `u/spez` or `spez`), search keywords (e.g. `machine learning`), or full Reddit URLs. Bulk input is supported.", "items": { "type": "string" } }, "maxPosts": { "title": "📦 Max Posts (after filtering)", "minimum": 1, "type": "integer", "description": "Maximum number of posts to return per target, counted AFTER the filters below are applied. The scraper paginates until it has this many surviving posts or the listing is exhausted. Example: maxPosts=25. Default is 10.", "default": 10 }, "sortBy": { "title": "🔀 Sort By", "enum": [ "hot", "new", "top", "rising", "controversial" ], "type": "string", "description": "Server-side listing sort passed to Reddit. `hot`, `new`, `top`, `rising`, or `controversial`. For subreddits this maps to `/r///`; for users to `?sort=`; for keyword search to the search sort (rising falls back to relevance). Default is `hot`.", "default": "hot" }, "timeWindow": { "title": "🕒 Time Window", "enum": [ "hour", "day", "week", "month", "year", "all" ], "type": "string", "description": "Time range for the Top / Controversial sorts and keyword search (Reddit's `t=` param): past hour, day, week, month, year, or all time. Ignored by hot/new/rising. Default is `all`.", "default": "all" }, "minUpvotes": { "title": "👍 Minimum Upvotes", "minimum": 0, "type": "integer", "description": "Keep only posts with at least this many upvotes (score). Posts whose score is hidden by Reddit are dropped when this is above 0. Example: minUpvotes=100. Default is 0 (no threshold).", "default": 0 }, "minComments": { "title": "💬 Minimum Comments", "minimum": 0, "type": "integer", "description": "Keep only posts with at least this many comments. Example: minComments=50. Default is 0 (no threshold).", "default": 0 }, "includeNSFW": { "title": "🔞 Include NSFW", "type": "boolean", "description": "When enabled, NSFW (over_18) posts are kept. When disabled, they are filtered out. Default is true.", "default": true }, "keywords": { "title": "🔍 Include Keywords", "type": "array", "description": "Keep only posts whose title, flair, or self-text contains at least one of these words/phrases (case-insensitive). Leave empty to keep all. Example: [\"ai\", \"gpu\"].", "items": { "type": "string" } }, "excludeKeywords": { "title": "🚫 Exclude Keywords", "type": "array", "description": "Drop posts whose title, flair, or self-text contains any of these words/phrases (case-insensitive). Example: [\"giveaway\", \"nsfw\"].", "items": { "type": "string" } }, "proxyConfiguration": { "title": "🌐 Proxy Configuration", "type": "object", "description": "Proxy used for the Reddit requests. Your selection is honored as-is (no proxy, Apify datacenter, Apify residential, or custom). Residential is recommended if Reddit rate-limits datacenter IPs." } } }, "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 } } } } } } } } } }