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

# Video comments

> Returns all top-level comments on a Rumble video by URL, in one response (Rumble sends them all at once, most liked first): each with its text and links, author (name, user or channel, profile link, avatar, badges such as Verified or Supporter), exact time, likes, dislikes and reply count — plus Rumble's total comment count (replies included). Only publicly available data is returned.

> [!NOTE]
>
> **Cost: 1 credit** per successful request. Errors and cache hits (`cache_max_age`) are free.

> [accordion] Copy for AI assistant
>
> Paste this into ChatGPT, Claude or your coding assistant to generate working code for this endpoint (use the copy button).
>
> ```text Prompt
> I want to make an API call to /v1/rumble/video/comments. Here are the details:
>
> Endpoint: GET https://api.scraperize.com/v1/rumble/video/comments
> Description: Returns all top-level comments on a Rumble video by URL, in one response (Rumble sends them all at once, most liked first): each with its text and links, author (name, user or channel, profile link, avatar, badges such as Verified or Supporter), exact time, likes, dislikes and reply count — plus Rumble's total comment count (replies included). Only publicly available data is returned.
>
> Required Headers:
> - x-api-key: Your API key
>
> Parameters:
> - url (string) [required]: The video's URL (rumble.com/v<id>-<title>.html, rumble.com/shorts/v<id> or rumble.com/embed/v<id>/).
> - cache_max_age (select): Optional. Return a cached result if one this age or newer exists — served for **0 credits** with `meta.cached=true` and `meta.cachedAt`. Otherwise a fresh scrape runs (**1 credit**) and refreshes the cache. Omit to always scrape fresh.
>
> Example Response:
> {
>   "data": {
>     "video": {
>       "id": "v7hvcx6",
>       "url": "https://rumble.com/v7hvcx6-71-of-voters-say-congress-isnt-doing-enough-to-check-trump.html",
>       "title": "71% of Voters Say Congress Isn't Doing Enough to CHECK Trump"
>     },
>     "totalComments": 44,
>     "comments": [
>       {
>         "id": "621320128",
>         "url": "https://rumble.com/v7hvcx6-71-of-voters-say-congress-isnt-doing-enough-to-check-trump.html#comment-621320128",
>         "text": "People are irritated because they don't know what life can really be like.\n\nIt's that simple.\n\nFew people in America have had to live a life of fear of starvati…",
>         "links": [],
>         "author": "Samohtd",
>         "authorType": "user",
>         "authorUrl": "https://rumble.com/user/Samohtd",
>         "authorAvatarUrl": "https://hugh.cdn.rumble.cloud/video/z0/r/f/1/U/rf1Ub.asF.3-hapn5-sw8g94.png",
>         "authorBadges": [],
>         "createdAt": "2026-11-06T19:30:00.000Z",
>         "createdText": "19 hours ago",
>         "likes": 11,
>         "dislikes": 2,
>         "replyCount": 3
>       }
>     ],
>     "count": 22,
>     "fetchedAt": "2026-11-07T14:48:48.853Z"
>   },
>   "meta": {
>     "requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f",
>     "creditsCharged": 1,
>     "creditsRemaining": 4999,
>     "cached": false
>   }
> }
>
> Please help me write code in my preferred programming language to make this API call and handle the response appropriately. Include error handling and best practices.
> ```


## OpenAPI

````yaml /api-reference/openapi.json get /v1/rumble/video/comments
openapi: 3.0.3
info:
  title: Scraperize API
  version: 1.0.0
  description: >-
    Extract public data from social media platforms as clean JSON. Endpoints are
    split by platform and by what they return, e.g. `GET /v1/twitter/tweet`.


    ## Authentication

    Send your API key in the `x-api-key` header (or `Authorization: Bearer
    <key>`). Create keys in your dashboard.


    ## Credits

    Each successful live scrape costs **1 credit**. Credits are prepaid and
    never expire.


    ## Caching

    Every endpoint accepts an optional `cache_max_age`
    (`1d`|`3d`|`7d`|`14d`|`30d`). A cache hit within that window is returned for
    **0 credits**.


    ## Responses

    Success returns `{ "data": …, "meta": { "requestId", … } }`. Errors return
    `{ "error": { "code", "message", "requestId" } }` with a matching HTTP
    status. `meta` on a scrape carries `creditsCharged`, `creditsRemaining`,
    `cached`, and (on a hit) `cachedAt`.


    ## Rate limits

    Requests are limited per team per minute; over the limit returns `429` with
    a `Retry-After` header.
servers:
  - url: https://api.scraperize.com
    description: Production
security:
  - ApiKeyAuth: []
tags:
  - name: Twitter
    description: Twitter / X scraping endpoints
  - name: Facebook
    description: Facebook scraping endpoints
  - name: Linkme
    description: Linkme (link.me) scraping endpoints
  - name: Amazon
    description: Amazon (creator shop / storefront) scraping endpoints
  - name: Linkbio
    description: Linkbio (lnk.bio) scraping endpoints
  - name: Pillar
    description: Pillar (pillar.io) scraping endpoints
  - name: Komi
    description: Komi (komi.io) scraping endpoints
  - name: Linktree
    description: Linktree (linktr.ee) scraping endpoints
  - name: Kick
    description: Kick (kick.com) scraping endpoints
  - name: Snapchat
    description: Snapchat (snapchat.com) scraping endpoints
  - name: Telegram
    description: Telegram (t.me) scraping endpoints
  - name: LinkedIn
    description: LinkedIn scraping endpoints
  - name: Twitch
    description: Twitch scraping endpoints
  - name: TikTok
    description: TikTok (tiktok.com) scraping endpoints
  - name: Instagram
    description: Instagram scraping endpoints
  - name: Lagos Life
    description: Lagos Life scraping endpoints
  - name: Bluesky
    description: Bluesky (bsky.app) scraping endpoints
  - name: Threads
    description: Threads (threads.com) scraping endpoints
  - name: Reddit
    description: Reddit (reddit.com) scraping endpoints
  - name: Rumble
    description: Rumble (rumble.com) scraping endpoints
  - name: Truth Social
    description: Truth Social (truthsocial.com) scraping endpoints
  - name: YouTube
    description: YouTube (youtube.com) scraping endpoints
paths:
  /v1/rumble/video/comments:
    get:
      tags:
        - Rumble
      summary: Video comments
      description: >-
        Returns all top-level comments on a Rumble video by URL, in one response
        (Rumble sends them all at once, most liked first): each with its text
        and links, author (name, user or channel, profile link, avatar, badges
        such as Verified or Supporter), exact time, likes, dislikes and reply
        count — plus Rumble's total comment count (replies included). Only
        publicly available data is returned.
      parameters:
        - name: url
          in: query
          required: true
          description: >-
            The video's URL (rumble.com/v<id>-<title>.html,
            rumble.com/shorts/v<id> or rumble.com/embed/v<id>/).
          schema:
            type: string
          example: >-
            https://rumble.com/v7hvcx6-71-of-voters-say-congress-isnt-doing-enough-to-check-trump.html
        - name: cache_max_age
          in: query
          required: false
          description: >-
            Optional. Return a cached result if one this age or newer exists —
            served for **0 credits** with `meta.cached=true` and
            `meta.cachedAt`. Otherwise a fresh scrape runs (**1 credit**) and
            refreshes the cache. Omit to always scrape fresh.
          schema:
            type: string
            enum:
              - 1d
              - 3d
              - 7d
              - 14d
              - 30d
          example: 7d
      responses:
        '200':
          description: Every top-level comment (none when there are none).
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      video:
                        type: object
                      totalComments:
                        type: integer
                        nullable: true
                      comments:
                        type: array
                        items:
                          type: object
                      count:
                        type: integer
                      fetchedAt:
                        type: string
                        format: date-time
                  meta:
                    type: object
                    description: >-
                      requestId + credit/caching metadata (creditsCharged,
                      creditsRemaining, cached, cachedAt).
                required:
                  - data
                  - meta
              example:
                data:
                  video:
                    id: v7hvcx6
                    url: >-
                      https://rumble.com/v7hvcx6-71-of-voters-say-congress-isnt-doing-enough-to-check-trump.html
                    title: >-
                      71% of Voters Say Congress Isn't Doing Enough to CHECK
                      Trump
                  totalComments: 44
                  comments:
                    - id: '621320128'
                      url: >-
                        https://rumble.com/v7hvcx6-71-of-voters-say-congress-isnt-doing-enough-to-check-trump.html#comment-621320128
                      text: >-
                        People are irritated because they don't know what life
                        can really be like.


                        It's that simple.


                        Few people in America have had to live a life of fear of
                        starvation, or live without basic water and electricity.


                        Prices went up, and so they think they are working
                        through the great depression all of a sudden.


                        Trump was no worse than anyone else, and once their
                        "villain" is gone they'll just pick someone else because
                        until they have to actually live in a shit hole they'll
                        never take the responsibility for their own choices.


                        Honestly I just hope that if things are gonna go south
                        it happens sooner rather than later. I'd rather the
                        people that pushed for something suffer the consequences
                        instead of their kids.
                      links: []
                      author: Samohtd
                      authorType: user
                      authorUrl: https://rumble.com/user/Samohtd
                      authorAvatarUrl: >-
                        https://hugh.cdn.rumble.cloud/video/z0/r/f/1/U/rf1Ub.asF.3-hapn5-sw8g94.png
                      authorBadges: []
                      createdAt: '2026-11-06T19:30:00.000Z'
                      createdText: 19 hours ago
                      likes: 11
                      dislikes: 2
                      replyCount: 3
                    - id: '621321846'
                      url: >-
                        https://rumble.com/v7hvcx6-71-of-voters-say-congress-isnt-doing-enough-to-check-trump.html#comment-621321846
                      text: >-
                        I’m thankful they’ll come for TimCast before they’ll
                        come for me. I didn’t sit on the fence for a decade.
                      links: []
                      author: LeskoBrandonne
                      authorType: user
                      authorUrl: https://rumble.com/user/LeskoBrandonne
                      authorAvatarUrl: >-
                        https://hugh.cdn.rumble.cloud/video/z0/3/o/I/m/3oImd.asF.7-vx7lj-tnzzor.jpeg
                      authorBadges: []
                      createdAt: '2026-11-06T19:55:00.000Z'
                      createdText: 18 hours ago
                      likes: 5
                      dislikes: 2
                      replyCount: 0
                    - id: '621325724'
                      url: >-
                        https://rumble.com/v7hvcx6-71-of-voters-say-congress-isnt-doing-enough-to-check-trump.html#comment-621325724
                      text: >-
                        Congress isn't doing enough period and neither is the
                        Senate. Vacation.. work one day.. vacation.. vacation..
                        work half a day.. vacation.
                      links: []
                      author: XyllianHartz
                      authorType: user
                      authorUrl: https://rumble.com/user/XyllianHartz
                      authorAvatarUrl: null
                      authorBadges: []
                      createdAt: '2026-11-06T20:51:00.000Z'
                      createdText: 17 hours ago
                      likes: 3
                      dislikes: 0
                      replyCount: 1
                  count: 22
                  fetchedAt: '2026-11-07T14:48:48.853Z'
                meta:
                  requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f
                  creditsCharged: 1
                  creditsRemaining: 4999
                  cached: false
        '401':
          description: Missing, invalid, or revoked API key.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                error:
                  code: UNAUTHORIZED
                  message: API key required — pass it in the `x-api-key` header.
                  requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f
        '402':
          description: Not enough credits for this request.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                error:
                  code: INSUFFICIENT_CREDITS
                  message: >-
                    This request costs 1 credit, but your balance is 0. Top up
                    to continue.
                  requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f
        '404':
          description: No such video (it may not exist, be private or have been removed).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                error:
                  code: NOT_FOUND
                  message: >-
                    The requested content was not found (it may not exist, be
                    deleted, or be private).
                  requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f
        '422':
          description: Invalid query parameters (`url` must be a Rumble video URL).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                error:
                  code: VALIDATION_ERROR
                  message: Request validation failed
                  requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f
                  details:
                    - path: url
                      message: url is required
        '429':
          description: Over the per-minute rate limit — honour `Retry-After`.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                error:
                  code: RATE_LIMITED
                  message: >-
                    Rate limit exceeded — max 100 requests per 60s. Retry in
                    ~30s.
                  requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f
        '503':
          description: >-
            Temporarily unavailable — retry after `Retry-After`. `error.code`
            tells you why: `UPSTREAM_BLOCKED` (the source blocked this request),
            `EXTRACTION_FAILED` (the source returned unexpected data),
            `PLATFORM_UNAVAILABLE` (the source is down), or
            `SERVICE_UNAVAILABLE` (we are at capacity).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                error:
                  code: UPSTREAM_BLOCKED
                  message: >-
                    The source is temporarily unavailable. Please try again
                    shortly.
                  requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f
components:
  schemas:
    Error:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              example: NOT_FOUND
            message:
              type: string
              example: The requested content was not found.
            requestId:
              type: string
              example: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f
            details:
              type: array
              items:
                type: object
              description: Present on validation errors.
          required:
            - code
            - message
            - requestId
      required:
        - error
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: >-
        Your API key. Send it in the `x-api-key` header (or `Authorization:
        Bearer <key>`). Create and manage keys from your dashboard.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.