{ "openapi": "3.0.1", "info": { "title": "YouTube Comments Scraper — Replies, Likes, Authors, Dates", "description": "Scrape every comment on any YouTube video: full text, author handle + channel ID, numeric like and reply counts, pinned / hearted-by-creator flags, approximate date and the comment permalink. Threaded replies included. Sort by top or newest. No API key, no quota, no login.", "version": "0.1", "x-build-id": "iKHIQR9zxyNBa2hUB" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapersdelight~youtube-comments-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapersdelight-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/scrapersdelight~youtube-comments-scraper/runs": { "post": { "operationId": "runs-sync-scrapersdelight-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/scrapersdelight~youtube-comments-scraper/run-sync": { "post": { "operationId": "run-sync-scrapersdelight-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": { "videoUrls": { "title": "📺 YouTube videos", "type": "array", "description": "One video per line. Accepts a normal watch URL, a youtu.be short link, a /shorts/ or /live/ URL, or a bare 11-character video ID. Anything that cannot be parsed is skipped and named in the log.", "default": [ "https://www.youtube.com/watch?v=dQw4w9WgXcQ" ], "items": { "type": "string" } }, "sortBy": { "title": "Sort comments by", "enum": [ "top", "newest" ], "type": "string", "description": "`top` is YouTube's own featured/most-engaged ordering (the default a viewer sees). `newest` is strictly chronological, newest first — use it for monitoring and with 'Only comments newer than'.", "default": "top" }, "includeReplies": { "title": "Include threaded replies", "type": "boolean", "description": "Also expand each comment's reply thread. Replies arrive as their own rows, directly after their parent, with `isReply: true` and `parentCommentId` set. Off by default because replies cost one extra request per thread and count towards your limits.", "default": false }, "maxRepliesPerComment": { "title": "Max replies per comment", "minimum": 0, "type": "integer", "description": "Cap on replies pulled for a single comment thread when replies are switched on. 0 = every reply (hard-capped at 500 per thread).", "default": 10 }, "maxComments": { "title": "Max comments per video", "minimum": 0, "type": "integer", "description": "Stop after this many rows for each video. Replies count towards it when they are switched on. 0 = no per-video limit (the run-wide 'Max rows' below still applies).", "default": 100 }, "maxItems": { "title": "Max rows for the whole run", "minimum": 0, "type": "integer", "description": "Hard stop across every video, so a long video list can never bill more than you planned. 0 = no run-wide limit.", "default": 1000 }, "newerThanDays": { "title": "Only comments newer than (days)", "minimum": 0, "type": "integer", "description": "Skip comments older than this many days. 0 = no cutoff. YouTube only publishes a relative age ('3 days ago'), so the cutoff is exact to that granularity and no better. With sort = newest it also stops paging as soon as the feed goes older, which is the cheap way to monitor a video.", "default": 0 }, "videoConcurrency": { "title": "Videos in parallel", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many videos to work on at once. Comments inside one video must be paged in order, so this is where the speed comes from on a long list. Lower it if you see refused requests.", "default": 3 }, "requestDelayMs": { "title": "Delay between requests (ms)", "minimum": 0, "maximum": 10000, "type": "integer", "description": "Optional pause between page requests. 0 is fine for normal use; raise it only if YouTube starts refusing your exit IPs on a very large run.", "default": 0 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Apify Proxy is enough — the whole 3-request InnerTube chain was verified returning HTTP 200 through standard datacenter proxies. Switch to residential only if you are running very large jobs and start seeing refused requests in the log.", "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 } } }, "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 } } } } } } } } } }