Get comments from selected YouTube videos

{
  "type": "object",
  "required": [
    "body"
  ],
  "properties": {
    "body": {
      "type": "object",
      "title": "Input schema for the youtube-search-scraper actor",
      "required": [
        "startUrls"
      ],
      "properties": {
        "startUrls": {
          "type": "array",
          "title": "Direct video URLs",
          "editor": "requestListSources",
          "default": [],
          "example": [
            {
              "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
            }
          ],
          "prefill": [
            {
              "url": "https://www.youtube.com/watch?v=xObhZ0Ga7EQ"
            }
          ],
          "description": "Required list of request entries containing a url, for example {\"url\":\"https://www.youtube.com/watch?v=dQw4w9WgXcQ\"}. The default empty list does not select a video. Use known direct video URLs; displayed examples and prefilled URLs are not defaults."
        },
        "maxComments": {
          "type": "integer",
          "title": "Maximum comments",
          "default": 1,
          "example": 100,
          "minimum": 1,
          "prefill": 10,
          "description": "Requested maximum per video, minimum 1 and default 1. Prefill 10 and example 100 are not defaults. The cap does not guarantee the returned count, every reply, complete coverage or a fixed charge."
        },
        "sortCommentsBy": {
          "enum": [
            "TOP_COMMENTS",
            "NEWEST_FIRST"
          ],
          "type": "string",
          "title": "Sorting order",
          "editor": "select",
          "default": "NEWEST_FIRST",
          "enumTitles": [
            "Top comments",
            "Newest first"
          ],
          "description": "Default NEWEST_FIRST requests newest-first ordering; TOP_COMMENTS requests YouTube’s top-comment ordering. Setting oldestCommentDate switches sorting back to newest first. A source order does not guarantee globally newest or representative records."
        },
        "oldestCommentDate": {
          "type": "string",
          "title": "Scrape comments published after [date]",
          "editor": "datepicker",
          "example": "2026-03-01",
          "pattern": "^(\\d{4})-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])(T[0-2]\\d:[0-5]\\d(:[0-5]\\d)?(\\.\\d+)?Z?)?$|^(\\d+)\\s*(minute|hour|day|week|month|year)s?$",
          "dateType": "absoluteOrRelative",
          "description": "Optional inclusive lower bound on comment publication, using an absolute date or relative age, such as 2026-03-01 or 2 days. Relative units include minutes, hours, days, weeks, months and years. Setting it forces newest-first sorting. Calendar-day examples do not define a rolling 24-hour or UTC window."
        }
      },
      "description": "Required request object for comments from selected direct YouTube video URLs. Set a per-video cap and sorting order, with an optional comment-publication date filter. This request does not search topics or discover channel videos.",
      "schemaVersion": 1
    }
  },
  "additionalProperties": false
}