{ "openapi": "3.0.1", "info": { "title": "YouTube Breakout Alerts", "description": "Get alerted when a YouTube video takes off. Compares each video with the channel's usual views at the same age, explains how it's doing in plain English, and sends alerts to Slack or Discord. No API key needed.", "version": "0.0", "x-build-id": "u93PT0kXrfvyZ1Tug" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/ecru_manor~youtube-breakout-alerts/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-ecru_manor-youtube-breakout-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/ecru_manor~youtube-breakout-alerts/runs": { "post": { "operationId": "runs-sync-ecru_manor-youtube-breakout-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/ecru_manor~youtube-breakout-alerts/run-sync": { "post": { "operationId": "run-sync-ecru_manor-youtube-breakout-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", "required": [ "channels" ], "properties": { "channels": { "title": "YouTube channels", "type": "array", "description": "Channels to watch. Paste a channel link, an @handle or a channel ID.", "items": { "type": "string" } }, "breakoutMultiple": { "title": "Breakout threshold", "minimum": 1.1, "type": "number", "description": "Flag a video when it has this many times the views expected at its age. 2 means twice the usual.", "default": 2 }, "minViews": { "title": "Minimum views", "minimum": 0, "type": "integer", "description": "Ignore videos below this view count, which filters out noise on small channels.", "default": 1000 }, "onlyBreakouts": { "title": "Only save breakouts to the results", "type": "boolean", "description": "Turn on to leave out every video that isn't a breakout. The report still shows them all.", "default": false }, "discordWebhookUrl": { "title": "Discord webhook URL", "type": "string", "description": "Starts with https://discord.com/api/webhooks/" }, "slackWebhookUrl": { "title": "Slack webhook URL", "type": "string", "description": "Starts with https://hooks.slack.com/" }, "maxAlertsPerRun": { "title": "Maximum alerts per run", "minimum": 1, "maximum": 100, "type": "integer", "description": "Highest scores go first. Any extras are sent on the next run.", "default": 10 }, "sendTestAlert": { "title": "Send a test alert", "type": "boolean", "description": "Sends one labelled sample so you can check your webhook. Turn this off before scheduling.", "default": false }, "minMinutesBetweenChecks": { "title": "Don't recheck a channel within (minutes)", "minimum": 0, "maximum": 1440, "type": "integer", "description": "Channels checked more recently than this are skipped at no charge, which protects you from paying twice for an accidental re-run. Set to 0 to turn this off.", "default": 30 }, "watchlistName": { "title": "Watchlist name", "pattern": "^[a-zA-Z0-9-]{1,30}$", "type": "string", "description": "History is saved under this name between runs. Use a different name for each separate list of channels.", "default": "default" } } }, "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 } } } } } } } } } }