{ "openapi": "3.0.1", "info": { "title": "YouTube Scraper + AI Comment Analyzer & Channel Audit", "description": "Scrape YouTube channels, videos, comments, transcripts, and search results. AI analyzes comments for viewer requests and sentiment, audits channel health with recommendations, and evaluates niche saturation with content gap analysis.", "version": "1.0", "x-build-id": "HipjUQRmqj659MzoI" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/buseta~youtube-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-buseta-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/buseta~youtube-scraper/runs": { "post": { "operationId": "runs-sync-buseta-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/buseta~youtube-scraper/run-sync": { "post": { "operationId": "run-sync-buseta-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", "required": [ "scrape_type" ], "properties": { "scrape_type": { "title": "Scrape type", "enum": [ "channel", "search", "video_urls" ], "type": "string", "description": "What to scrape from YouTube.", "default": "channel" }, "channel_urls": { "title": "Channel URLs", "type": "array", "description": "YouTube channel URLs. Supports formats: youtube.com/channel/ID, youtube.com/@handle, youtube.com/c/name", "items": { "type": "string" } }, "search_query": { "title": "Search query", "type": "string", "description": "Search YouTube for videos matching this query." }, "video_urls": { "title": "Video URLs", "type": "array", "description": "Specific YouTube video URLs to scrape details for.", "items": { "type": "string" } }, "max_videos": { "title": "Max videos", "minimum": 1, "maximum": 500, "type": "integer", "description": "Maximum number of videos to scrape per channel or search.", "default": 50 }, "get_comments": { "title": "Get comments", "type": "boolean", "description": "Scrape comments for each video.", "default": false }, "max_comments": { "title": "Max comments per video", "minimum": 1, "maximum": 500, "type": "integer", "description": "Maximum comments to scrape per video.", "default": 100 }, "get_transcript": { "title": "Get transcript", "type": "boolean", "description": "Get video transcript/captions when available.", "default": false }, "get_channel_about": { "title": "Get channel about info", "type": "boolean", "description": "Extract business email, links, and description from channel About page.", "default": true }, "ai_comment_analysis": { "title": "AI Comment Analyzer", "type": "boolean", "description": "AI analyzes comments per video: top viewer requests, complaints, sentiment, content ideas. Requires 'Get comments' to be enabled. Charged at $6 per 1,000 videos analyzed.", "default": false }, "ai_channel_audit": { "title": "AI Channel Audit", "type": "boolean", "description": "AI evaluates channel health: best content types, declining areas, growth signals, actionable recommendations. Charged at $12 per 1,000 channels.", "default": false }, "ai_niche_report": { "title": "AI Niche Report", "type": "boolean", "description": "AI analyzes all search results: niche saturation, content gaps, top performers, opportunity score. Only for search mode. Charged at $2 per 1,000 videos in report.", "default": false }, "proxy_config": { "title": "Proxy configuration", "type": "object", "description": "Proxy for YouTube requests. Recommended for large scrapes." } } }, "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 } } } } } } } } } }