{ "openapi": "3.0.1", "info": { "title": "YouTube Comments Scraper & Pain Point Analyzer", "description": "Scrape YouTube comments and replies by video URL or keyword, and find what people complain about. Every comment labelled complaint, request, question or praise, plus top pain points and feature requests in an HTML report. No API key. $0.50 per 1,000 comments.", "version": "0.0", "x-build-id": "tQEakFRU6OZLEzSfq" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/lsso~youtube-comments-pain-points/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-lsso-youtube-comments-pain-points", "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/lsso~youtube-comments-pain-points/runs": { "post": { "operationId": "runs-sync-lsso-youtube-comments-pain-points", "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/lsso~youtube-comments-pain-points/run-sync": { "post": { "operationId": "run-sync-lsso-youtube-comments-pain-points", "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", "properties": { "videoUrls": { "title": "Video URLs", "type": "array", "description": "YouTube videos or Shorts: full URLs, youtu.be links or 11-character video IDs.", "items": { "type": "string" } }, "searchQueries": { "title": "Search keywords", "type": "array", "description": "Optional. Find videos by keyword and read their comments, e.g. `notion review`, `iphone 17 problems`. Great for product and competitor research.", "default": [], "items": { "type": "string" } }, "videosPerSearch": { "title": "Videos per keyword", "minimum": 1, "maximum": 50, "type": "integer", "description": "How many top search results to read for each keyword.", "default": 5 }, "maxCommentsPerVideo": { "title": "Max comments per video", "minimum": 1, "maximum": 20000, "type": "integer", "description": "Top-level comments to read per video. Replies (if enabled) come on top.", "default": 200 }, "sort": { "title": "Sort comments by", "enum": [ "top", "newest" ], "type": "string", "description": "Same as the sort button under a YouTube video.", "default": "top" }, "includeReplies": { "title": "Include replies", "type": "boolean", "description": "Also read replies to each comment. Replies are returned as their own rows with parentId.", "default": false }, "maxRepliesPerComment": { "title": "Max replies per comment", "minimum": 1, "maximum": 200, "type": "integer", "description": "Only used when replies are included.", "default": 10 }, "onlyNewerThanDays": { "title": "Only comments from the last N days", "minimum": 0, "maximum": 3650, "type": "integer", "description": "0 = no limit. With 'Newest first' the Actor stops as soon as it reaches older comments, which is fast and cheap for daily monitoring.", "default": 0 }, "analysis": { "title": "Pain point analysis", "type": "boolean", "description": "Label every comment (complaint, request, question, praise) and build the insights report: top pain points, what people ask for, most-liked complaints and questions.", "default": true }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Optional. By default the Actor connects directly and uses no proxy. Turn on a proxy here only if your runs get rate-limited by YouTube; proxy traffic is billed to your Apify account." } } }, "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 } } } } } } } } } }