{ "openapi": "3.0.1", "info": { "title": "Reddit Scraper: Posts, Keyword Mentions & New-Post Alerts", "description": "Find Reddit posts mentioning your brand, product or keywords, such as Notion or coffee gear. Search communities and URLs, paginate, and watch new mentions with intent labels. Comments may be unavailable. About $0.0032/post, $0.0015/comment plus $0.005 start. No login, no API key.", "version": "1.0", "x-build-id": "7wS34mVur2MhSOoR8" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/vant47~reddit-keyword-alerts/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-vant47-reddit-keyword-alerts", "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/vant47~reddit-keyword-alerts/runs": { "post": { "operationId": "runs-sync-vant47-reddit-keyword-alerts", "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/vant47~reddit-keyword-alerts/run-sync": { "post": { "operationId": "run-sync-vant47-reddit-keyword-alerts", "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", "properties": { "searchTerms": { "title": "Search terms", "type": "array", "description": "Keywords or Reddit search expressions, for example coffee grinder or Notion. Searches all Reddit, or each chosen subreddit. Literal matches appear in matchedTerms. No login or API key.", "items": { "type": "string" } }, "subreddits": { "title": "Subreddits", "type": "array", "description": "Optional community names, for example Coffee, espresso or SaaS. With search terms, restrict each search to these communities. Without terms, read their public post feeds.", "items": { "type": "string" } }, "startUrls": { "title": "Reddit URLs", "type": "array", "description": "Optional public HTTPS subreddit, post or search URLs. Accepts plain URL strings and objects with a url property. Combined with keywords and subreddits; duplicate posts and comments are charged once." }, "sort": { "title": "Sort", "enum": [ "new", "hot", "top", "relevance" ], "type": "string", "description": "new is best for recurring watches. hot, top and relevance use Reddit ranking; relevance applies to search and becomes new for community feeds.", "default": "new" }, "timeRange": { "title": "Time range", "enum": [ "all", "hour", "day", "week", "month", "year" ], "type": "string", "description": "Reddit time filter for search and top feeds. Does not filter replies in an existing post. Not a complete historical archive.", "default": "all" }, "includeComments": { "title": "Include comments", "type": "boolean", "description": "Try accessible public replies. Comment threads may be unavailable when Reddit refuses access. Refusals become free note rows; delivered posts are kept. Default off.", "default": false }, "maxCommentsPerPost": { "title": "Comments per post", "minimum": 1, "maximum": 500, "type": "integer", "description": "Maximum comment records examined for each post, including already-seen replies on recurring watches. Deleted and removed bodies are skipped. About $0.0015 for each new delivered comment.", "default": 50 }, "maxItems": { "title": "Maximum total posts and comments", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Run-wide maximum unique delivered posts plus comments. Known watch IDs do not consume it. Twenty posts cost about $0.064 plus the small start charge. Summary and note rows are free.", "default": 20 }, "onlyNewSinceLastRun": { "title": "Only previously undelivered IDs", "type": "boolean", "description": "Keep a persistent post and comment ID history in a named key-value store per watchId. The first run delivers the current window; later runs skip IDs already delivered. Run each watch sequentially.", "default": false }, "watchId": { "title": "Watch ID", "type": "string", "description": "Stable name for sequential scheduled runs, such as coffee-brand. Different watch IDs have independent histories. Letters, digits, underscores and hyphens only; 1 to 80 characters. An unfinished watch must be resumed or use a new ID.", "default": "default" }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify datacenter first, with fresh-session retries and US and UK residential fallback where required. A custom proxy or disabled proxy is respected without automatically adding residential.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }