{ "openapi": "3.0.1", "info": { "title": "YouTube Transcript Scraper", "description": "YouTube transcript scraper with no API key and no login. Get the full transcript, subtitles and timed caption segments for any video, channel or search, with human captions preferred over auto-generated ones. Monitor mode returns transcripts of new uploads on a channel.", "version": "0.1", "x-build-id": "yMoTXGsVgiVFOkpj4" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/datahamster~youtube-transcript-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-datahamster-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/datahamster~youtube-transcript-scraper/runs": { "post": { "operationId": "runs-sync-datahamster-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/datahamster~youtube-transcript-scraper/run-sync": { "post": { "operationId": "run-sync-datahamster-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": { "maxItems": { "title": "Max items", "minimum": 1, "type": "integer", "description": "Stop after this many transcript rows, e.g. 20. You are charged only for rows actually pushed to the dataset.", "default": 20 }, "mode": { "title": "Mode", "enum": [ "scrape", "monitor" ], "type": "string", "description": "\"scrape\" returns every matching row. \"monitor\" returns only rows that are new or whose transcript text changed since the previous run of the same saved task. Example: \"scrape\".", "default": "scrape" }, "monitorStateId": { "title": "Monitor state id", "type": "string", "description": "Optional state id when not running as a saved task (monitor mode)" }, "webhookUrl": { "title": "Webhook URL", "type": "string", "description": "Optional HTTPS URL that receives a POST with a JSON summary of the changes found in monitor mode, e.g. \"https://hooks.zapier.com/hooks/catch/123/abc\"." }, "telegramBotToken": { "title": "Telegram bot token", "type": "string", "description": "Optional Telegram bot token used to send monitor-mode change summaries, e.g. \"123456789:AAE...\". Leave empty to skip Telegram alerts." }, "telegramChatId": { "title": "Telegram chat id", "type": "string", "description": "Optional Telegram chat id that receives the monitor-mode summaries, e.g. \"-1001234567890\" for a channel or \"123456789\" for a direct chat." }, "videoUrls": { "title": "Video URLs", "type": "array", "description": "YouTube videos to transcribe, one per line: a watch URL \"https://www.youtube.com/watch?v=dQw4w9WgXcQ\", a \"https://youtu.be/dQw4w9WgXcQ\" link, a \"/shorts/\" link, or a bare 11-character id \"dQw4w9WgXcQ\".", "default": [], "items": { "type": "string" } }, "channels": { "title": "Channels", "type": "array", "description": "Channels whose latest videos should be transcribed, one per line, as a handle, a channel URL or a UC id, e.g. \"@NASA\", \"https://www.youtube.com/@NASA\" or \"UCLA_DiR1FfKNvjuUpBHmylQ\".", "items": { "type": "string" } }, "searches": { "title": "Search keywords", "type": "array", "description": "Keywords to search YouTube for, one per line, e.g. \"apify tutorial\". Every video on the first result page is transcribed.", "items": { "type": "string" } }, "languages": { "title": "Languages", "type": "array", "description": "Caption languages in preference order, one per line, e.g. \"en\" then \"de\". The first language the video actually publishes wins; \"en\" also matches \"en-GB\" and \"en-US\".", "default": [ "en" ], "items": { "type": "string" } }, "preferManual": { "title": "Prefer human-written captions", "type": "boolean", "description": "true = use the uploaded, human-written caption track before YouTube's auto-generated one in the same language. false = take whichever comes first. Example: true.", "default": true }, "includeAutoGenerated": { "title": "Allow auto-generated captions", "type": "boolean", "description": "true = accept YouTube's speech-recognition track when no human-written one exists (most videos only have this). false = human-written captions only, other videos are skipped and not charged. Example: true.", "default": true }, "fallbackAnyLanguage": { "title": "Fall back to any language", "type": "boolean", "description": "true = if none of your Languages exists, take whatever caption track the video does have. false = skip the video (no row, no charge). Example: false.", "default": false }, "maxVideosPerChannel": { "title": "Max videos per channel", "minimum": 1, "maximum": 500, "type": "integer", "description": "How many of the latest videos to take from each channel, e.g. 50. Range 1-500. Only used together with Channels.", "default": 50 }, "includeShorts": { "title": "Shorts instead of videos", "type": "boolean", "description": "true = list the channel's Shorts tab instead of its Videos tab. false = regular videos. Example: false.", "default": false }, "tier": { "title": "Proxy tier", "enum": [ "auto", "none", "datacenter", "residential" ], "type": "string", "description": "Which proxy rung to use. \"auto\" starts with no proxy and moves one rung up only when YouTube answers with its \"sign in to confirm you're not a bot\" wall, which keeps most runs free of proxy cost. \"none\", \"datacenter\" and \"residential\" pin one rung. Example: \"auto\".", "default": "auto" } } }, "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 } } } } } } } } } }