{ "openapi": "3.0.1", "info": { "title": "YouTube Transcript Scraper - $1/1k, Channels & Playlists", "description": "$1 per 1,000 transcripts. Returns YouTube transcripts in bulk from video URLs, channels, playlists and YouTube search: full text for AI/LLMs, timestamped segments, SRT, VTT, language, plus title, channel, views and duration. Any language. Videos without captions are never charged.", "version": "0.1", "x-build-id": "NWQPMdETBpRKb2xI8" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/smolder~youtube-transcript-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-smolder-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/smolder~youtube-transcript-scraper/runs": { "post": { "operationId": "runs-sync-smolder-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/smolder~youtube-transcript-scraper/run-sync": { "post": { "operationId": "run-sync-smolder-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", "properties": { "videos": { "title": "Video URLs", "type": "array", "description": "YouTube video links or IDs. Normal videos, Shorts, youtu.be links, embeds and live replays all work. Up to 10,000 videos per run (see Maximum videos in total).", "items": { "type": "string" } }, "searchQueries": { "title": "YouTube searches", "type": "array", "description": "Search YouTube and transcribe the matching videos, for example \"best budget laptop 2026\". Uses YouTube's own ranking.", "items": { "type": "string" } }, "channels": { "title": "Channels", "type": "array", "description": "Transcribe a channel's latest videos (newest first). Use an @handle, a channel URL or a channel ID, for example \"@mkbhd\".", "items": { "type": "string" } }, "playlists": { "title": "Playlists", "type": "array", "description": "Transcribe the videos of a playlist, in playlist order. Use a playlist URL or ID.", "items": { "type": "string" } }, "maxVideosPerSource": { "title": "Videos per search, channel or playlist", "minimum": 1, "maximum": 5000, "type": "integer", "description": "How many videos to take from each search, channel and playlist.", "default": 20 }, "maxVideos": { "title": "Maximum videos in total", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Safety cap on the number of videos processed in one run, across all inputs.", "default": 100 }, "languages": { "title": "Preferred languages", "type": "array", "description": "Language codes in order of preference, for example [\"en\", \"fr\", \"ar\"]. The first language that has captions wins; \"en\" also matches en-US, en-GB and so on. Leave empty to get each video in its original spoken language.", "default": [], "items": { "type": "string" } }, "fallbackToAnyLanguage": { "title": "Fall back to the original language", "type": "boolean", "description": "If none of your preferred languages exists for a video, return the transcript in its original spoken language (or, if that has no captions, the best available language) instead of skipping the video. The output field matchedPreferredLanguage tells you which happened.", "default": true }, "transcriptType": { "title": "Caption type", "enum": [ "any", "manual", "auto" ], "type": "string", "description": "Human-made captions are usually more accurate; auto-generated ones exist for most videos. \"Best available\" prefers human-made captions and falls back to auto-generated ones.", "default": "any" }, "outputFormats": { "title": "Extra output formats", "type": "array", "description": "The full transcript text is always included. Add timestamped segments (start, duration, text), SRT subtitles or WebVTT subtitles as needed.", "items": { "type": "string", "enum": [ "segments", "srt", "vtt" ], "enumTitles": [ "Timestamped segments", "SRT subtitles", "WebVTT subtitles" ] }, "default": [ "segments" ] }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Leave the default: the scraper uses Apify's datacenter proxies and automatically switches to residential proxies when YouTube shows its bot check. Only change this if you want to force a specific proxy.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }