{ "openapi": "3.0.1", "info": { "title": "YouTube Transcript Scraper — Pay Per Result, No Empty Charges", "description": "Extract transcripts/subtitles from YouTube videos in bulk. Paste URLs or IDs — get clean text, timestamped segments, SRT/VTT subtitle files, and video metadata (title, channel, views). Pay per result — videos without captions are never billed.", "version": "0.1", "x-build-id": "xR6ayQvF1pm0CEOQc" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/greza~youtube-transcript-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-greza-youtube-transcript-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/greza~youtube-transcript-scraper/runs": { "post": { "operationId": "runs-sync-greza-youtube-transcript-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/greza~youtube-transcript-scraper/run-sync": { "post": { "operationId": "run-sync-greza-youtube-transcript-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", "required": [ "videoUrls" ], "properties": { "mode": { "title": "What to get", "enum": [ "transcripts", "listVideos" ], "type": "string", "description": "Transcripts of specific videos — paste video links/IDs below and get transcripts (up to 500 per run). List all videos of a channel or playlist — paste ONE channel or playlist link below and get every video's ID, URL, title and duration (cheap, no transcripts). Tip: use listing first to preview a channel, then run Transcripts on the IDs you want.", "default": "transcripts" }, "videoUrls": { "title": "YouTube videos, channel or playlist", "minItems": 1, "type": "array", "description": "Transcripts mode: one video per line — full YouTube links or 11-character IDs (watch, youtu.be, Shorts, embed, live), max 500 per run. Anything unreadable is skipped and listed in OUTPUT, never charged. List-videos mode: put EXACTLY ONE channel or playlist reference here — a channel link (youtube.com/@handle or /channel/UC…), a playlist link (youtube.com/playlist?list=…), or a bare playlist/UC id.", "items": { "type": "string" } }, "language": { "title": "Preferred language", "type": "string", "description": "Transcripts mode only (ignored when listing videos). Language code of the transcript you want, e.g. `en` (English), `es` (Spanish), `pt-BR` (Brazilian Portuguese). Leave this EMPTY if you're not sure — we'll return the video's default transcript. If the exact language isn't available, by default we fall back to whatever the video has (see 'Fail if language is missing' below to change that).", "default": "" }, "strictLanguage": { "title": "Fail if language is missing", "type": "boolean", "description": "Transcripts mode only (ignored when listing videos). Only matters when you set a Preferred language above. Off (default): if that language isn't available, we return another available transcript so you still get data. On: the video is skipped (reported as LANG_NOT_FOUND) instead of falling back. Keep this OFF unless you strictly need one exact language.", "default": false }, "subtitleFormat": { "title": "Subtitle file format", "enum": [ "none", "srt", "vtt", "both" ], "type": "string", "description": "Transcripts mode only (ignored when listing videos). Add ready-to-use subtitle file content (SRT/VTT) to each result. None (default): only the plain text and timestamped segments. SRT / VTT: also include that subtitle file as a text field. Both: include SRT and VTT. This does not change pricing — you are still charged one result per video.", "default": "none" } } }, "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 } } } } } } } } } }