{ "openapi": "3.0.1", "info": { "title": "Reddit AI Marketing & Automation Bot", "description": "Autonomous Reddit AI Agent powered by Gemini Pro. Reads community discussions, curates the most relevant threads, and organically promotes your product through intelligent, human-like engagement. Complete stealth, real-time notifications, and zero coding required.", "version": "0.0", "x-build-id": "dVQEPK5j3diMMmxLM" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/rodm33~reddit-ai-marketing-automation-bot/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-rodm33-reddit-ai-marketing-automation-bot", "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/rodm33~reddit-ai-marketing-automation-bot/runs": { "post": { "operationId": "runs-sync-rodm33-reddit-ai-marketing-automation-bot", "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/rodm33~reddit-ai-marketing-automation-bot/run-sync": { "post": { "operationId": "run-sync-rodm33-reddit-ai-marketing-automation-bot", "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": [ "target_url", "target_name", "target_description", "search_keywords" ], "properties": { "manual_cookie": { "title": "🍪 Reddit Session Cookie", "type": "string", "description": "Paste your Reddit session cookie here.\n\n**HOW TO GET IT:**\n1. Log into Reddit in Chrome.\n2. Install the free 'EditThisCookie' extension.\n3. Search for 'reddit_session' and paste its value here." }, "target_url": { "title": "🔗 Target URL (your website link)", "type": "string", "description": "The full URL you want to promote in Reddit comments.", "default": "https://yourwebsite.com" }, "target_name": { "title": "🏷️ Short Site Name", "type": "string", "description": "A natural-sounding name for your site (e.g. 'mywebsite.com' or 'MyTool'). Keep it short, no https://.", "default": "yourwebsite.com" }, "target_description": { "title": "📝 Site Description (for the AI)", "type": "string", "description": "Describe your site in 2–3 sentences. The AI uses this to write natural, contextual comments.", "default": "" }, "search_keywords": { "title": "🔍 Trigger Keywords (topics to monitor)", "type": "array", "description": "The bot will find Reddit posts containing these exact topics. Add keywords related to your niche.", "default": [], "items": { "type": "string" } }, "target_subreddits": { "title": "📋 Target Subreddits (where to post)", "type": "array", "description": "List of subreddits to monitor. Do NOT include the 'r/' prefix.", "default": [ "Entrepreneur", "SaaS", "marketing", "smallbusiness", "startups", "Sales", "Agencies", "B2B" ], "items": { "type": "string" } }, "ai_persona": { "title": "🎭 AI Persona", "enum": [ "Friendly", "Technical", "Casual", "Random" ], "type": "string", "description": "The tone and writing style the AI will use to generate replies.", "default": "Random" }, "promotional_ratio": { "title": "⚖️ Promotional Ratio (%)", "minimum": 0, "maximum": 100, "type": "integer", "description": "The percentage of comments that will include your promotional link. The rest will be helpful comments to build account trust. Recommended: 20-30%.", "default": 20 }, "dry_run": { "title": "🛡️ Dry Run — Test Mode (Safe Testing)", "type": "boolean", "description": "When enabled, the bot logs what it *would* reply, but will NOT post. Turn this ON if you want to test your config without posting.", "default": false }, "karma_farming_mode": { "title": "🌱 Karma Farming Mode (for new accounts)", "type": "boolean", "description": "If your account is new/low karma, enable this. The bot will NEVER post links, just friendly replies to grow karma.", "default": false }, "discord_webhook_url": { "title": "🔔 Discord Webhook URL", "type": "string", "description": "Paste your Discord Webhook URL here to get a summary report after each run. Leave empty to disable." }, "telegram_bot_token": { "title": "✈️ Telegram Bot Token", "type": "string", "description": "Get runtime reports directly to your Telegram. Paste your Bot Token here (from @BotFather). Leave empty to disable." }, "telegram_chat_id": { "title": "✈️ Telegram Chat ID", "type": "string", "description": "The Telegram Chat ID where the bot should send the messages." }, "accounts": { "title": "👥 Multi-Account Rotation (JSON)", "type": "array", "description": "List of Reddit accounts to rotate. Overrides the single cookie field above. Format: [{ \"username\": \"...\", \"manual_cookie\": \"...\" }]" }, "target_domains": { "title": "🔄 Target Domains (Domain Rotation)", "type": "array", "description": "List of alternate domains to rotate randomly. Example: ['mytool.com', 'trymytool.com'].", "default": [], "items": { "type": "string" } }, "max_replies": { "title": "📊 Max Replies per Run", "minimum": 1, "maximum": 20, "type": "integer", "description": "Max comments to post in a single sequence run. Recommended: 5–12.", "default": 10 }, "max_posts_per_account": { "title": "🛑 Max Posts Per Account Per Day", "minimum": 1, "maximum": 50, "type": "integer", "description": "Max posts an account can make in 24 hours before forced rotation.", "default": 10 }, "min_delay_seconds": { "title": "⏱️ Min Delay Between Replies (seconds)", "minimum": 60, "maximum": 600, "type": "integer", "description": "Minimum delay to simulate human typing and reading. Do not set below 60.", "default": 180 }, "max_delay_seconds": { "title": "⏱️ Max Delay Between Replies (seconds)", "minimum": 120, "maximum": 1200, "type": "integer", "description": "Maximum delay. Must be higher than minimum.", "default": 480 }, "prewarm_mode": { "title": "🔥 Browser Pre-Warm Mode", "enum": [ "none", "light", "heavy" ], "type": "string", "description": "Controls pre-login browsing simulation.", "default": "none" }, "proxy_type": { "title": "🌐 Apify Proxy Type", "enum": [ "RESIDENTIAL", "RESIDENTIAL_US", "RESIDENTIAL_EU", "SMART", "DATACENTER" ], "type": "string", "description": "RESIDENTIAL is mandatory for Reddit. Do not use Datacenter.", "default": "RESIDENTIAL" }, "external_proxy": { "title": "🔌 External Proxy URL", "type": "string", "description": "Overrides Apify proxy. Use your own residential proxies." }, "run_interval_hours": { "title": "🕐 Run Interval (hours)", "minimum": 1, "maximum": 24, "type": "integer", "description": "Informational only (logs). Schedule runs natively in Apify Dashboard.", "default": 8 } } }, "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 } } } } } } } } } }