{ "openapi": "3.0.1", "info": { "title": "Reddit Search Scraper - $0.891/1k, No API Key", "description": "Search all of Reddit by keyword and get titles, full selftext, scores, comment counts, subreddit, author and permalink. $0.891 per 1,000 posts with no run-start fee, flat on every plan. No Reddit account, no API key, no OAuth app.", "version": "0.1", "x-build-id": "TRbf4juepc3nXoMe6" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/dami_studio~reddit-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-dami_studio-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/dami_studio~reddit-search-scraper/runs": { "post": { "operationId": "runs-sync-dami_studio-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/dami_studio~reddit-search-scraper/run-sync": { "post": { "operationId": "run-sync-dami_studio-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": [ "query" ], "properties": { "query": { "title": "Search query", "type": "string", "description": "Keywords to search Reddit for. Supports Reddit search operators (e.g. \"title:layoffs\", \"author:spez\", quotes for phrases)." }, "subreddit": { "title": "Restrict to subreddit (optional)", "type": "string", "description": "Search only within this subreddit (e.g. \"MechanicalKeyboards\" or \"r/MechanicalKeyboards\"). Leave empty to search all of Reddit." }, "sort": { "title": "Sort by", "enum": [ "relevance", "hot", "top", "new", "comments" ], "type": "string", "description": "How to order the search results.", "default": "relevance" }, "time": { "title": "Time window", "enum": [ "hour", "day", "week", "month", "year", "all" ], "type": "string", "description": "Applies to Relevance / Top / Most-comments sorts.", "default": "all" }, "maxItems": { "title": "Max posts", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Keyless RSS returns up to ~25 newest-matching posts and leaves score, numComments, upvoteRatio, flair, thumbnail and domain null (only title, author, url, selftext, createdAt, permalink, subreddit, isSelf, over18 are populated). Add Reddit app credentials below to paginate up to this many posts with full scores/comment counts and all fields populated.", "default": 50 }, "includeComments": { "title": "Include top comments", "type": "boolean", "description": "Fetch top comments for each post. Requires Reddit app credentials (anonymous comment access is blocked by Reddit).", "default": false }, "commentLimit": { "title": "Comments per post", "minimum": 1, "maximum": 100, "type": "integer", "description": "Maximum number of top comments to fetch per post (when Include comments is on).", "default": 10 }, "redditClientId": { "title": "Reddit app client ID (optional)", "type": "string", "description": "Optional. Create a free 'script' app at reddit.com/prefs/apps for richer fields (score, comment counts), deeper pagination, and comments. Without it the actor uses keyless RSS." }, "redditClientSecret": { "title": "Reddit app client secret (optional)", "type": "string", "description": "The secret for the Reddit app above." }, "notionConnector": { "title": "Notion connector (optional)", "type": "string", "description": "Optional. Write each post as a page into your Notion when the run finishes. Authorize a Notion connector once in Settings → API & Integrations → MCP connectors, then pick it here. Leave empty to skip (default) — results are always saved to the dataset regardless." }, "notionParentId": { "title": "Notion target data source ID", "type": "string", "description": "Optional. The Notion data source ID of the database to write into (only used if a Notion connector is set). Leave empty to create the pages privately in your workspace instead." }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Optional, and off by default: the keyless RSS path runs on Reddit's RSS infrastructure (resilient by design) and needs no proxy. Enable the Apify proxy only if you hit IP rate limits, or when using Reddit app credentials at high volume — a fresh datacenter IP is then rotated on every attempt. Metered proxy groups (RESIDENTIAL, GOOGLE_SERP) are not offered by this Actor — if you select one it is automatically replaced with datacenter addresses and the run continues. Your own proxy servers, entered as custom proxy URLs, are used exactly as given.", "default": { "useApifyProxy": 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 } } } } } } } } } }