{ "openapi": "3.0.1", "info": { "title": "YouTube Transcripts in Bulk: Channels, Playlists & Videos", "description": "Get clean transcripts for a whole YouTube channel or playlist (up to 1,000 videos per source) or for single videos. Full text, paragraphs and optional timestamps, one dataset row per video. Uses your BulkTranscripts API key: 30 free transcripts, then packs from $4.99.", "version": "0.0", "x-build-id": "MEsifEt18ut6UUZbr" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/bulktranscripts~youtube-transcripts-bulk/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-bulktranscripts-youtube-transcripts-bulk", "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/bulktranscripts~youtube-transcripts-bulk/runs": { "post": { "operationId": "runs-sync-bulktranscripts-youtube-transcripts-bulk", "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/bulktranscripts~youtube-transcripts-bulk/run-sync": { "post": { "operationId": "run-sync-bulktranscripts-youtube-transcripts-bulk", "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": [ "urls" ], "properties": { "urls": { "title": "YouTube URLs", "type": "array", "description": "Videos, playlists or channels, one per line. Channel links can be @handles (https://www.youtube.com/@TED), /channel/ IDs or old /c/ and /user/ links. Playlists must be public or unlisted.", "items": { "type": "string" } }, "apiKey": { "title": "BulkTranscripts API key", "type": "string", "description": "Needed for your own videos, playlists and channels. Sign in at https://bulktranscripts.co/app?tab=mcp and create a key in under a minute: new accounts get 30 free transcripts. A license key from a credit pack also works. Leave it empty to try the example video for free." }, "maxVideos": { "title": "Max videos per channel or playlist", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Newest videos first for channels. Each new transcript uses one BulkTranscripts credit; videos already in your library are free.", "default": 50 }, "channelContent": { "title": "Channel content", "enum": [ "videos", "shorts", "live" ], "type": "string", "description": "Which tab of a channel to read: regular Videos, Shorts, or Live (past live streams). Ignored for playlists and single videos.", "default": "videos" }, "startAt": { "title": "Start at video #", "minimum": 1, "maximum": 100000, "type": "integer", "description": "1 is the newest video. For channels with more than 1,000 videos, run in blocks: 1, then 1001, then 2001. Videos you already have are free.", "default": 1 }, "language": { "title": "Preferred caption language", "type": "string", "description": "Language code such as en, es, de or pt. If a video has no captions in this language, its available captions are used.", "default": "en" }, "includeSegments": { "title": "Include timestamped segments", "type": "boolean", "description": "Adds a segments array (start time, duration, text) to every row. Leave off if you only need the text.", "default": false } } }, "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 } } } } } } } } } }