{ "openapi": "3.0.1", "info": { "title": "YouTube Channel Scraper", "description": "Scrape public YouTube channel profiles and recent video listings by URL, channel ID, or @handle. Returns subscribers, views, links, country, tags, and videos. No cookies required. MCP-ready.", "version": "0.1", "x-build-id": "dwCziMz2UotcUnw04" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/khadinakbar~youtube-channel-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-khadinakbar-youtube-channel-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/khadinakbar~youtube-channel-scraper/runs": { "post": { "operationId": "runs-sync-khadinakbar-youtube-channel-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/khadinakbar~youtube-channel-scraper/run-sync": { "post": { "operationId": "run-sync-khadinakbar-youtube-channel-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", "required": [ "channelUrls" ], "properties": { "channelUrls": { "title": "Channel URLs or handles", "type": "array", "description": "Use this when you know the YouTube channels to inspect. Accepts full URLs, @handles, /channel IDs, or bare handles such as @Apify. Defaults to one small Apify channel test. Not for keyword search; use youtube-search-scraper for discovery.", "items": { "type": "string" } }, "maxVideosPerChannel": { "title": "Max videos per channel", "minimum": 0, "maximum": 100, "type": "integer", "description": "Use this to include recent regular videos from each channel. Set 0 for channel profile only, 5 for fast agent calls, or up to 100 for deeper exports. Defaults to 5. Not a global row limit; it applies separately to each channel.", "default": 5 }, "includeShorts": { "title": "Include Shorts", "type": "boolean", "description": "Use this when Shorts are part of the channel audit. If true, the actor also requests Shorts up to maxShortsPerChannel. Defaults to false for faster health checks. Not for global Shorts discovery; use youtube-shorts-scraper for that.", "default": false }, "maxShortsPerChannel": { "title": "Max Shorts per channel", "minimum": 0, "maximum": 50, "type": "integer", "description": "Use this to cap Shorts collected when includeShorts is true. Accepts 0 to 50 and defaults to 0. Keep it small for MCP calls. Not used when includeShorts is false.", "default": 0 }, "sortVideosBy": { "title": "Video sort", "enum": [ "latest", "popular" ], "type": "string", "description": "Use this to choose how channel videos are listed. Accepted values are latest or popular, with latest as the default. The setting applies to regular videos and provider-backed Shorts when supported. Not a relevance search sort.", "default": "latest" }, "providerMode": { "title": "Provider mode", "enum": [ "auto", "direct", "providerOnly" ], "type": "string", "description": "Use this to control the managed provider path. auto tries ScrapeCreators/SociaVault when the owner secret is configured and falls back to direct YouTube. direct skips providers. providerOnly soft-exits if no provider key is available.", "default": "auto" }, "country": { "title": "Country", "minLength": 2, "maxLength": 2, "type": "string", "description": "Use this to localize YouTube responses with a two-letter country code. Example: US, GB, PK, or DE. Defaults to US. Not a filter for channels by country.", "default": "US" }, "language": { "title": "Language", "minLength": 2, "maxLength": 8, "type": "string", "description": "Use this to localize text labels returned by YouTube. Example: en, es, de, or fr. Defaults to en. Not a translation feature for channel descriptions.", "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 } } } } } } } } } }