{ "openapi": "3.0.1", "info": { "title": "Reddit Mention Monitor โ€” Track Brand & Keyword Mentions", "description": "Monitor reddit.com for mentions of your brand, product or any keyword. Returns only the posts and comments that literally mention your terms โ€” with thread context, author, subreddit and engagement signals (score, upvote ratio, comment count). No login or developer token needed.", "version": "0.1", "x-build-id": "iUdcSee9tKDtb3dXF" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/blackfalcondata~reddit-mention-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-blackfalcondata-reddit-mention-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/blackfalcondata~reddit-mention-monitor/runs": { "post": { "operationId": "runs-sync-blackfalcondata-reddit-mention-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/blackfalcondata~reddit-mention-monitor/run-sync": { "post": { "operationId": "run-sync-blackfalcondata-reddit-mention-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": { "startUrls": { "title": "๐Ÿ”— Start URLs", "type": "array", "description": "Reddit URLs to scrape โ€” subreddits, post pages, user profiles, community pages, or search result pages. Each URL determines what type of content is fetched. Use the full link that includes the subreddit (reddit.com/r//... , any subdomain works). Links that need Reddit to resolve them first โ€” redd.it short links, /r//s/... share links, and post links without the community (reddit.com/comments/...) โ€” are skipped, as are non-Reddit URLs; the run log says how many were skipped.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "searchTerms": { "title": "๐Ÿ”Ž Search Terms", "type": "array", "description": "Search Reddit for these terms. Each entry becomes an independent search. Search posts are lightweight discovery records (plus their comments) โ€” see Search Type.", "items": { "type": "string" } }, "searchType": { "title": "๐Ÿ”Ž Search Type", "enum": [ "posts" ], "type": "string", "description": "Type of results to return when using Search Terms. Post results are lightweight discovery records โ€” id, url, title, subreddit and NSFW flag โ€” plus their comment threads; scrape a result's URL directly for its full post fields (author, body, score, timestamp).", "default": "posts" }, "keywords": { "title": "๐ŸŽฏ Match Keywords", "type": "array", "description": "Exact terms to track. A post or comment is kept only if its title or body literally contains one of these terms (or one of your Search Terms). Leave empty to keep all search results.", "items": { "type": "string" } }, "sort": { "title": "๐Ÿ“Š Sort", "enum": [ "relevance", "hot", "top", "new", "comments" ], "type": "string", "description": "Sort order for results. Search supports every option. Subreddit feeds support Hot, New and Top โ€” choosing Relevance or Most Comments for a subreddit falls back to Hot (the feed has no such order), and the run log says so.", "default": "hot" }, "time": { "title": "๐Ÿ•’ Time Filter", "enum": [ "hour", "day", "week", "month", "year", "all" ], "type": "string", "description": "Restrict subreddit-feed results to a time window (applies to Top sort on feeds; search is not time-windowed).", "default": "all" }, "includeNSFW": { "title": "๐Ÿ”ž Include NSFW", "type": "boolean", "description": "Include posts and communities marked as NSFW (18+).", "default": false }, "postDateLimit": { "title": "๐Ÿ“… Post Date Limit", "type": "string", "description": "Skip posts older than this ISO-8601 date (e.g. \"2024-01-01\"). Applies to subreddit feeds and post URLs; search results carry no date and are not filtered. Leave blank for no date limit." }, "maxItems": { "title": "๐Ÿ”ข Max Items", "minimum": 1, "type": "integer", "description": "Maximum total records to save across all sources (posts, comments, users, communities).", "default": 100 }, "maxComments": { "title": "๐Ÿ’ฌ Max Comments Per Post", "minimum": 0, "type": "integer", "description": "Maximum number of comments to collect from each post page.", "default": 200 }, "includeCollapsed": { "title": "๐Ÿ’ฌ Include Collapsed Comments", "type": "boolean", "description": "Expand and include comments that are initially collapsed (controversial or low-score). Enables deeper thread coverage, up to the comment and depth limits you set.", "default": true }, "commentDepth": { "title": "๐ŸŒณ Comment Depth", "minimum": 1, "type": "integer", "description": "Maximum reply nesting depth to collect (1 = top-level only).", "default": 10 }, "skipComments": { "title": "โญ๏ธ Skip Comments", "type": "boolean", "description": "Do not collect comments from post pages โ€” output posts only.", "default": false }, "descriptionFormat": { "title": "๐Ÿ“„ Description Format", "enum": [ "all", "text", "html", "markdown" ], "type": "string", "description": "Controls which body/description fields are included in output. \"all\" emits text + HTML + markdown variants.", "default": "all" }, "excludeEmptyFields": { "title": "๐Ÿงน Exclude Empty Fields", "type": "boolean", "description": "Strip null and empty fields from output records to reduce payload size.", "default": false }, "includeRunMetadata": { "title": "๐Ÿ“‹ Include Run Metadata", "type": "boolean", "description": "Append a single run-summary record at the end of the dataset (run ID, timing, item counts). It is marked itemType=\"runMetadata\" and is added in addition to your matching records โ€” filter on itemType to exclude it.", "default": false }, "appConnector": { "title": "Send results to Notion (or another connected app)", "type": "string", "description": "Optional. Pick a connected app under Settings โ†’ API & Integrations to receive your scraped Reddit results. Notion is supported today (a run-summary page); other MCP connectors are best-effort as Apify expands its catalog." } } }, "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 } } } } } } } } } }