{ "openapi": "3.0.1", "info": { "title": "YouTube Channel Transcripts - Whole Channel or Playlist to Text", "description": "Every video of a YouTube channel or playlist with title, views, duration, date and the full transcript, one row per video. Incremental (remembers delivered videos), language fallback, translation, no browser, charged only per transcript delivered.", "version": "0.1", "x-build-id": "eQAoNCp8A3SPZqsHL" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/leekung125~youtube-channel-transcripts/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-leekung125-youtube-channel-transcripts", "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/leekung125~youtube-channel-transcripts/runs": { "post": { "operationId": "runs-sync-leekung125-youtube-channel-transcripts", "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/leekung125~youtube-channel-transcripts/run-sync": { "post": { "operationId": "run-sync-leekung125-youtube-channel-transcripts", "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": [ "sources" ], "properties": { "sources": { "title": "Channels or playlists", "type": "array", "description": "Channels, @handles, channel ids, playlists - or a search, written as \"search: your query\". A search returns the top results for that query, with transcripts, obeying the same per-source limit as everything else.", "default": [ "@Apify" ], "items": { "type": "string" } }, "maxVideosPerSource": { "title": "Max videos per source", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Newest first.", "default": 50 }, "minViews": { "title": "Minimum views", "minimum": 0, "type": "integer", "description": "Skip videos with fewer views. 0 = no filter.", "default": 0 }, "minDurationSeconds": { "title": "Minimum duration (s)", "minimum": 0, "type": "integer", "description": "e.g. 61 to skip Shorts. 0 = no filter.", "default": 0 }, "maxDurationSeconds": { "title": "Maximum duration (s)", "minimum": 0, "type": "integer", "description": "e.g. 60 for Shorts only. 0 = no filter.", "default": 0 }, "skipAlreadyDone": { "title": "Skip videos delivered in earlier runs", "type": "boolean", "description": "Remembers delivered video ids per source, so scheduled runs only pay for new uploads.", "default": true }, "languages": { "title": "Preferred languages", "type": "array", "description": "Language codes in order of preference.", "default": [ "en" ], "items": { "type": "string" } }, "allowAutoGenerated": { "title": "Allow auto-generated captions", "type": "boolean", "description": "If no manually created transcript exists in your languages, use YouTube's automatic captions.", "default": true }, "translateTo": { "title": "Translate to", "type": "string", "description": "Optional language code.", "default": "" }, "includeSegments": { "title": "Include timestamped segments", "type": "boolean", "description": "Adds a segments array to every row (larger output).", "default": false }, "concurrency": { "title": "Concurrency", "minimum": 1, "maximum": 20, "type": "integer", "description": "Videos processed in parallel (1-20).", "default": 5 }, "maxRetries": { "title": "Max retries per video", "minimum": 1, "maximum": 10, "type": "integer", "description": "Fresh proxy sessions to try when YouTube blocks a request; a video that fails every attempt is reported as blocked and not charged.", "default": 4 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "YouTube blocks datacenter IPs for transcripts; Apify residential proxies recommended.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } } } } } } } } }