{ "openapi": "3.0.1", "info": { "title": "Reddit Search Scraper - $0.891/1k, Keyless by Default", "description": "Search Reddit posts by keyword, across the site or inside one subreddit. No key needed: you get up to 100 posts and their comments. Reddit's public feed has no vote data, so scores and comment counts come back empty. Add a free Reddit app to fill them in. $0.891 per 1,000 posts.", "version": "0.1", "x-build-id": "Fm51GMHm6znpuEXQS" }, "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." }, "time": { "title": "Time window", "enum": [ "hour", "day", "week", "month", "year", "all" ], "type": "string", "description": "Applies to Relevance / Top / Most-comments sorts.", "default": "all" }, "redditClientId": { "title": "Reddit app client ID (optional)", "type": "string", "description": "Optional. Create a free 'script' app at reddit.com/prefs/apps to fill in the vote data the public feed does not carry (score, upvoteRatio, numComments, flair), to get scores on comments, and to page past 100 posts. Without it the actor uses the keyless feed, which still returns posts and comments." }, "redditClientSecret": { "title": "Reddit app client secret (optional)", "type": "string", "description": "The secret for the Reddit app above." }, "sort": { "title": "Sort by", "enum": [ "relevance", "hot", "top", "new", "comments" ], "type": "string", "description": "How to order the search results.", "default": "relevance" }, "maxItems": { "title": "Max posts", "minimum": 1, "maximum": 1000, "type": "integer", "description": "The keyless feed returns up to 100 matching posts per search — ask for more and 100 is what arrives. It carries no vote data, so score, numComments, upvoteRatio and flair come back null; title, author, url, permalink, subreddit, selftext, createdAt, isSelf, domain and thumbnail are populated. Add Reddit app credentials below to fill in the vote data and page past 100.", "default": 50 }, "commentLimit": { "title": "Comments per post", "minimum": 1, "maximum": 100, "type": "integer", "description": "How many comments to keep per post, top-sorted. Worth keeping low when you are pulling a lot of posts — this multiplies with Max posts.", "default": 10 }, "includeComments": { "title": "Include comments", "type": "boolean", "description": "Read each post's comments. Works without Reddit app credentials. Reddit serves a given address about one comment feed per minute, so this is paced and slower than a plain search: measured, 5 posts come back complete in about 5 seconds, while 100 posts take about 3 minutes and around 86 of them get comments. Posts that missed out carry a commentsError on the row rather than an empty list. Comments have author, body, permalink and createdAt; Reddit's comment feed carries no scores, so comment score is null unless you add app credentials.", "default": false }, "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 } } } } } } } } } }