{ "openapi": "3.0.1", "info": { "title": "YouTube Channel → Blog, Newsletter & Shorts Repurposer", "description": "Watches YouTube channels for new uploads and turns every video into a ready-to-edit content bundle: SEO blog draft, newsletter section, X/LinkedIn thread, Shorts hook candidates with timestamps, and an SRT subtitle file.", "version": "0.1", "x-build-id": "faW3ohVnLPbodBShd" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/yasaslive~channel-repurposer/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-yasaslive-channel-repurposer", "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/yasaslive~channel-repurposer/runs": { "post": { "operationId": "runs-sync-yasaslive-channel-repurposer", "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/yasaslive~channel-repurposer/run-sync": { "post": { "operationId": "run-sync-yasaslive-channel-repurposer", "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": [ "channelUrls" ], "properties": { "channelUrls": { "title": "YouTube channels", "uniqueItems": true, "type": "array", "description": "Channels to watch. Accepts @handles (`@mkbhd`), full channel URLs (`https://www.youtube.com/@mkbhd`, `https://www.youtube.com/channel/UC...`), or bare channel IDs (`UC...`).", "items": { "type": "string" } }, "maxNewVideosPerChannel": { "title": "Max new videos per channel per run", "minimum": 1, "maximum": 15, "type": "integer", "description": "Upper bound on how many unseen videos are processed per channel in one run (the RSS feed exposes at most 15). Videos over the cap stay unseen and are picked up by the next run.", "default": 5 }, "backfillCount": { "title": "Backfill count (first run per channel)", "minimum": 0, "maximum": 15, "type": "integer", "description": "How many of the most recent videos to process the very first time a channel is seen. Set 0 to only process uploads that appear after the first run.", "default": 3 }, "language": { "title": "Preferred transcript language", "type": "string", "description": "BCP-47 language code (e.g. `en`, `en-US`, `de`, `pt-BR`). Manual captions in this language are preferred, then auto-generated ones, then any available track.", "default": "en" }, "outputs": { "title": "Outputs to generate", "uniqueItems": true, "type": "array", "description": "Which parts of the repurposing bundle to produce. `blog`, `newsletter`, `thread` and `shortsHooks` require an OpenAI API key; `srt` is generated straight from the captions.", "items": { "type": "string", "enum": [ "blog", "newsletter", "thread", "shortsHooks", "srt" ], "enumTitles": [ "SEO blog draft", "Newsletter section", "X/LinkedIn thread", "Shorts hooks with timestamps", "SRT subtitle file" ] }, "default": [ "blog", "newsletter", "thread", "shortsHooks", "srt" ] }, "openaiApiKey": { "title": "OpenAI API key", "type": "string", "description": "Used for the AI repurposing bundle (one structured call per video). If omitted, the actor still produces transcripts and SRT files — you are only charged the transcription event." }, "model": { "title": "OpenAI model", "type": "string", "description": "Chat Completions model used for the bundle. `gpt-4o-mini` keeps the cost around $0.01 per video.", "default": "gpt-4o-mini" }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Proxy for YouTube requests. YouTube blocks some datacenter IPs, so Apify Proxy with the RESIDENTIAL group is recommended for reliable transcripts at scale." } } }, "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 } } } } } } } } } }