> ## 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.

# Search

> Searches Rumble videos by keyword, 25 per page in Rumble's order: each with its title, link, thumbnail, length, exact upload time, views (rounded, as Rumble shows them), likes, dislikes and comment count, and its channel (name, handle, link, id and verified badge). Pass the returned `cursor` back (with the same query) for the next page. 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/search. Here are the details:
>
> Endpoint: GET https://api.scraperize.com/v1/rumble/search
> Description: Searches Rumble videos by keyword, 25 per page in Rumble's order: each with its title, link, thumbnail, length, exact upload time, views (rounded, as Rumble shows them), likes, dislikes and comment count, and its channel (name, handle, link, id and verified badge). Pass the returned `cursor` back (with the same query) for the next page. Only publicly available data is returned.
>
> Required Headers:
> - x-api-key: Your API key
>
> Parameters:
> - query (string) [required]: What to search for.
> - cursor (string): The `cursor` from the previous page, to get the next one. Omit for the first page.
> - 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": {
>     "query": "bitcoin",
>     "page": 1,
>     "videos": [
>       {
>         "id": "v7hvm2g",
>         "videoId": "449635714",
>         "url": "https://rumble.com/v7hvm2g-midterm-massacre-launches-bitcoin-above-80000.html",
>         "title": "Midterm Massacre LAUNCHES Bitcoin Above $80,000!",
>         "thumbnailUrl": "https://hugh.cdn.rumble.cloud/video/fwe2/ef/s8/1/4/5/k/b/45kbB.oq1b-small-Midterm-Massacre-LAUNCHES-B..jpg",
>         "durationSeconds": 868,
>         "uploadedAt": "2026-11-04T23:48:18.000Z",
>         "views": 1600,
>         "likes": 24,
>         "dislikes": 0,
>         "commentCount": 1,
>         "repostCount": null,
>         "width": null,
>         "height": null,
>         "isShort": null,
>         "isLive": null,
>         "streamedAt": null,
>         "scheduledAt": null,
>         "watchingNow": null,
>         "isAgeRestricted": null,
>         "visibility": null,
>         "tags": [],
>         "mp4s": [],
>         "hlsUrl": null,
>         "channel": {
>           "id": "1794015",
>           "name": "Simply Bitcoin",
>           "handle": "SimplyBitcoin",
>           "url": "https://rumble.com/c/SimplyBitcoin",
>           "avatarUrl": null,
>           "followers": null,
>           "isVerified": true
>         }
>       }
>     ],
>     "count": 25,
>     "cursor": "eyJxIjoiYml0Y29pbiIsInAiOjJ9",
>     "hasMore": true,
>     "fetchedAt": "2026-11-07T14:48:49.918Z"
>   },
>   "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/search
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/search:
    get:
      tags:
        - Rumble
      summary: Search
      description: >-
        Searches Rumble videos by keyword, 25 per page in Rumble's order: each
        with its title, link, thumbnail, length, exact upload time, views
        (rounded, as Rumble shows them), likes, dislikes and comment count, and
        its channel (name, handle, link, id and verified badge). Pass the
        returned `cursor` back (with the same query) for the next page. Only
        publicly available data is returned.
      parameters:
        - name: query
          in: query
          required: true
          description: What to search for.
          schema:
            type: string
          example: bitcoin
        - name: cursor
          in: query
          required: false
          description: >-
            The `cursor` from the previous page, to get the next one. Omit for
            the first page.
          schema:
            type: string
        - 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: One page of videos (empty when nothing matches).
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      query:
                        type: string
                      page:
                        type: integer
                      videos:
                        type: array
                        items:
                          type: object
                      count:
                        type: integer
                      cursor:
                        type: string
                        nullable: true
                      hasMore:
                        type: boolean
                      fetchedAt:
                        type: string
                        format: date-time
                  meta:
                    type: object
                    description: >-
                      requestId + credit/caching metadata (creditsCharged,
                      creditsRemaining, cached, cachedAt).
                required:
                  - data
                  - meta
              example:
                data:
                  query: bitcoin
                  page: 1
                  videos:
                    - id: v7hvm2g
                      videoId: '449635714'
                      url: >-
                        https://rumble.com/v7hvm2g-midterm-massacre-launches-bitcoin-above-80000.html
                      title: Midterm Massacre LAUNCHES Bitcoin Above $80,000!
                      thumbnailUrl: >-
                        https://hugh.cdn.rumble.cloud/video/fwe2/ef/s8/1/4/5/k/b/45kbB.oq1b-small-Midterm-Massacre-LAUNCHES-B..jpg
                      durationSeconds: 868
                      uploadedAt: '2026-11-04T23:48:18.000Z'
                      views: 1600
                      likes: 24
                      dislikes: 0
                      commentCount: 1
                      repostCount: null
                      width: null
                      height: null
                      isShort: null
                      isLive: null
                      streamedAt: null
                      scheduledAt: null
                      watchingNow: null
                      isAgeRestricted: null
                      visibility: null
                      tags: []
                      mp4s: []
                      hlsUrl: null
                      channel:
                        id: '1794015'
                        name: Simply Bitcoin
                        handle: SimplyBitcoin
                        url: https://rumble.com/c/SimplyBitcoin
                        avatarUrl: null
                        followers: null
                        isVerified: true
                    - id: v7hxda8
                      videoId: '449717642'
                      url: >-
                        https://rumble.com/v7hxda8-bitcoin-dumped-is-a-democratic-congress-bullish-or-bearish.html
                      title: >-
                        Bitcoin Dumped! Is a Democratic Congress Bullish or
                        Bearish?
                      thumbnailUrl: >-
                        https://hugh.cdn.rumble.cloud/video/fwe2/d4/s8/1/a/6/E/b/a6EbB.oq1b-small-Bitcoin-Dumped-Is-a-Democra..jpg
                      durationSeconds: 976
                      uploadedAt: '2026-11-05T23:31:28.000Z'
                      views: 1260
                      likes: 22
                      dislikes: 0
                      commentCount: 1
                      repostCount: null
                      width: null
                      height: null
                      isShort: null
                      isLive: null
                      streamedAt: null
                      scheduledAt: null
                      watchingNow: null
                      isAgeRestricted: null
                      visibility: null
                      tags: []
                      mp4s: []
                      hlsUrl: null
                      channel:
                        id: '1794015'
                        name: Simply Bitcoin
                        handle: SimplyBitcoin
                        url: https://rumble.com/c/SimplyBitcoin
                        avatarUrl: null
                        followers: null
                        isVerified: true
                    - id: v7hv7uq
                      videoId: '449617292'
                      url: >-
                        https://rumble.com/v7hv7uq-cory-klippsten-why-id-sell-100k-of-stocks-for-65k-of-bitcoin.html
                      title: >-
                        Cory Klippsten: Why I'd Sell $100K of Stocks for $65K of
                        Bitcoin
                      thumbnailUrl: >-
                        https://hugh.cdn.rumble.cloud/video/fwe2/f0/s8/1/c/A/g/b/cAgbB.oq1b-small-Cory-Klippsten-Why-Id-Sell-..jpg
                      durationSeconds: 1308
                      uploadedAt: '2026-11-04T19:12:11.000Z'
                      views: 1090
                      likes: 5
                      dislikes: 0
                      commentCount: 5
                      repostCount: null
                      width: null
                      height: null
                      isShort: null
                      isLive: null
                      streamedAt: null
                      scheduledAt: null
                      watchingNow: null
                      isAgeRestricted: null
                      visibility: null
                      tags: []
                      mp4s: []
                      hlsUrl: null
                      channel:
                        id: '1473303'
                        name: Bitcoin Magazine
                        handle: BitcoinMagazine
                        url: https://rumble.com/c/BitcoinMagazine
                        avatarUrl: null
                        followers: null
                        isVerified: true
                  count: 25
                  cursor: eyJxIjoiYml0Y29pbiIsInAiOjJ9
                  hasMore: true
                  fetchedAt: '2026-11-07T14:48:49.918Z'
                meta:
                  requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f
                  creditsCharged: 1
                  creditsRemaining: 4999
                  cached: false
        '400':
          description: Invalid or expired cursor (or one for another query).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                error:
                  code: BAD_REQUEST
                  message: The request was invalid.
                  requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f
        '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
        '422':
          description: Invalid query parameters (`query` is required).
          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.