{ "openapi": "3.0.1", "info": { "title": "YouTube Scraper: Search, Channels, Playlists & Videos", "description": "Scrape YouTube search results, channels, playlists and individual videos in one run. Title, views, likes, duration, publish date, description, tags, channel stats and thumbnails. No API key, no daily quota, no OAuth — unlike the official Data API.", "version": "0.0", "x-build-id": "W4eVF6UjYjgT45xtq" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/arman-bd~youtube-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-arman-bd-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/arman-bd~youtube-scraper/runs": { "post": { "operationId": "runs-sync-arman-bd-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/arman-bd~youtube-scraper/run-sync": { "post": { "operationId": "run-sync-arman-bd-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": { "searchQueries": { "title": "Search queries", "type": "array", "description": "Search terms, exactly as you would type them into YouTube's search bar. Each term is searched independently, so two terms cost roughly twice one.", "items": { "type": "string" } }, "startUrls": { "title": "Start URLs", "type": "array", "description": "Video, channel, playlist or @handle URLs. The type is detected per URL, so you can mix them freely. Bare IDs and youtu.be links work too.", "items": { "type": "string" } }, "maxResultsPerInput": { "title": "Max results per input", "minimum": 1, "maximum": 2000, "type": "integer", "description": "Cap on the total records returned for each query or URL, counting every result type together. A channel with 4,000 uploads is paginated, so this is the main cost control since charging is per record.", "default": 50 }, "resultTypes": { "title": "Result types", "type": "array", "description": "Which kinds of result to keep. A search returns videos, channels and playlists together; a channel URL can yield its videos, its shorts, its playlists, or a record for the channel itself.", "items": { "type": "string", "enum": [ "video", "short", "channel", "playlist" ], "enumTitles": [ "Videos", "Shorts", "Channels", "Playlists" ] }, "default": [ "video" ] }, "sortBy": { "title": "Sort by", "enum": [ "relevance", "date", "views", "rating" ], "type": "string", "description": "How YouTube should order search results. Applies to search terms only; a channel or playlist is always returned in its own order.", "default": "relevance" }, "uploadedAfter": { "title": "Uploaded after", "type": "string", "description": "Keep only videos published after this point. Takes a date such as 2026-01-15 or a window such as '30 days'. Applied as YouTube's own coarse filter first, then exactly on each record's publish date." }, "videoDuration": { "title": "Video duration", "enum": [ "any", "short", "medium", "long" ], "type": "string", "description": "Restrict search results by length: short is under 4 minutes, medium 4 to 20, long over 20. Search terms only.", "default": "any" }, "videoFeatures": { "title": "Video features", "type": "array", "description": "Restrict search results to videos carrying all of these features. Combined with AND, the way YouTube's own filter chips combine. Search terms only.", "items": { "type": "string", "enum": [ "hd", "4k", "subtitles", "creativeCommons", "live", "360", "hdr" ], "enumTitles": [ "HD", "4K", "Subtitles / CC", "Creative Commons", "Live", "360°", "HDR" ] }, "default": [] }, "includeVideoDetails": { "title": "Include video details", "type": "boolean", "description": "Fetch each video's own record for exact view and like counts, the full description, tags, category and an exact publish date. Turn it off for a faster, coarser run: counts become YouTube's rounded display figures and the publish date is null.", "default": true }, "country": { "title": "Country", "type": "string", "description": "Two-letter ISO 3166-1 country code. Changes which results rank, the way browsing YouTube from that country would.", "default": "US" }, "language": { "title": "Language", "type": "string", "description": "Two-letter ISO 639-1 language code. Changes the interface strings YouTube returns, and with them the wording of relative dates such as '4 years ago'.", "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 } } } } } } } } } }