{ "openapi": "3.0.1", "info": { "title": "YouTube Transcripts for Channels & Playlists (RAG-ready)", "description": "Fetch YouTube transcripts by video, channel or playlist with no API key. Output timestamped segments, plain text, SRT, or overlapping chunks sized for embeddings. Monitor mode transcribes only newly published videos.", "version": "0.1", "x-build-id": "UDkblGkSFfcelmzLM" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/antndev~youtube-transcript-rag/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-antndev-youtube-transcript-rag", "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/antndev~youtube-transcript-rag/runs": { "post": { "operationId": "runs-sync-antndev-youtube-transcript-rag", "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/antndev~youtube-transcript-rag/run-sync": { "post": { "operationId": "run-sync-antndev-youtube-transcript-rag", "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": "Videos, channels or playlists", "type": "array", "description": "Mix freely: video URLs or 11-character IDs, channel URLs or @handles or UC ids, and playlist URLs or ids. Channels and playlists are expanded through YouTube's own public feeds.", "default": [ "https://www.youtube.com/@veritasium" ], "items": { "type": "string" } }, "maxVideosPerSource": { "title": "Max videos per channel/playlist", "minimum": 1, "maximum": 15, "type": "integer", "description": "How many of the most recent videos to take from each channel or playlist. Direct video inputs are never limited.", "default": 10 }, "outputFormat": { "title": "Output format", "enum": [ "chunks", "segments", "plain", "srt" ], "type": "string", "description": "chunks = overlapping timestamped chunks sized for embeddings (best for RAG); segments = raw timestamped lines; plain = one text field; srt = subtitle file content.", "default": "chunks" }, "chunkChars": { "title": "Chunk size (characters)", "minimum": 200, "maximum": 8000, "type": "integer", "description": "Target size per chunk when the output format is chunks. Roughly 1200 characters is a comfortable embedding window.", "default": 1200 }, "chunkOverlap": { "title": "Chunk overlap (characters)", "minimum": 0, "maximum": 2000, "type": "integer", "description": "How much text to repeat between consecutive chunks so sentences are not cut mid-thought.", "default": 150 }, "languages": { "title": "Preferred languages", "type": "array", "description": "Language codes in order of preference, for example en, de, fr. Manually created captions are preferred over auto-generated ones.", "default": [ "en" ], "items": { "type": "string" } }, "allowAutoGenerated": { "title": "Allow auto-generated captions", "type": "boolean", "description": "Most videos only have auto-generated captions. Turn this off to accept human-written captions only.", "default": true }, "translateTo": { "title": "Translate to (optional)", "type": "string", "description": "Language code to translate the transcript into, using YouTube's own translation of the track, for example en or de." }, "monitorMode": { "title": "Monitor mode (only new videos)", "type": "boolean", "description": "For scheduled runs: remembers which videos were already transcribed and processes only newly published ones.", "default": false }, "webhookUrl": { "title": "Webhook URL (optional)", "type": "string", "description": "POSTs the list of transcribed videos as JSON to this URL." }, "useApifyProxy": { "title": "Use Apify Proxy", "type": "boolean", "description": "Recommended. YouTube throttles transcript requests from datacenter addresses, so the run is routed through the Apify proxy.", "default": true }, "concurrency": { "title": "Videos in parallel", "minimum": 1, "maximum": 8, "type": "integer", "description": "How many transcripts to fetch at the same time.", "default": 4 } } }, "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 } } } } } } } } } }