{ "openapi": "3.0.1", "info": { "title": "YouTube Comments Scraper: Replies, Likes & Hearts", "description": "Scrape YouTube comments and replies from any video or Short, or from a channel, playlist or search. Text, author, likes, reply count, creator heart, pinned, date and exact comment total. No API key or quota. Same input and output as the popular YouTube Comments Scraper. $0.25 per 1,000 comments.", "version": "0.1", "x-build-id": "Juv9zi9yotip0YhAl" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/wulfcare~youtube-comments-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-wulfcare-youtube-comments-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/wulfcare~youtube-comments-scraper/runs": { "post": { "operationId": "runs-sync-wulfcare-youtube-comments-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/wulfcare~youtube-comments-scraper/run-sync": { "post": { "operationId": "run-sync-wulfcare-youtube-comments-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", "properties": { "startUrls": { "title": "YouTube URLs", "type": "array", "description": "Videos or Shorts (one per line; {\"url\": ...} objects work too) to get comments from (watch, youtu.be, /shorts/ URLs or 11-character video IDs). Channel URLs (@handle, /channel/UC...; add /shorts for Shorts), playlist URLs and search result URLs also work: their newest/first \"Maximum videos\" videos are used.", "items": { "type": "string" } }, "maxComments": { "title": "Maximum comments per video", "minimum": 0, "maximum": 1000000, "type": "integer", "description": "Comments (and replies, when on) to get from each video. 0 = all of them. ~1,000 comments take about 20 seconds.", "default": 100 }, "sortCommentsBy": { "title": "Sort comments by", "enum": [ "TOP_COMMENTS", "NEWEST_FIRST" ], "type": "string", "description": "YouTube's own Top / Newest order.", "default": "NEWEST_FIRST" }, "includeReplies": { "title": "Include replies", "type": "boolean", "description": "Also get the replies to each comment, right after it (type \"reply\", replyToCid = the comment). Replies count toward \"Maximum comments\".", "default": false }, "maxRepliesPerComment": { "title": "Maximum replies per comment", "minimum": 0, "maximum": 100000, "type": "integer", "description": "0 = all replies of each comment.", "default": 0 }, "oldestCommentDate": { "title": "Only comments posted on or after", "type": "string", "description": "A date (2026-01-31) or an age (\"7 days\", \"3 months\"). With \"Newest first\" the run stops reading a video once comments get older. YouTube only says \"x days ago\", so the cut is approximate." }, "searchQueries": { "title": "Search terms", "type": "array", "description": "Get comments from the top \"Maximum videos\" YouTube search results of each term (e.g. a product or brand name).", "items": { "type": "string" } }, "maxVideos": { "title": "Maximum videos per channel, playlist or search", "minimum": 1, "maximum": 10000, "type": "integer", "description": "How many videos each channel (newest first), playlist or search term contributes.", "default": 10 }, "maxItems": { "title": "Maximum comments in total", "minimum": 1, "maximum": 10000000, "type": "integer", "description": "Optional cap for the whole run (all videos together). Empty = no cap." }, "maxConcurrency": { "title": "Videos at a time", "minimum": 1, "maximum": 20, "type": "integer", "description": "How many videos are read in parallel.", "default": 5 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify Proxy (datacenter) is on by default and works well.", "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 } } } } } } } } } }