{ "openapi": "3.0.1", "info": { "title": "YouTube Channel & Video Scraper", "description": "Enterprise-grade YouTube scraper that extracts 30+ data points per channel with built-in subscriber analytics, video performance metrics, and engagement calculations. Perfect for influencer marketing, competitor analysis, and content strategy research.", "version": "1.0", "x-build-id": "CIRzgxYWzwybbcw95" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/alizarin_refrigerator-owner~youtube-channel-video-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-alizarin_refrigerator-owner-youtube-channel-video-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/alizarin_refrigerator-owner~youtube-channel-video-scraper/runs": { "post": { "operationId": "runs-sync-alizarin_refrigerator-owner-youtube-channel-video-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/alizarin_refrigerator-owner~youtube-channel-video-scraper/run-sync": { "post": { "operationId": "run-sync-alizarin_refrigerator-owner-youtube-channel-video-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": [ "scrapeType" ], "properties": { "scrapeType": { "title": "Scrape Type", "enum": [ "channels", "videos", "search", "playlists" ], "type": "string", "description": "What to scrape from YouTube", "default": "channels" }, "channelUrls": { "title": "Channel URLs or Handles", "type": "array", "description": "YouTube channel URLs, handles (@username), or channel IDs", "items": { "type": "string" } }, "videoUrls": { "title": "Video URLs", "type": "array", "description": "YouTube video URLs to scrape", "items": { "type": "string" } }, "searchQueries": { "title": "Search Queries", "type": "array", "description": "Search terms to find channels or videos", "items": { "type": "string" } }, "searchType": { "title": "Search Type", "enum": [ "channel", "video", "playlist" ], "type": "string", "description": "What to search for", "default": "channel" }, "includeVideos": { "title": "Include Recent Videos", "type": "boolean", "description": "Scrape recent videos for each channel", "default": true }, "videosPerChannel": { "title": "Videos Per Channel", "minimum": 1, "maximum": 50, "type": "integer", "description": "Number of videos to scrape per channel", "default": 10 }, "includeComments": { "title": "Include Comments", "type": "boolean", "description": "Scrape comments for videos (slower)", "default": false }, "commentsPerVideo": { "title": "Comments Per Video", "minimum": 1, "maximum": 100, "type": "integer", "description": "Number of comments to scrape per video", "default": 20 }, "maxResults": { "title": "Maximum Results", "minimum": 1, "maximum": 500, "type": "integer", "description": "Maximum items to return", "default": 50 }, "minSubscribers": { "title": "Minimum Subscribers", "type": "integer", "description": "Only return channels with at least this many subscribers", "default": 0 }, "minViews": { "title": "Minimum Views", "type": "integer", "description": "Only return videos with at least this many views", "default": 0 }, "uploadedAfter": { "title": "Uploaded After", "type": "string", "description": "Only include videos uploaded after this date (YYYY-MM-DD)" }, "sortBy": { "title": "Sort By", "enum": [ "subscribers", "views", "videoCount", "engagement", "recent" ], "type": "string", "description": "How to sort results", "default": "subscribers" }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Proxy settings for bypassing restrictions" }, "demoMode": { "title": "Demo Mode", "type": "boolean", "description": "Run with sample data", "default": true }, "webhookUrl": { "title": "Webhook URL", "pattern": "^https?://.+", "type": "string", "description": "Optional webhook URL to receive results when scraping completes" }, "sessionCookies": { "title": "Session Cookies (JSON)", "type": "string", "description": "JSON array of cookies from Cookie-Editor browser extension. Export cookies while logged in to YouTube to bypass bot detection." }, "cookieStorageKey": { "title": "Cookie Storage Key", "type": "string", "description": "Key name to load cookies from the Cookie Manager KV store. If set and no manual sessionCookies are provided, the actor loads cookies from the named KV store automatically. Use this with the Cookie Manager actor for automated cookie rotation." }, "cookieKvStoreName": { "title": "Cookie KV Store Name", "type": "string", "description": "Name of the Apify Key-Value store where Cookie Manager saves cookies. Defaults to 'cookie-sessions' if not set.", "default": "cookie-sessions" } } }, "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 } } } } } } } } } }