{ "openapi": "3.0.1", "info": { "title": "Youtube Scraper Fast", "description": "YouTube Scraper Fast extracts public YouTube data quickly, at scale. Scrape keywords or URLs (videos, Shorts, channels, playlists, hashtags, and results pages), use Deep Search for wider coverage, and get structured output for analytics and automation. Price: $0.40/1,000 videos.", "version": "0.0", "x-build-id": "kZkAnsuTBWQ9l9Boj" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/knowten~youtube-scraper-fast/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-knowten-youtube-scraper-fast", "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/knowten~youtube-scraper-fast/runs": { "post": { "operationId": "runs-sync-knowten-youtube-scraper-fast", "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/knowten~youtube-scraper-fast/run-sync": { "post": { "operationId": "run-sync-knowten-youtube-scraper-fast", "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": { "searchQueries": { "title": "Search queries", "type": "array", "description": "Search queries to run when startUrls is empty.", "items": { "type": "string" }, "default": [ "Crawlee" ] }, "startUrls": { "title": "Start URLs", "type": "array", "description": "Video, channel, playlist, hashtag, or search result URLs.", "default": [], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxResults": { "title": "Max results (videos)", "minimum": 0, "maximum": 999999, "type": "integer", "description": "Maximum number of regular videos to extract per query or supported listing URL. Set 0 to skip regular videos.", "default": 0 }, "maxResultsShorts": { "title": "Max results (shorts)", "minimum": 0, "maximum": 999999, "type": "integer", "description": "Maximum number of YouTube Shorts to extract per query or supported listing URL. Set 0 to skip shorts.", "default": 0 }, "maxResultStreams": { "title": "Max results (streams)", "minimum": 0, "maximum": 999999, "type": "integer", "description": "Maximum number of live or ended stream results to extract per query or supported listing URL. Set 0 to skip streams.", "default": 0 }, "downloadSubtitles": { "title": "Download subtitles", "type": "boolean", "description": "When enabled, downloads public subtitle tracks into the subtitles field whenever YouTube exposes them.", "default": false }, "saveSubsToKVS": { "title": "Save subtitles to KVS", "type": "boolean", "description": "When subtitle download is enabled, also saves subtitle files to the default key-value store and returns their storage URLs.", "default": false }, "subtitlesLanguage": { "title": "Subtitles language", "enum": [ "any", "en", "de", "es", "fr", "it", "ja", "ko", "nl", "pt", "ru" ], "type": "string", "description": "Preferred subtitle language code. Use any to accept the best available subtitle track.", "default": "en" }, "preferAutoGeneratedSubtitles": { "title": "Prefer auto-generated subtitles", "type": "boolean", "description": "Prefer auto-generated subtitle tracks over manual captions when both exist for the selected language.", "default": false }, "isDeepSearch": { "title": "Deep Search Mode", "type": "boolean", "description": "When enabled, automatically splits your search queries into multiple time-based segments (quarterly over the last 10 years) to bypass YouTube's internal 300-500 result limits. Use this to extract thousands of videos for broad queries.", "default": false }, "subtitlesFormat": { "title": "Subtitles format", "enum": [ "srt", "vtt", "xml", "plaintext" ], "type": "string", "description": "Subtitle format to return in the subtitles field.", "default": "srt" }, "sortingOrder": { "title": "Prioritize", "enum": [ "relevance", "popularity" ], "type": "string", "description": "Single-select priority for search queries.", "default": "relevance" }, "dateFilter": { "title": "Upload date", "enum": [ "today", "week", "month", "year" ], "type": "string", "description": "Single-select upload date filter for search queries." }, "lengthFilter": { "title": "Duration", "enum": [ "under3", "between320", "over20" ], "type": "string", "description": "Single-select duration filter for search queries." }, "oldestPostDate": { "title": "Oldest post date", "type": "string", "description": "Applies to channel tabs only. Accepts absolute dates or relative intervals like 30 days." }, "sortVideosBy": { "title": "Sort channel videos by", "enum": [ "NEWEST", "POPULAR", "OLDEST" ], "type": "string", "description": "Sorting applied when extracting videos from channel tabs." }, "isLive": { "title": "Only live", "type": "boolean", "description": "Keeps only live content in search results when possible." }, "is4K": { "title": "Only 4K", "type": "boolean", "description": "Keeps only 4K videos in search results when possible." }, "isHD": { "title": "Only HD", "type": "boolean", "description": "Keeps only HD videos in search results when possible." }, "is360": { "title": "Only 360°", "type": "boolean", "description": "Keeps only 360° videos in search results when possible." }, "isVR180": { "title": "Only VR180", "type": "boolean", "description": "Keeps only VR180 videos in search results when possible." }, "is3D": { "title": "Only 3D", "type": "boolean", "description": "Keeps only 3D videos in search results when possible." }, "isCreativeCommons": { "title": "Creative Commons", "type": "boolean", "description": "Keeps only Creative Commons videos in search results when possible." }, "hasSubtitles": { "title": "Subtitles / CC", "type": "boolean", "description": "Keeps only results that expose subtitles or closed captions in search filters when possible." }, "isHDR": { "title": "Only HDR", "type": "boolean", "description": "Keeps only HDR videos in search results when possible." }, "hasLocation": { "title": "Has location", "type": "boolean", "description": "Keeps only videos with location metadata in search results when possible." } } }, "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 } } } } } } } } } }