{ "openapi": "3.0.1", "info": { "title": "YouTube Comment Scraper That Won't Quit", "description": "Scrape public YouTube comments and replies from video links or IDs. Export text, likes, authors and dates to CSV, Excel or JSON, with question excerpts and phrase search. No YouTube API key required.", "version": "0.6", "x-build-id": "NAGXeB0lhnJ41EeYM" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/thescrapelab~Apify-YouTube-Comment-Scraper-2-0/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-thescrapelab-Apify-YouTube-Comment-Scraper-2-0", "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/thescrapelab~Apify-YouTube-Comment-Scraper-2-0/runs": { "post": { "operationId": "runs-sync-thescrapelab-Apify-YouTube-Comment-Scraper-2-0", "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/thescrapelab~Apify-YouTube-Comment-Scraper-2-0/run-sync": { "post": { "operationId": "run-sync-thescrapelab-Apify-YouTube-Comment-Scraper-2-0", "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": "YouTube video links or IDs", "type": "array", "description": "Add one or more public YouTube video links. Standard video links, Shorts links, youtu.be links and 11-character video IDs are accepted.", "default": [ "https://www.youtube.com/watch?v=dQw4w9WgXcQ" ], "items": { "type": "string" } }, "maxCommentsPerVideo": { "title": "Comments per video", "minimum": 0, "maximum": 100000, "type": "integer", "description": "Maximum comments to return per video, including replies when enabled. The example collects 5 comments. Source availability, page limits, run time and spending limits can reduce the count.", "default": 5 }, "includeReplies": { "title": "Include replies", "type": "boolean", "description": "Collect available replies as separate comment rows. Replies count toward the comments-per-video limit.", "default": false }, "commentSort": { "title": "Comment order", "enum": [ "top", "new" ], "type": "string", "description": "Choose YouTube’s top-comment order or newest-comment order. The delivered sample can vary with source availability.", "default": "top" }, "analysisQuery": { "title": "Find a phrase in comments", "type": "string", "description": "Optional literal phrase to find within the delivered comments. This analyzes collected comments; it does not filter source collection." }, "maxCommentPagesPerVideo": { "title": "Source page limit", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Optional API limit for source comment-page requests per video. Omit it to select a bounded allowance based on the requested comment count." }, "providedRecords": { "title": "Comments (JSON)", "type": "array", "description": "Optional API import for existing integrations. Use supplied comment records instead of collecting from video links.", "items": { "type": "object" } }, "providedDatasetId": { "title": "Comment dataset ID", "type": "string", "description": "Optional API import from an accessible Apify dataset. Omit this field when collecting from video links." } } }, "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 } } } } } } } } } }