{ "openapi": "3.0.1", "info": { "title": "Reddit Search Posts", "description": "Scrape Reddit search results into clean datasets without login. Get post text, author info, subreddit details, engagement metrics, and media URLs for any keyword or topic. Perfect for research, sentiment analysis, and trend tracking.", "version": "1.0", "x-build-id": "ydp7tWWYqQasxWBNI" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/igview-owner~reddit-post-viewer/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-igview-owner-reddit-post-viewer", "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/igview-owner~reddit-post-viewer/runs": { "post": { "operationId": "runs-sync-igview-owner-reddit-post-viewer", "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/igview-owner~reddit-post-viewer/run-sync": { "post": { "operationId": "run-sync-igview-owner-reddit-post-viewer", "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": [ "query" ], "properties": { "query": { "title": "Search Query", "minLength": 1, "maxLength": 300, "type": "string", "description": "🎯 Enter your Reddit search query to find relevant posts. The search will look for the term in the title and selftext of the post.", "default": "technology" }, "subreddit": { "title": "📂 Subreddit (Optional)", "type": "string", "description": "Limit your search to a specific subreddit. Example: 'askscience' or 'technology'. Do NOT include 'r/' before the subreddit name." }, "author": { "title": "👤 Author (Optional)", "type": "string", "description": "Limit your search to submissions made by a specific Reddit user. Example: 'spez' or 'MockDeath'. Do NOT include 'u/' before the author name." }, "sort": { "title": "📊 Sort By", "enum": [ "desc", "asc" ], "type": "string", "description": "🎚️ Choose how to sort search results chronologically:", "default": "desc" }, "time": { "title": "⏰ Time Range (After)", "enum": [ "all", "1y", "30d", "7d", "24h", "1h" ], "type": "string", "description": "📅 Filter posts made after a certain time period:", "default": "all" }, "nsfw": { "title": "🔞 Include NSFW Content", "type": "boolean", "description": "🚨 Control NSFW (Not Safe For Work) content filtering:\nDefault is disabled for safe browsing. Note: The scraper will filter out NSFW markers from the fetched data.", "default": false }, "maxResults": { "title": "📊 Maximum Results", "minimum": 1, "maximum": 5000, "type": "integer", "description": "🔢 Set the maximum number of posts to scrape. The scraper will fetch up to 100 per request. Recommended range: 10-1000 posts.", "default": 100 }, "proxyConfiguration": { "title": "🔒 Proxy Configuration", "type": "object", "description": "Select proxies to be used by the scraper. Apify Residential Proxy is enabled by default for high reliability.", "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 } } } } } } } } } }