{ "openapi": "3.0.1", "info": { "title": "Reddit Search Scraper (Relevant Posts Only)", "description": "Reddit scraper that returns only genuinely relevant posts, not viral noise. Enter any keyword and get back only for relevant results. Great for social listening, market research, and lead generation.", "version": "0.0", "x-build-id": "9mr3iXmoOcimodont" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/bustling_spotlight~reddit-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-bustling_spotlight-reddit-search-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/bustling_spotlight~reddit-search-scraper/runs": { "post": { "operationId": "runs-sync-bustling_spotlight-reddit-search-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/bustling_spotlight~reddit-search-scraper/run-sync": { "post": { "operationId": "run-sync-bustling_spotlight-reddit-search-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": [ "keywords" ], "properties": { "keywords": { "title": "Keywords / search queries", "type": "array", "description": "One or more search queries. For each keyword the actor returns only the genuinely relevant Reddit posts — not viral, off-topic noise.", "items": { "type": "string" } }, "postsPerKeyword": { "title": "Relevant posts per keyword", "minimum": 1, "maximum": 100, "type": "integer", "description": "Maximum number of relevant posts to return per keyword. You are only charged for posts actually returned.", "default": 25 }, "sort": { "title": "Sort results by", "enum": [ "relevance", "hot", "top", "new", "comments" ], "type": "string", "description": "How results are ranked. 'Relevance' is best for on-topic search; 'New' for fresh monitoring; 'Top'/'Hot' for popular discussion.", "default": "relevance" }, "time": { "title": "Time range", "enum": [ "hour", "day", "week", "month", "year", "all" ], "type": "string", "description": "Time window applied when sorting by Relevance, Top, or Comments. Ignored for Hot and New.", "default": "all" }, "domainHint": { "title": "Domain hint (optional, advanced)", "type": "string", "description": "Optional. If your keywords are ambiguous, name the domain in a few words (e.g. 'B2B software' or 'content creation, podcasting, video') so results reject same-word matches from unrelated fields. Leave blank to auto-detect from each keyword." }, "proxyCountryCode": { "title": "Proxy country code", "type": "string", "description": "Two-letter country code for the residential proxy used to reach Reddit (e.g. 'us', 'gb', 'de'). Leave blank for any country.", "default": "us" }, "tryCheapProxyFirst": { "title": "Try cheap proxy first (lower cost)", "type": "boolean", "description": "Probe a cheap datacenter proxy before falling back to residential. ScrapingBee doesn't bill blocked requests, so this is free upside and cuts cost when it works — at the price of slightly higher latency on keywords where Reddit blocks the cheap proxy. Turn off for lowest latency.", "default": true }, "debugLog": { "title": "Verbose debug logging", "type": "boolean", "description": "Log discovered subreddits, candidate counts, and LLM decisions for troubleshooting.", "default": false } } }, "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 } } } } } } } } } }