{ "openapi": "3.0.1", "info": { "title": "YouTube Video Subtitles Scraper: Caption Coverage Insights Data", "description": "YouTube Video Subtitles Scraper: This tool extracts YouTube subtitles and caption coverage insights, including video titles, transcripts, languages, caption availability, timestamps, channels, and metadata. Ideal for content research, accessibility analysis, SEO, and multilingual insights.", "version": "0.1", "x-build-id": "wPfAowahJKWHaJoy9" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapio~youtube-video-subtitles-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapio-youtube-video-subtitles-scraper", "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/scrapio~youtube-video-subtitles-scraper/runs": { "post": { "operationId": "runs-sync-scrapio-youtube-video-subtitles-scraper", "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/scrapio~youtube-video-subtitles-scraper/run-sync": { "post": { "operationId": "run-sync-scrapio-youtube-video-subtitles-scraper", "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", "properties": { "videosToCheck": { "title": "🎯 YouTube Video URLs To Audit", "type": "array", "description": "One YouTube video URL per line, for example https://www.youtube.com/watch?v=VIDEO_ID, https://youtu.be/VIDEO_ID or a /shorts/ link. Channel or username input is not supported here.", "items": { "type": "string" } }, "startUrls": { "title": "🔗 Video URLs (legacy field)", "type": "array", "description": "Kept so input built for the base YouTube Video Subtitles Scraper keeps working unchanged. Used only when 'YouTube Video URLs To Audit' above is left empty.", "items": { "type": "string" } }, "requiredLanguages": { "title": "🌍 Required Language Codes", "type": "array", "description": "One YouTube caption language code per line, for example en, es, fr, de-DE, pt-BR. Each video's row reports, per code, whether captions exist as manual, auto-generated, or unavailable. Leave empty to skip the coverage check and only fetch the primary-language transcript below.", "items": { "type": "string" } }, "preferManualOverAuto": { "title": "✅ Prefer Manual Captions When Both Exist", "type": "boolean", "description": "When the primary transcript language (below) has both a manual and an auto-generated caption track, this decides which one is fetched: ON fetches the manual track, OFF fetches the auto-generated one. Has no effect when only one type exists. Default is ON." }, "language": { "title": "🎙️ Primary Transcript Language (legacy field)", "type": "string", "description": "The single language the full transcript is fetched for. This Actor never fetches full transcript text in more than one language per video - use Required Language Codes above to check availability across many languages without fetching them all. Leave empty to use the first entry in Required Language Codes, or 'en' if that is also empty." }, "includeFullInventory": { "title": "📋 Include Full Language Inventory", "type": "boolean", "description": "When ON, every manual and auto-generated language code found on the video is listed (a well-captioned video can carry dozens of auto-generated codes). When OFF, only the coverage result for your Required Language Codes is returned, keeping rows compact. Default is ON." }, "maxWorkers": { "title": "⚙️ Maximum Concurrent Videos (legacy field)", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many videos are audited in parallel (1-10). Higher values finish a large batch faster. Default is 4." }, "proxyConfiguration": { "title": "🛡️ Proxy Configuration", "type": "object", "description": "Leave on the default settings for normal use. Configure a proxy for better reliability on larger batches." } } }, "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 } } } } } } } } } }