{ "openapi": "3.0.1", "info": { "title": "Reddit Trends Scraper", "description": "Scrape trending Reddit posts from public subreddit feeds with authors, links, timestamps, flair, NSFW flags, trendScore and available score/comment data. Perfect for SEO and AI agents, MCP optimized.", "version": "1.1", "x-build-id": "CTFvdsBQN7cyjxZvE" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/khadinakbar~reddit-trends-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-khadinakbar-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/khadinakbar~reddit-trends-scraper/runs": { "post": { "operationId": "runs-sync-khadinakbar-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/khadinakbar~reddit-trends-scraper/run-sync": { "post": { "operationId": "run-sync-khadinakbar-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", "properties": { "subreddits": { "title": "Subreddits", "type": "array", "description": "Use this when monitoring specific Reddit communities. Enter names without r/, for example artificial, technology, or Futurology. Defaults to artificial, technology, and Futurology. This is not a full Reddit URL list.", "default": [ "artificial", "technology", "Futurology" ], "items": { "type": "string" } }, "sort": { "title": "Subreddit sort", "enum": [ "hot", "rising", "top", "new", "controversial" ], "type": "string", "description": "Use this when selecting subreddit listing order. Accepted values are hot, rising, top, new, or controversial. Defaults to hot and supports timeRange for top and controversial.", "default": "hot" }, "timeRange": { "title": "Time range", "enum": [ "hour", "day", "week", "month", "year", "all" ], "type": "string", "description": "Use this when top or controversial feeds need a time window. Accepted values are hour, day, week, month, year, or all. Defaults to week for trend discovery. This is not a date range picker.", "default": "week" }, "maxResults": { "title": "Maximum posts", "minimum": 1, "maximum": 500, "type": "integer", "description": "Use this when capping the number of Reddit posts returned and charged. Accepted range is 1 to 500. Defaults to 50. This is not the number of pages; use maxPagesPerSource for pagination.", "default": 50 }, "maxPagesPerSource": { "title": "Pages per source", "minimum": 1, "maximum": 10, "type": "integer", "description": "Use this when each subreddit should paginate deeper. Accepted range is 1 to 10 pages per source. Defaults to 2 for fast quality-test runs. This is not a result limit.", "default": 2 }, "includeNsfw": { "title": "Include NSFW posts", "type": "boolean", "description": "Use this when NSFW Reddit posts should be included in the dataset. Defaults to false, so NSFW records are skipped. Set true only when your workflow can handle adult or sensitive content. This does not bypass private or quarantined communities.", "default": false }, "minScore": { "title": "Minimum score", "minimum": 0, "type": "integer", "description": "Use this when low-score posts should be filtered out. Enter a non-negative Reddit score such as 25 or 100. Defaults to 0. This is not a trendScore threshold.", "default": 0 }, "responseFormat": { "title": "Response format", "enum": [ "concise", "detailed" ], "type": "string", "description": "Use this when choosing dataset detail level for humans or agents. concise returns stable trend fields under a small token budget, while detailed adds raw fullname and textPreview when available. Defaults to concise. This is not a file format selector.", "default": "concise" }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Use this when Reddit blocks direct requests from the actor. Apify Residential proxy is the safest fallback, for example useApifyProxy true with RESIDENTIAL group. Defaults to Apify Residential proxy for cloud reliability. This is not a login or cookie setting.", "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 } } } } } } } } } }