{ "openapi": "3.0.1", "info": { "title": "YouTube Channel Playbook: Titles & Thumbnails", "description": "Find which YouTube titles, thumbnails, topics, formats and upload days beat each channel's median, then get original video ideas for your channel.", "version": "0.2", "x-build-id": "b6hoWFvQYPUaJo48n" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/seasons-ai~youtube-channel-playbook/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-seasons-ai-youtube-channel-playbook", "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/seasons-ai~youtube-channel-playbook/runs": { "post": { "operationId": "runs-sync-seasons-ai-youtube-channel-playbook", "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/seasons-ai~youtube-channel-playbook/run-sync": { "post": { "operationId": "run-sync-seasons-ai-youtube-channel-playbook", "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": { "datasetId": { "title": "YouTube scraper dataset", "type": "string", "description": "Pick the dataset of your YouTube Scraper run (streamers/youtube-scraper) or YouTube Channel Scraper run (streamers/youtube-channel-scraper) on one or more public channels: yours and the ones you compete with. Through the API, pass the run's defaultDatasetId. The Actor only reads it. Tip: in the YouTube Scraper turn on \"Only download subtitles\" to also get the opening 60 seconds of each video analysed. Leave empty to use Items or Items URL instead." }, "items": { "title": "Items (fallback)", "type": "array", "description": "Video items as JSON in the YouTube Scraper format: title, url, thumbnailUrl, viewCount, likes, commentsCount, date, duration, type (video / shorts / stream), channelName, channelUsername, optional subtitles. Used when no dataset is picked. The prefill is a 9-video synthetic demo of two fictional cooking channels." }, "itemsUrl": { "title": "Items URL (fallback)", "type": "string", "description": "Link to a JSON or CSV export of a YouTube scraper dataset (same fields as Items). Used when neither a dataset nor items are given." }, "myChannel": { "title": "Your channel (optional)", "type": "string", "description": "Your channel's @handle, name or URL, if it is in the dataset. The playbook then compares it with the other channels (gaps) and aims the concepts at it. Leave empty to compare all channels equally." }, "maxVideos": { "title": "Maximum videos to analyse", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Cap on videos analysed in this run, taken evenly across the channels in the dataset. Each analysed video is one charge.", "default": 200 }, "channelBrief": { "title": "Your channel brief", "type": "string", "description": "What your channel is about, who watches it, tone, what you can film (on camera or not, budget, gear) and what to avoid. Required when Number of concepts is above 0." }, "conceptsCount": { "title": "Number of concepts", "minimum": 0, "maximum": 30, "type": "integer", "description": "How many original video concepts (title + thumbnail idea + opening hook line) to write from the winning patterns (0 = analysis only). Each concept is one charge.", "default": 10 }, "language": { "title": "Concept language", "type": "string", "description": "Language of the concepts and takeaways, for example English, German, Spanish.", "default": "English" }, "_previewAsFree": { "title": "Preview as a free-plan user (owner test)", "type": "boolean", "description": "Owner-only test switch: return the free-plan preview instead of running. Ignored for every other account." } } }, "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 } } } } } } } } } }