YouTube Scraper API — Videos, Transcripts, Comments & Channels
Pricing
from $2.00 / 1,000 video results
YouTube scraper and unofficial YouTube Data API — no key, no quotas: extract video details, channel profiles, search results, Shorts, comments and replies, transcripts/subtitles and playlists. Auto-extracts emails and social links from channels. Export JSON, CSV, Excel. From $2/1k videos.
You can access the YouTube Scraper API — Videos, Transcripts, Comments & Channels programmatically from your own applications by using the Apify API. You can also choose the language preference from below. To use the Apify API, you’ll need an Apify account and your API token, found in API & Integrations in Apify Console.
{ "openapi": "3.0.1", "info": { "version": "1.0", "x-build-id": "YHRUUO1Rdsr0hfk6C" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/pro100chok~youtube-scraper-all-in-one/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-pro100chok-youtube-scraper-all-in-one", "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/pro100chok~youtube-scraper-all-in-one/runs": { "post": { "operationId": "runs-sync-pro100chok-youtube-scraper-all-in-one", "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/pro100chok~youtube-scraper-all-in-one/run-sync": { "post": { "operationId": "run-sync-pro100chok-youtube-scraper-all-in-one", "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": [ "searchType" ], "properties": { "searchType": { "title": "🎯 Search Type", "enum": [ "video", "channel", "search", "shorts", "comments", "transcript", "playlist" ], "type": "string", "description": "What do you want to scrape? Each type uses the matching section below.", "default": "video" }, "startUrls": { "title": "🔗 YouTube URLs", "type": "array", "description": "Video, channel, playlist or shorts URLs (depending on Search Type). For Video/Comments/Transcript use video URLs; for Channel/Shorts use channel URLs; for Playlist use playlist URLs.", "items": { "type": "string" } }, "searchQueries": { "title": "🔎 Search queries", "type": "array", "description": "Keywords to search on YouTube (used when Search Type = Search).", "items": { "type": "string" } }, "youtubeHandles": { "title": "👤 Channel handles", "type": "array", "description": "Channel @handles or names (e.g. @MrBeast). Used for Channel / Shorts types.", "items": { "type": "string" } }, "maxItems": { "title": "🔢 Max items (total output)", "minimum": 0, "type": "integer", "description": "Global hard cap on the total number of output records for the whole run, across every type (videos, shorts, streams, channel info, comments, etc.). 0 = no global limit. For Channel mode the channel-info record counts toward this cap, while the per-type caps below control how many videos/shorts/streams are fetched.", "default": 0 }, "sort": { "title": "↕️ Sort by", "enum": [ "relevance", "date", "views", "rating" ], "type": "string", "description": "Result ordering for search.", "default": "relevance" }, "uploadDate": { "title": "📅 Upload date", "enum": [ "all", "hour", "today", "week", "month", "year" ], "type": "string", "description": "Filter search results by how recently the video was uploaded.", "default": "all" }, "videoDuration": { "title": "⏱️ Duration", "enum": [ "all", "short", "medium", "long" ], "type": "string", "description": "Filter search results by video length.", "default": "all" }, "videoType": { "title": "🎞️ Result type", "enum": [ "all", "video", "channel", "playlist", "movie" ], "type": "string", "description": "Restrict search results to a single entity type.", "default": "all" }, "features": { "title": "✨ Feature filters", "type": "array", "description": "Only return videos with these features (search only).", "items": { "type": "string", "enum": [ "hd", "4k", "subtitles", "cc", "live", "3d", "360", "hdr", "vr180", "location", "purchased", "creativeCommons" ], "enumTitles": [ "HD", "4K", "Subtitles/CC", "Closed captions", "Live", "3D", "360°", "HDR", "VR180", "Location", "Purchased", "Creative Commons" ] }, "default": [] }, "maxResults": { "title": "🎥 Max videos per channel", "minimum": 0, "type": "integer", "description": "Max long-form videos per channel (0 = skip videos, channel info only).", "default": 30 }, "maxResultsShorts": { "title": "⚡ Max Shorts per channel", "minimum": 0, "type": "integer", "description": "Max Shorts per channel (used for Channel & Shorts types).", "default": 0 }, "maxResultStreams": { "title": "📡 Max live streams per channel", "minimum": 0, "type": "integer", "description": "Max past/active streams per channel.", "default": 0 }, "includePlaylists": { "title": "🎶 Include channel playlists", "type": "boolean", "description": "Also scrape the channel's playlists tab.", "default": false }, "oldestPostDate": { "title": "🗓️ Oldest post date", "type": "string", "description": "Only keep content newer than this. Absolute (2024-01-01) or relative (e.g. \"100 days\", \"3 weeks\").", "default": "" }, "maxComments": { "title": "💬 Max comments per video", "minimum": 0, "type": "integer", "description": "Limit of comments (incl. replies) per video (0 = all).", "default": 100 }, "commentsSort": { "title": "↕️ Comments sort", "enum": [ "top", "newest" ], "type": "string", "description": "Order comments by top (most liked) or newest first.", "default": "top" }, "includeReplies": { "title": "↪️ Include replies", "type": "boolean", "description": "Fetch replies to top-level comments.", "default": true }, "downloadSubtitles": { "title": "📝 Download subtitles with videos", "type": "boolean", "description": "Attach a transcript to every scraped video (Video/Search/Channel types).", "default": false }, "subtitlesLanguage": { "title": "🌍 Subtitle language", "type": "string", "description": "Preferred caption language code (e.g. en, es, ru).", "default": "en" }, "subtitlesFormat": { "title": "📄 Subtitle format", "enum": [ "srt", "vtt", "xml", "plaintext" ], "type": "string", "description": "Output format for transcripts/subtitles.", "default": "srt" }, "preferAutoGeneratedSubtitles": { "title": "🤖 Prefer auto-generated", "type": "boolean", "description": "Prefer auto-generated captions over manual ones.", "default": false }, "saveSubsToKVS": { "title": "💾 Save subtitle files to key-value store", "type": "boolean", "description": "Persist each subtitle file as a key in the key-value store.", "default": false }, "gl": { "title": "🌐 Country (gl)", "type": "string", "description": "Geo/country code for results (e.g. us, gb, de).", "default": "US" }, "hl": { "title": "🗣️ Language (hl)", "type": "string", "description": "UI/result language code (e.g. en, es, ru).", "default": "en" }, "proxyConfiguration": { "title": "🛡️ Proxy configuration", "type": "object", "description": "Proxy used for requests. Residential US is recommended.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } }, "customProxyUrl": { "title": "🔌 Custom proxy URL", "type": "string", "description": "Optional custom HTTP proxy (http://user:pass@host:port). Falls back to Apify proxy on failure.", "default": "" }, "maxRetries": { "title": "🔁 Max retries", "minimum": 1, "maximum": 15, "type": "integer", "description": "Retries per request on connection errors.", "default": 5 } } }, "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 } } } } } } } } }}OpenAPI is a standard for designing and describing RESTful APIs, allowing developers to define API structure, endpoints, and data formats in a machine-readable way. It simplifies API development, integration, and documentation.
OpenAPI is effective when used with AI agents and GPTs by standardizing how these systems interact with various APIs, for reliable integrations and efficient communication.
By defining machine-readable API specifications, OpenAPI allows AI models like GPTs to understand and use varied data sources, improving accuracy. This accelerates development, reduces errors, and provides context-aware responses, making OpenAPI a core component for AI applications.
You can download the OpenAPI definitions for YouTube Scraper API — Videos, Transcripts, Comments & Channels from the options below:
If you’d like to learn more about how OpenAPI powers GPTs, read our blog post.
You can also check out our other API clients:
YouTube Scraper API — Videos, Transcripts, Comments & Channels API in Python
YouTube Scraper API — Videos, Transcripts, Comments & Channels API in JavaScript
YouTube Scraper API — Videos, Transcripts, Comments & Channels API through CLI
YouTube Scraper API — Videos, Transcripts, Comments & Channels API