{
  "openapi": "3.0.1",
  "info": {
    "title": "Reddit Lead Finder & Brand Mention Monitor",
    "description": "Reddit lead generation and keyword monitoring for AI agents. Search posts and comments in a subreddit, qualify buying intent, and track brand or competitor mentions. Export JSON or send Slack and Notion alerts. Reddit-wide keyword search requires ScrapeAtlas.",
    "version": "1.0",
    "x-build-id": "9xVifQFKVn2WzV3Io"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/whoareyouanas~reddit-lead-finder/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-whoareyouanas-reddit-lead-finder",
        "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/whoareyouanas~reddit-lead-finder/runs": {
      "post": {
        "operationId": "runs-sync-whoareyouanas-reddit-lead-finder",
        "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/whoareyouanas~reddit-lead-finder/run-sync": {
      "post": {
        "operationId": "run-sync-whoareyouanas-reddit-lead-finder",
        "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 phrases",
            "type": "array",
            "description": "Search one or more buying-intent phrases, products, or brands. Set withinCommunity for subreddit search. Reddit-wide keyword search requires ScrapeAtlas. Post and comment caps apply per phrase.",
            "items": {
              "type": "string",
              "minLength": 1,
              "maxLength": 500
            },
            "default": []
          },
          "withinCommunity": {
            "title": "Search within a subreddit",
            "type": "string",
            "description": "Set this to search a single subreddit through the Arctic Shift archive without a Reddit API key. Use a subreddit name, r/name, or community URL. Leave it empty for Reddit-wide search with ScrapeAtlas.",
            "default": ""
          },
          "searchPosts": {
            "title": "Search posts",
            "type": "boolean",
            "description": "Return posts that match each phrase.",
            "default": true
          },
          "searchComments": {
            "title": "Search comments",
            "type": "boolean",
            "description": "Search comment bodies for each phrase. Cap these rows with maxCommentsCount. Collecting replies from startUrls or matched posts uses crawlCommentsPerPost and maxCommentsPerPost.",
            "default": true
          },
          "searchCommunities": {
            "title": "Find communities",
            "type": "boolean",
            "description": "Return matching community rows. Keyless discovery matches the start of community names.",
            "default": false
          },
          "searchSort": {
            "title": "Search ranking",
            "enum": [
              "new",
              "relevance",
              "hot",
              "top",
              "comments"
            ],
            "type": "string",
            "description": "A custom lower date bound forces newest-first for the corresponding result type.",
            "default": "new"
          },
          "searchTime": {
            "title": "Search time range",
            "enum": [
              "all",
              "hour",
              "day",
              "week",
              "month",
              "year"
            ],
            "type": "string",
            "description": "A preset lookback for keyword search. An explicit lower date bound takes precedence.",
            "default": "all"
          },
          "postedAfter": {
            "title": "Posts from",
            "type": "string",
            "description": "UTC date, timestamp with a timezone, or lookback such as 1 day."
          },
          "postedBefore": {
            "title": "Posts through",
            "type": "string",
            "description": "Inclusive UTC date or timestamp. A relative duration excludes newer posts."
          },
          "commentedAfter": {
            "title": "Comments from",
            "type": "string",
            "description": "Lower UTC bound for search comments and replies."
          },
          "commentedBefore": {
            "title": "Comments through",
            "type": "string",
            "description": "Inclusive upper UTC bound for search comments and replies."
          },
          "onlyWithFlair": {
            "title": "Require post flair",
            "type": "boolean",
            "description": "Keep posts with a flair.",
            "default": false
          },
          "includeNSFW": {
            "title": "Include NSFW",
            "type": "boolean",
            "description": "Allow records flagged as adult content by the source.",
            "default": false
          },
          "maxPostsCount": {
            "title": "Posts per phrase or URL",
            "minimum": 0,
            "maximum": 50000,
            "type": "integer",
            "description": "Maximum saved posts per search phrase or direct target.",
            "default": 50
          },
          "maxCommentsCount": {
            "title": "Search or profile comments",
            "minimum": 0,
            "maximum": 50000,
            "type": "integer",
            "description": "Maximum comments per search phrase or user URL.",
            "default": 400
          },
          "crawlCommentsPerPost": {
            "title": "Collect replies in each thread",
            "type": "boolean",
            "description": "Add individual comment rows for each saved post.",
            "default": true
          },
          "maxCommentsPerPost": {
            "title": "Replies per post",
            "minimum": 0,
            "maximum": 50000,
            "type": "integer",
            "description": "Maximum comments for each collected thread.",
            "default": 200
          },
          "maxCommunitiesCount": {
            "title": "Communities per phrase",
            "minimum": 0,
            "maximum": 1000,
            "type": "integer",
            "description": "Maximum communities from each keyword search.",
            "default": 2
          },
          "startUrls": {
            "title": "Reddit URLs",
            "type": "array",
            "description": "Provide post, comment, subreddit, user, or Reddit search URLs.",
            "default": [],
            "items": {
              "type": "object",
              "required": [
                "url"
              ],
              "properties": {
                "url": {
                  "type": "string",
                  "title": "URL of a web page",
                  "format": "uri"
                }
              }
            }
          },
          "subredditUrls": {
            "title": "Subreddit feeds",
            "type": "array",
            "description": "Enter subreddit names or home URLs to collect newest posts.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "aiAnalysis": {
            "title": "Analyze content with AI",
            "type": "boolean",
            "description": "Add sentiment, intent, emotion, product entities, and relevance.",
            "default": false
          },
          "wantsHelp": {
            "title": "Seeking help",
            "type": "boolean",
            "description": "Seeking a product, service, recommendation, or someone to solve a problem.",
            "default": false
          },
          "isOwner": {
            "title": "Business owner",
            "type": "boolean",
            "description": "The writer says or clearly shows that they own or operate a business.",
            "default": false
          },
          "isVendor": {
            "title": "Self-promotion",
            "type": "boolean",
            "description": "The writer promotes or recruits users for a product or service of their own.",
            "default": false
          },
          "hasPain": {
            "title": "Describes a problem",
            "type": "boolean",
            "description": "Describes a concrete problem, frustration, failed tool, or unmet need.",
            "default": false
          },
          "mentionsPrice": {
            "title": "Mentions pricing",
            "type": "boolean",
            "description": "Mentions a price, subscription, fee, or spending.",
            "default": false
          },
          "featureRequest": {
            "title": "Requests a feature",
            "type": "boolean",
            "description": "Requests or wishes for a missing capability.",
            "default": false
          },
          "willingToPay": {
            "title": "Willing to pay",
            "type": "boolean",
            "description": "States a budget, requests a quote, or expresses willingness to pay.",
            "default": false
          },
          "painPoint": {
            "title": "Extract pain point",
            "type": "boolean",
            "description": "Summarize the specific problem in at most 15 words. Use null if absent.",
            "default": false
          },
          "competitor": {
            "title": "Extract competitor",
            "type": "boolean",
            "description": "Name the competing product mentioned. Use null if absent.",
            "default": false
          },
          "customLabels": {
            "title": "Custom AI labels",
            "type": "object",
            "description": "Add up to five label names and plain-language classification instructions.",
            "default": {}
          },
          "aiModel": {
            "title": "OpenRouter model",
            "type": "string",
            "description": "Optional model identifier. Use a model that supports structured JSON output."
          },
          "openRouterApiKey": {
            "title": "OpenRouter API key",
            "type": "string",
            "description": "Optional key. Apify runs can use the Apify OpenRouter integration."
          },
          "scrapeAtlasApiKey": {
            "title": "ScrapeAtlas API key",
            "type": "string",
            "description": "Enables Reddit-wide post and comment search. Scoped searches and direct URLs can use Arctic Shift without a key."
          },
          "mcpConnector": {
            "title": "Delivery connector",
            "type": "string",
            "description": "Select an authorized Slack, Notion, or compatible delivery connector."
          },
          "mcpTarget": {
            "title": "Delivery destination",
            "type": "string",
            "description": "A channel ID, Notion page ID, or another identifier expected by the tool."
          },
          "mcpMode": {
            "title": "Delivery mode",
            "enum": [
              "perPost",
              "summary"
            ],
            "type": "string",
            "description": "Send one message per post or one digest.",
            "default": "perPost"
          },
          "mcpComments": {
            "title": "Include thread replies",
            "enum": [
              "ignore",
              "bundle",
              "separate"
            ],
            "type": "string",
            "description": "Ignore, bundle the highest-scoring replies, or send them separately in per-post mode.",
            "default": "ignore"
          },
          "mcpCommentsPerPost": {
            "title": "Replies per delivery",
            "minimum": 1,
            "maximum": 50,
            "type": "integer",
            "description": "Maximum highest scoring replies to include per post.",
            "default": 5
          },
          "mcpMaxItems": {
            "title": "Posts to deliver",
            "minimum": 1,
            "maximum": 1000,
            "type": "integer",
            "description": "Maximum distinct posts included in delivery.",
            "default": 50
          },
          "mcpMessage": {
            "title": "Message template",
            "type": "string",
            "description": "Use {{field}} placeholders, including nested fields and array indexes.",
            "default": "{{title}}\n{{postUrl}}"
          },
          "mcpTool": {
            "title": "Tool override",
            "type": "string",
            "description": "Exact MCP tool name. Leave empty for compatible messaging and page creation tools."
          },
          "mcpArguments": {
            "title": "Tool arguments",
            "type": "object",
            "description": "Optional overrides. String values can use the same placeholders as the message template.",
            "default": {}
          },
          "mcpServerUrl": {
            "title": "Direct MCP server URL",
            "type": "string",
            "description": "Optional HTTPS Streamable HTTP MCP endpoint for development or custom connectors."
          },
          "mcpServerToken": {
            "title": "Direct MCP server token",
            "type": "string",
            "description": "Optional bearer token for the configured direct MCP server."
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}