{ "openapi": "3.0.1", "info": { "title": "YouTube Channel & Shorts Scraper: Info, Videos, Likes", "description": "Scrape YouTube channels: subscribers, total views, join date, country, links, avatar and banner, plus every video, Short and live stream with exact views, likes, duration and publish date. Pay only for results you get.", "version": "1.0", "x-build-id": "OMfzz43MPNtZshyjJ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/t3data~youtube-channel/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-t3data-youtube-channel", "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/t3data~youtube-channel/runs": { "post": { "operationId": "runs-sync-t3data-youtube-channel", "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/t3data~youtube-channel/run-sync": { "post": { "operationId": "run-sync-t3data-youtube-channel", "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": [ "channels" ], "properties": { "channels": { "title": "YouTube channels", "type": "array", "description": "Channel URLs (youtube.com/@handle, /channel/UC…, /c/name, /user/name), bare @handles, or channel IDs (UC…).", "items": { "type": "string" } }, "includeChannelInfo": { "title": "Channel info", "type": "boolean", "description": "One row per channel: name, handle, subscribers, video count, total views, join date, country, description, links, avatar and banner. Counts as one result.", "default": true }, "maxVideos": { "title": "Max videos per channel", "minimum": 0, "maximum": 20000, "type": "integer", "description": "Long-form videos from the Videos tab. 0 = skip.", "default": 20 }, "maxShorts": { "title": "Max Shorts per channel", "minimum": 0, "maximum": 20000, "type": "integer", "description": "Shorts from the Shorts tab. 0 = skip.", "default": 20 }, "maxStreams": { "title": "Max live streams per channel", "minimum": 0, "maximum": 20000, "type": "integer", "description": "Past and current live streams from the Live tab. 0 = skip.", "default": 0 }, "sortBy": { "title": "Sort by", "enum": [ "latest", "popular", "oldest" ], "type": "string", "description": "Same as the sort buttons on the channel's Videos, Shorts and Live tabs.", "default": "latest" }, "publishedAfter": { "title": "Published after", "type": "string", "description": "Only videos published on or after this date (YYYY-MM-DD). With Latest sorting, listing stops at the first older video, so it stays fast." }, "includeVideoDetails": { "title": "Exact views, likes and dates", "type": "boolean", "description": "Fetch each video's exact view count, like count and publish date (one small extra request per video). Included in the price.", "default": true }, "maxConcurrency": { "title": "Parallel channels", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many channels to process at the same time.", "default": 10 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Residential proxy is strongly recommended — YouTube blocks datacenter IPs. Proxy cost is included in the price.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } } } } } } } } }