{ "openapi": "3.0.1", "info": { "title": "YouTube Comments Scraper + Audience Insights", "description": "Scrape YouTube comments from videos or a channel's latest uploads without an API key. Each comment is labelled as question, content request, complaint, praise or willingness to pay, and an optional insights row per video lists top viewer questions, video requests and keywords.", "version": "0.1", "x-build-id": "hFaFM2X8yHJ8TKJFv" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/happysproutstore~youtube-comments-insights/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-happysproutstore-youtube-comments-insights", "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/happysproutstore~youtube-comments-insights/runs": { "post": { "operationId": "runs-sync-happysproutstore-youtube-comments-insights", "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/happysproutstore~youtube-comments-insights/run-sync": { "post": { "operationId": "run-sync-happysproutstore-youtube-comments-insights", "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": [ "videos" ], "properties": { "videos": { "title": "Videos or channels", "type": "array", "description": "One per line: a video URL (watch, youtu.be, Shorts), an 11-character video ID, or a channel URL such as https://www.youtube.com/@name. A channel is expanded to its latest videos.", "default": [ "https://www.youtube.com/watch?v=dQw4w9WgXcQ" ], "items": { "type": "string" } }, "maxCommentsPerVideo": { "title": "Max comments per video", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Upper limit of comment rows per video, replies included. Large values take longer: roughly 100 comments per 2-4 seconds.", "default": 100 }, "maxVideosPerChannel": { "title": "Latest videos per channel", "minimum": 1, "maximum": 200, "type": "integer", "description": "How many of the newest uploads to take from each channel URL.", "default": 5 }, "sort": { "title": "Sort comments by", "enum": [ "top", "newest" ], "type": "string", "description": "Top comments gives the most liked and most discussed comments first; newest gives the latest ones.", "default": "top" }, "includeReplies": { "title": "Include replies", "type": "boolean", "description": "Also return replies under each comment (marked isReply with parentId). Replies count toward the per-video limit.", "default": false }, "maxRepliesPerThread": { "title": "Max replies per comment", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Only used when replies are included.", "default": 5 }, "includeInsights": { "title": "Add audience insights row per video", "type": "boolean", "description": "Adds one row per video with label counts and shares, top 10 viewer questions and top 10 video requests by likes, top keywords and two-word phrases, most-liked themes and a simple tone score. Rule based, no AI model.", "default": true }, "languages": { "title": "Comment languages for the rules", "type": "array", "description": "Which rule packs label the comments. Leave all selected for mixed comment sections. English and Turkish are the most complete.", "items": { "type": "string", "enum": [ "en", "tr", "es", "de" ], "enumTitles": [ "English", "Turkish", "Spanish", "German" ] }, "default": [ "en", "tr", "es", "de" ] }, "maxConcurrency": { "title": "Videos in parallel", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many videos are fetched at the same time.", "default": 3 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "YouTube may block busy IPs. On a block the Actor retries with a new proxy session. The default Apify proxy is enough for most runs; switch to Residential for very large batches.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }