{ "openapi": "3.0.1", "info": { "title": "YouTube Transcript Extractor: Timed Captions", "description": "Extracts timed captions from YouTube videos through the ANDROID player endpoint behind rotating residential proxies. Returns manual or auto-generated tracks with start times, language, full text and video details, and retries bot checks on a new IP for every video.", "version": "1.0", "x-build-id": "qHl9oPEf2oZ3czPef" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/luochengfengqi~youtube-transcript-extractor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-luochengfengqi-youtube-transcript-extractor", "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/luochengfengqi~youtube-transcript-extractor/runs": { "post": { "operationId": "runs-sync-luochengfengqi-youtube-transcript-extractor", "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/luochengfengqi~youtube-transcript-extractor/run-sync": { "post": { "operationId": "run-sync-luochengfengqi-youtube-transcript-extractor", "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": [ "videos" ], "properties": { "videos": { "title": "Videos", "type": "array", "description": "YouTube video URLs or 11-character video IDs, one per entry. Accepted URL forms: watch?v=, youtu.be, /shorts/, /embed/, /live/ and music.youtube.com. Playlists, channels and search URLs are not supported and produce an INVALID_INPUT record. Duplicate videos are skipped.", "default": [ "dQw4w9WgXcQ", "UF8uR6Z6KLc", "iG9CE55wbtY" ], "items": { "type": "string" } }, "languages": { "title": "Preferred Languages", "type": "array", "description": "Language codes in order of preference, for example 'en', 'de' or 'pt-BR'. A base code such as 'es' also matches regional tracks such as 'es-419', and an exact code wins over a regional variant. Matching is case-insensitive.", "default": [ "en" ], "items": { "type": "string" } }, "fallbackToAnyLanguage": { "title": "Fall Back to Any Language", "type": "boolean", "description": "When none of the preferred languages exists, return the first available track instead of a NO_CAPTIONS record. The language field of the record shows which track was returned.", "default": true }, "includeAutoGenerated": { "title": "Include Auto-Generated Captions", "type": "boolean", "description": "Allow tracks that YouTube generated by speech recognition. When disabled, videos that only have auto-generated captions return a NO_CAPTIONS record.", "default": true }, "preferManualCaptions": { "title": "Prefer Manual Captions", "type": "boolean", "description": "When both a manual and an auto-generated track exist for the same language, return the manual one. Disable it to take the auto-generated track in that case.", "default": true }, "includeSegments": { "title": "Include Timed Segments", "type": "boolean", "description": "Add the 'segments' array with start time, duration and text of every caption line. When disabled, only the joined 'text' and the statistics are returned, which keeps the dataset smaller.", "default": true }, "maxConcurrency": { "title": "Max Concurrent Videos", "minimum": 1, "maximum": 20, "type": "integer", "description": "Maximum number of videos processed at the same time (1 to 20). Every video uses its own residential proxy session.", "default": 5 }, "maxAttempts": { "title": "Max Attempts per Video", "minimum": 1, "maximum": 5, "type": "integer", "description": "How many times a video is tried before it is reported as BLOCKED or ERROR (1 to 5). Every attempt uses a new residential IP. Only successful transcripts are charged, so extra attempts cost proxy traffic but no events.", "default": 3 }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Residential proxies are required. In testing, direct and datacenter connections were answered with a bot check for most videos, while residential IPs passed within three attempts. Keep the RESIDENTIAL group selected.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } } } }, "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 } } } } } } } } } }