{ "openapi": "3.0.1", "info": { "title": "YouTube Scraper: Video, Channel, Playlist & Search (No API Key)", "description": "Scrape YouTube videos, channels, playlists and search results without the YouTube API or an API key. Get exact view and like counts, subscribers, duration, tags, category, publish date, thumbnails, chapters and hashtags. Sort and filter search. No key, no quota. Export JSON, CSV, Excel.", "version": "0.1", "x-build-id": "rfgs0K19SuVAmY2Se" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapers_lat~youtube-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapers_lat-youtube-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/scrapers_lat~youtube-scraper/runs": { "post": { "operationId": "runs-sync-scrapers_lat-youtube-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/scrapers_lat~youtube-scraper/run-sync": { "post": { "operationId": "run-sync-scrapers_lat-youtube-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": { "maxVideos": { "title": "Max videos", "minimum": 1, "type": "integer", "description": "Maximum number of videos to return across all inputs.", "default": 10 }, "searchQueries": { "title": "Search queries", "type": "array", "description": "Keywords to search YouTube for. Each query returns matching videos.", "items": { "type": "string" } }, "videoUrls": { "title": "Video URLs", "type": "array", "description": "YouTube video URLs or IDs to fetch full details for (https://www.youtube.com/watch?v=..., https://youtu.be/...).", "items": { "type": "string" } }, "channelUrls": { "title": "Channel URLs or handles", "type": "array", "description": "YouTube channel URLs or handles to pull recent videos from (https://www.youtube.com/@handle, /channel/UC..., /c/name).", "items": { "type": "string" } }, "playlistUrls": { "title": "Playlist URLs", "type": "array", "description": "YouTube playlist URLs or playlist IDs to pull videos from (https://www.youtube.com/playlist?list=PL..., or a bare PL... id).", "items": { "type": "string" } }, "sortBy": { "title": "Sort search results by", "enum": [ "relevance", "date", "views", "rating" ], "type": "string", "description": "Order for search results (applies to searchQueries only).", "default": "relevance" }, "uploadDate": { "title": "Upload date filter", "enum": [ "any", "hour", "today", "week", "month", "year" ], "type": "string", "description": "Only return videos uploaded within this window (search only).", "default": "any" }, "duration": { "title": "Duration filter", "enum": [ "any", "short", "medium", "long" ], "type": "string", "description": "Only return videos of this length (search only).", "default": "any" }, "videoType": { "title": "Result type filter", "enum": [ "any", "video", "channel", "playlist", "movie" ], "type": "string", "description": "Restrict search results to a single type (search only).", "default": "any" }, "enrichDetails": { "title": "Enrich with full details (paid add-on)", "type": "boolean", "description": "Fetch each video's full detail record: exact like and view counts, tags/keywords, category, duration in seconds, exact publish and upload dates, channel handle, subscriber count, hashtags, chapters, and Shorts/Live flags. Adds a paid 'details' event per enriched video (paying accounts only). Turn off for the fastest, cards-only run.", "default": true }, "country": { "title": "Country", "type": "string", "description": "Two-letter country code for results (gl).", "default": "US" }, "language": { "title": "Language", "type": "string", "description": "Interface language code (hl).", "default": "en" } } }, "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 } } } } } } } } } }