{ "openapi": "3.0.1", "info": { "title": "Reddit Search Scraper - Posts by Keyword ($1.19/1K)", "description": "Search Reddit by keyword and export matching public posts with title, text, author, subreddit, score, upvote ratio, comment count, flair and media. Filter by subreddit, sort, time range or dates. Pay only for unique posts, from $1.19 per 1,000. No Reddit login needed.", "version": "0.4", "x-build-id": "61iqTZSyrBem8NVQm" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/studioxl~reddit-post-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-studioxl-reddit-post-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/studioxl~reddit-post-search-scraper/runs": { "post": { "operationId": "runs-sync-studioxl-reddit-post-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/studioxl~reddit-post-search-scraper/run-sync": { "post": { "operationId": "run-sync-studioxl-reddit-post-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": [ "queries" ], "properties": { "queries": { "title": "Search phrases", "minItems": 1, "maxItems": 10, "type": "array", "description": "What to search Reddit for, one phrase per line (up to 10). A post that matches several phrases is saved and charged once. Example: \"notion alternative\".", "items": { "type": "string", "minLength": 1, "maxLength": 200 }, "default": [ "notion alternative" ] }, "subreddits": { "title": "Only these subreddits", "maxItems": 10, "type": "array", "description": "Leave empty to search all of Reddit. Add names like \"startups\" or \"r/SaaS\" to keep only posts from those communities. Each phrase is searched in each subreddit (20 searches at most).", "items": { "type": "string", "maxLength": 80 } }, "sort": { "title": "Sort by", "enum": [ "relevance", "hot", "top", "new", "comments" ], "type": "string", "description": "Order of the search results. Pick Newest for monitoring, Top for the best-known threads.", "default": "relevance" }, "timeFilter": { "title": "Time range", "enum": [ "all", "hour", "day", "week", "month", "year" ], "type": "string", "description": "Only keep posts created within this period.", "default": "all" }, "maxPosts": { "title": "Max posts", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Most posts to save in this run, across all phrases (1 to 10,000). The limit is shared fairly between phrases. You pay only for saved posts.", "default": 50 }, "maxPostsPerQuery": { "title": "Max posts per phrase", "minimum": 0, "maximum": 10000, "type": "integer", "description": "Optional. Stop each phrase after this many posts, for example 200. 0 means no per-phrase limit (the total is still shared fairly).", "default": 0 }, "dateFrom": { "title": "Posted after", "type": "string", "description": "Optional. Keep posts created on or after this date, for example 2026-01-01 or \"7 days\"." }, "dateTo": { "title": "Posted before", "type": "string", "description": "Optional. Keep posts created on or before this date, for example 2026-03-31." }, "strictTokenFilter": { "title": "Only posts containing every word", "type": "boolean", "description": "Keep a post only if every word of the phrase appears in its title, text or link. Good for cutting loose matches; it can also drop relevant posts.", "default": false }, "includeNsfw": { "title": "Include NSFW posts", "type": "boolean", "description": "Off by default. Turn on to keep posts marked NSFW (18+).", "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }