{ "openapi": "3.0.1", "info": { "title": "Reddit Lead Monitor: Subreddit and Keyword Alert Feed", "description": "Watches subreddits for posts that match your keywords, upvote floor, and age window. Dedupes across runs so you only get new matches. Output JSON, CSV, or Excel. For SaaS founders, marketers, and support teams hunting leads and brand mentions on Reddit.", "version": "0.1", "x-build-id": "7mLwxVGhsYITQEjlA" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapemint~reddit-lead-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapemint-reddit-lead-monitor", "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/scrapemint~reddit-lead-monitor/runs": { "post": { "operationId": "runs-sync-scrapemint-reddit-lead-monitor", "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/scrapemint~reddit-lead-monitor/run-sync": { "post": { "operationId": "run-sync-scrapemint-reddit-lead-monitor", "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": { "subreddits": { "title": "Subreddits to watch", "type": "array", "description": "List of subreddit names (without r/). Example: SaaS, startups, smallbusiness. Leave empty if using searchQueries instead.", "items": { "type": "string" } }, "searchQueries": { "title": "Search queries (optional)", "type": "array", "description": "Reddit search queries across all of Reddit. Use instead of or alongside subreddits. Example: best scraping tool, alternative to AppFollow.", "items": { "type": "string" } }, "keywords": { "title": "Keywords (client side filter)", "type": "array", "description": "Only posts whose title or body contains any of these keywords are kept. Case insensitive. Leave empty to keep all posts from the listed subreddits.", "items": { "type": "string" } }, "sortBy": { "title": "Sort", "enum": [ "new", "hot", "top", "rising" ], "type": "string", "description": "New returns the latest posts in the subreddit. Hot returns currently trending posts. Top returns the highest scoring posts in the timeWindow.", "default": "new" }, "timeWindow": { "title": "Time window (for top sort)", "enum": [ "hour", "day", "week", "month", "year", "all" ], "type": "string", "description": "Only applies when sortBy is 'top'. Window for Reddit's top ranking.", "default": "day" }, "maxPostsPerSource": { "title": "Max posts per subreddit or query", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Reddit returns up to 100 posts per listing page. Pagination pulls more. This is the per source cap.", "default": 100 }, "maxAgeHours": { "title": "Max age in hours", "minimum": 0, "maximum": 8760, "type": "integer", "description": "Skip posts older than this many hours. 0 keeps all posts regardless of age.", "default": 24 }, "minUpvotes": { "title": "Minimum upvotes", "minimum": 0, "maximum": 1000000, "type": "integer", "description": "Skip posts with fewer than this many upvotes. 0 keeps everything.", "default": 0 }, "minComments": { "title": "Minimum comments", "minimum": 0, "maximum": 100000, "type": "integer", "description": "Skip posts with fewer than this many comments. 0 keeps everything.", "default": 0 }, "includeNSFW": { "title": "Include NSFW posts", "type": "boolean", "description": "Keep NSFW (over 18) posts. Off by default for business use.", "default": false }, "dedupe": { "title": "Deduplicate across runs", "type": "boolean", "description": "Skip post IDs pushed on previous runs. Stores IDs in the key value store under SEEN_IDS. Turn off to return every matching post on every run.", "default": true }, "maxPostsTotal": { "title": "Maximum posts per run", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Hard cap on posts pushed to the dataset per run. Controls cost.", "default": 200 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify proxy settings. Reddit's public JSON API is usually accessible without a proxy, but residential proxies help if rate limited." } } }, "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 } } } } } } } } } }