{ "openapi": "3.0.1", "info": { "title": "Best Damn YouTube Comments Scraper", "description": "Scrape YouTube comments and replies from videos, Shorts and whole channels through the official YouTube Data API: text, likes, reply counts, dates and author. Sort, filter by keyword or date. Pay per comment; failures are free.", "version": "0.1", "x-build-id": "SLiCucjfZu3lOcc2D" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/josh99smith~youtube-comments-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-josh99smith-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/josh99smith~youtube-comments-scraper/runs": { "post": { "operationId": "runs-sync-josh99smith-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/josh99smith~youtube-comments-scraper/run-sync": { "post": { "operationId": "run-sync-josh99smith-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", "required": [ "startUrls" ], "properties": { "startUrls": { "title": "YouTube URLs", "type": "array", "description": "One per line. Accepts video URLs (youtube.com/watch?v=..., youtu.be/...), Shorts and live URLs, bare 11-character video IDs, and channel URLs (youtube.com/@handle, youtube.com/channel/UC...) or @handles. For a channel, the Actor reads its most recent videos (see \"Videos per channel\").", "items": { "type": "string" } }, "maxComments": { "title": "Max comments per video", "minimum": 0, "type": "integer", "description": "Stop after this many comments per video (replies count toward the limit). Use 0 for every comment the video has.", "default": 100 }, "sortBy": { "title": "Sort order", "enum": [ "relevance", "time" ], "type": "string", "description": "\"Top comments\" is YouTube's relevance order (what viewers see first). \"Newest first\" is reverse chronological and is the fastest way to get only recent comments together with \"Only comments after\".", "default": "relevance" }, "includeReplies": { "title": "Include replies", "type": "boolean", "description": "Also return the replies under each comment, in conversation order, marked with isReply and parentCommentId.", "default": false }, "publishedAfter": { "title": "Only comments after", "type": "string", "description": "Optional. Skip comments posted before this date. Use a date (2026-01-31) or a relative period such as \"7 days\", \"2 weeks\" or \"3 months\"." }, "searchTerms": { "title": "Only comments containing", "type": "string", "description": "Optional. Return only top-level comments that contain these words (YouTube's own comment search)." }, "authorData": { "title": "Author data", "enum": [ "include", "hash", "omit" ], "type": "string", "description": "What to output about each commenter. \"Include\" gives the public display name and channel; \"Pseudonymise\" replaces the channel ID with a stable hash and drops name and avatar, so you can still count repeat commenters; \"Omit\" removes all author fields.", "default": "include" }, "maxVideosPerChannel": { "title": "Videos per channel", "minimum": 1, "maximum": 500, "type": "integer", "description": "For channel URLs: how many of the channel's most recent uploads to read comments from.", "default": 10 }, "apiKey": { "title": "YouTube API key", "type": "string", "description": "Optional. Your own free YouTube Data API v3 key (Google Cloud Console > APIs & Services > Credentials, with the YouTube Data API v3 enabled). Without it the Actor uses a shared key whose daily quota is shared by all users; your own key gives you 10,000 quota units a day (about a million comments)." }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many videos to read in parallel.", "default": 4 } } }, "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 } } } } } } } } } }