{ "openapi": "3.0.1", "info": { "title": "Youtube Comments [$0.4💰] Scraper [with replies]", "description": "💰 $0.4 per 1,000 comments – No limits, no quotas, unlimited extraction.\n\nExtract YouTube comments from any video with full comment text, reply threads, author details, vote counts, posting dates, and video metadata. Download in JSON, CSV, and Excel.", "version": "0.0", "x-build-id": "ByD5Ggm43Hsi50czq" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/memo23~youtube-comments-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-memo23-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/memo23~youtube-comments-scraper/runs": { "post": { "operationId": "runs-sync-memo23-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/memo23~youtube-comments-scraper/run-sync": { "post": { "operationId": "run-sync-memo23-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": "Start URLs", "type": "array", "description": "One YouTube video per entry — this actor reads a single video's comment section at a time. Accepted: https://www.youtube.com/watch?v=, https://youtu.be/, and /shorts/, /live/ and /embed/ links, which are normalized to the watch page for you.\n\nChannel, playlist and search URLs carry no comment section of their own and are skipped with a note in the log; a run with nothing but those fails and says so.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxItems": { "title": "Max Items", "minimum": 1, "type": "integer", "description": "Maximum number of items to scrape, counted in rows that reach the dataset — replies included. Note: accounts on the Apify free plan are limited to 30 comments per run — any paid Apify plan removes this limit.", "default": 100 }, "sortCommentsBy": { "title": "Sort comments by", "enum": [ "top", "newest" ], "type": "string", "description": "Order YouTube returns the comments in. \"Top comments\" is YouTube's own relevance ranking; \"Newest first\" is strictly by date, newest to oldest.\n\nLeave empty and the actor asks for no order at all — YouTube serves the comment section exactly as it would to a visitor, which is normally its Top ranking. The one exception is \"Oldest comment date\": set that without a sort and the actor picks Newest first, so the run can stop as soon as it reaches comments older than your cutoff." }, "oldestCommentDate": { "title": "Oldest comment date", "pattern": "^\\s*(\\d{4}-\\d{2}-\\d{2}([Tt][0-9:.+\\-Zz]*)?|\\d+\\s*([Ss]econd|[Mm]inute|[Hh]our|[Dd]ay|[Ww]eek|[Mm]onth|[Yy]ear)s?(\\s+[Aa]go)?)\\s*$", "type": "string", "description": "Only return top-level comments published on or after this date. Accepts an ISO date (2026-01-31) or a relative span (\"3 days\", \"2 weeks\", \"6 months\").\n\nReplies are not filtered: a comment that passes the cutoff arrives with its whole reply thread, whatever the age of the individual replies, because a thread with its middle cut out is worse than no thread. Those replies count towards Max Items like any other row.\n\nApproximate by design: YouTube publishes no exact comment timestamp, only a rounded age such as \"2 weeks ago\", so the filter is accurate to that bucket and never drops a comment that could fall inside your range. Every row also carries publishedAtApprox (ISO) alongside the original publishedTimeText.\n\nWith \"Newest first\" the run stops paging as soon as it reaches older comments, which makes a date filter cheap. With \"Top comments\" the ranking is not chronological, so there is no point at which the rest is guaranteed older — the filter still applies, but the run reads on under a budget and stops with an explanation rather than running to the end of a comment section that can be hundreds of thousands long." }, "maxConcurrency": { "title": "Max Concurrency", "minimum": 1, "maximum": 100, "type": "integer", "description": "Maximum number of pages that can be processed at the same time.", "default": 10 }, "minConcurrency": { "title": "Min Concurrency", "minimum": 1, "maximum": 100, "type": "integer", "description": "Minimum number of pages that will be processed at the same time.", "default": 1 }, "maxRequestRetries": { "title": "Max Request Retries", "minimum": 0, "maximum": 20, "type": "integer", "description": "Number of times the crawler will retry a failed request before giving up.", "default": 3 }, "proxy": { "title": "Proxy configuration (optional override)", "type": "object", "description": "Runs go out through the actor's own residential pools, so Apify proxy groups and countries chosen here are not used (the run logs a line saying so). Only your own proxy URLs, with 'Use Apify Proxy' switched off, are honoured.", "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 } } } } } } } } } }