> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zilodata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get video comments

> Get comments for a YouTube video with optional sorting and pagination



## OpenAPI

````yaml api-reference/youtube-openapi.json get /api/v1/video/comments
openapi: 3.1.0
info:
  title: YouTube APIs
  description: YouTube API Documentation
  version: 1.0.0
servers:
  - url: https://youtube-scraper-api-v21.p.rapidapi.com
security: []
paths:
  /api/v1/video/comments:
    get:
      tags:
        - Video
      summary: Get video comments
      description: Get comments for a YouTube video with optional sorting and pagination
      operationId: getApiV1VideoComments
      parameters:
        - in: query
          name: videoId
          schema:
            type: string
            description: YouTube video ID
            example: kJQP7kiw5Fk
          required: true
        - in: query
          name: sortBy
          schema:
            type: string
            enum:
              - TOP_COMMENTS
              - NEWEST_FIRST
            default: TOP_COMMENTS
            description: Sort comments by top comments or newest first
            example: TOP_COMMENTS
          required: false
        - in: query
          name: continuation
          schema:
            type: string
            description: Continuation token for pagination
            example: UgyD...
          required: false
        - in: query
          name: gl
          schema:
            type: string
            default: US
            description: Geographical code
            example: US
            enum:
              - US
              - AE
              - AR
              - AT
              - AU
              - AZ
              - BD
              - BE
              - BG
              - BR
              - CA
              - CH
              - CL
              - CO
              - CZ
              - DE
              - DK
              - DO
              - DZ
              - EC
              - EG
              - ES
              - FI
              - FR
              - GB
              - GH
              - GR
              - GT
              - HK
              - HN
              - HR
              - HU
              - ID
              - IE
              - IL
              - IN
              - IQ
              - IT
              - JP
              - KE
              - KR
              - LB
              - LT
              - LV
              - MA
              - MX
              - MY
              - NG
              - NL
              - 'NO'
              - NZ
              - PE
              - PH
              - PK
              - PL
              - PT
              - RO
              - RU
              - SA
              - SE
              - SG
              - TH
              - TR
              - TW
              - UA
              - VE
              - VN
              - ZA
          required: false
        - in: query
          name: hl
          schema:
            type: string
            description: Language code
            example: en
            enum:
              - ar
              - az
              - bg
              - bn
              - cs
              - da
              - de
              - el
              - en
              - en-GB
              - en-IE
              - en-NZ
              - en-SG
              - es
              - es-419
              - fi
              - fil
              - fr
              - he
              - hi
              - hr
              - hu
              - id
              - it
              - ja
              - ko
              - lt
              - lv
              - ms
              - nl
              - 'no'
              - pl
              - pt-BR
              - pt-PT
              - ro
              - ru
              - sv
              - th
              - tr
              - uk
              - ur
              - vi
              - zh-Hant
            default: en
          required: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    example: Success
                  statusCode:
                    type: number
                    example: 200
                  pagination:
                    type: object
                    properties:
                      total:
                        type: number
                        example: 100
                      hasMore:
                        type: boolean
                        example: true
                      continuation:
                        type:
                          - string
                          - 'null'
                        description: Continuation token for pagination
                        example: CDsQ8FsiEwje95_F1pmRAxXlsykDHUX
                  data:
                    type: object
                    properties:
                      comments:
                        type: array
                        items:
                          type: object
                          properties:
                            id:
                              type: string
                              description: Comment ID
                              example: UgyD...
                            author:
                              type: object
                              properties:
                                id:
                                  type: string
                                  description: Author channel ID
                                  example: UCxoq-PAQeAdk_zyg8YS0JqA
                                name:
                                  type: string
                                  description: Author name
                                  example: John Doe
                                thumbnails:
                                  type: array
                                  items:
                                    type: object
                                    properties:
                                      url:
                                        type: string
                                        description: Author thumbnail URL
                                        example: https://yt3.ggpht.com/...
                                      width:
                                        type: number
                                        description: Thumbnail width
                                        example: 68
                                      height:
                                        type: number
                                        description: Thumbnail height
                                        example: 68
                                    required:
                                      - url
                                      - width
                                      - height
                                    description: Thumbnail information
                                  description: Array of author thumbnails
                                verified:
                                  type: boolean
                                  description: Whether the author is verified
                                  example: false
                              required:
                                - id
                                - name
                              description: Comment author information
                            text:
                              type: string
                              description: Comment text content
                              example: Great video!
                            likeCount:
                              type: number
                              description: Number of likes on the comment
                              example: 1000
                            published:
                              type: string
                              description: Comment published date
                              example: '2024-01-01'
                            publishedText:
                              type: string
                              description: Human-readable published time
                              example: 2 days ago
                            isPinned:
                              type: boolean
                              description: Whether the comment is pinned
                              example: false
                            replyCount:
                              type: number
                              description: Number of replies to this comment
                              example: 5
                            continuationCommand:
                              type:
                                - string
                                - 'null'
                              description: >-
                                Continuation token for fetching reply comments.
                                This token is used to get replies for this
                                specific comment. Returns null if the comment
                                has no replies or the token is not available.
                              example: >-
                                Eg0SC0d5ckg2eGlGaVQwGAYygwEaUBIaVWd4djFBcjJ4TTJDZ0liZVJhVjRBYUFCQWciAggAKhhVQ3dKRHZ4NVlib3VDRVFfUlB3LU9SQlEyC0d5ckg2eGlGaVQwQAFICoIBAggBQi9jb21tZW50LXJlcGxpZXMtaXRlbS1VZ3h2MUFyMnhNMkNnSWJlUmFWNEFhQUJBZw%3D%3D
                          required:
                            - id
                            - author
                            - text
                        description: Array of video comments
                    required:
                      - comments
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    example: Bad request
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    example: Invalid API key
        '403':
          description: Not Found
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    example: >-
                      You are not subscribed to this API, please subscribe
                      before using
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: false
                  message:
                    type: string
                    example: Internal Server Error
                  status_code:
                    type: number
                    example: 500
                  cost:
                    type: number
                    example: 0
                  explain:
                    type: string
                    example: Internal Server Error
      security:
        - apiKeyAuth: []
components:
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-rapidapi-key
      description: API Key

````