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

# Rumble Videos API

> Rumble videos with title, URL, short flag, views, likes and dislikes. Search by keyword or pass channel URLs.

`POST /v1/data/rumble/videos/run`

**Pricing:** $0.003 per video ($3.00 per 1,000).

## Ways to call it

* **Search Keywords**: set `queries` (optional: `maxResults`, `sortBy`, `uploadDate`, `duration`)
* **Channel URLs**: set `channelUrls` (optional: `maxResults`, `sortBy`, `uploadDate`, `duration`)

## Request

Send the inputs under `params`. Only the keys below are accepted; any other key returns `422 invalid_params`.

**queries** `string[]`

One or more search keywords. One request reads them all.

**channelUrls** `string[]`

One or more channel urls. One request reads them all.

Format e.g. `https://www.example.com`.

**maxResults** `integer` (default: 100)

How many videos to return in total. Defaults to 100; use 0 for all.

**sortBy** `string`

Sort By to use.

Allowed values: `relevance` (Relevance), `views` (Most viewed), `date` (Most recent), `rumbles` (Most rumbles (votes)).

**uploadDate** `string`

Upload Date to use.

Allowed values: `today` (Today), `this-week` (This week), `this-month` (This month), `this-year` (This year).

**duration** `string`

Duration to use.

Allowed values: `short` (Short (under 5 minutes)), `long` (Long (over 20 minutes)).

## Example

```bash cURL theme={null}
curl -X POST "https://api.mindcase.co/v1/data/rumble/videos/run?wait=true" \
  -H "Authorization: Bearer $MINDCASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "params": {
    "queries": [
      "bitcoin"
    ],
    "maxResults": 10
  }
}'
```

```python Python theme={null}
import os, requests

r = requests.post(
    "https://api.mindcase.co/v1/data/rumble/videos/run",
    params={"wait": "true"},
    headers={"Authorization": f"Bearer {os.environ['MINDCASE_API_KEY']}"},
    json={"params": {
    "queries": [
        "bitcoin"
    ],
    "maxResults": 10
}},
)
job = r.json()
rows = job.get("data", [])  # if job["status"] == "running", poll /v1/jobs/{job_id}/results
```

```javascript Node.js theme={null}
const r = await fetch("https://api.mindcase.co/v1/data/rumble/videos/run?wait=true", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.MINDCASE_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ params: {
  "queries": [
    "bitcoin"
  ],
  "maxResults": 10
} }),
});
const job = await r.json();
const rows = job.data ?? []; // if job.status === "running", poll /v1/jobs/{job_id}/results
```

## Response fields

Each row in `data` is one video, keyed by these fields.

| Field | Name | Type |
| - | - | - |
| `videoId` | Video ID | text |
| `title` | Title | text |
| `videoUrl` | Video URL | url |
| `isShort` | Is Short | boolean |
| `views` | Views | number |
| `likes` | Likes | number |
| `dislikes` | Dislikes | number |
| `comments` | Comments | number |
| `durationS` | Duration S | number |
| `published` | Published | text |
| `description` | Description | text |
| `categories` | Categories | array |
| `tags` | Tags | array |
| `isLive` | Is Live | boolean |
| `thumbnail` | Thumbnail | url |
| `availableCaptions` | Available Captions | object\_array |
| `channel` | Channel | text |
| `channelId` | Channel ID | text |
| `channelHandle` | Channel Handle | text |
| `channelUrl` | Channel URL | url |
| `followers` | Followers | number |
| `channelVerified` | Channel Verified | boolean |
| `channelBadges` | Channel Badges | text |
| `channelAvatar` | Channel Avatar | image |
| `sourceQuery` | Source Query | text |

## Example response

Abridged: long text and lists are shortened.

```json theme={null}
{
  "job_id": "7f3a1c2e-0b9d-4c55-9a51-3f2e8d1b6a40",
  "agent": "rumble/videos",
  "status": "completed",
  "row_count": 1,
  "truncated": false,
  "data": [
    {
      "channelUrl": "https://rumble.com/c/TheAlphaWarriorShow",
      "channelVerified": true,
      "videoUrl": "https://rumble.com/v7hlhmq-do-you-remember-q-meets-bitcoin.html",
      "published": "2026-10-30T06:04:40+00:00",
      "followers": 70570,
      "channelBadges": "premium",
      "dislikes": 9,
      "description": "TODAYS EPISODE SPONSOR: • PETCLUB: • PetClub247 Humans: https://alphawarriorshow.petclub247.com/shop.html?catekey=productsforhumans\n\nThe AlphaWarrior Show\nTh...",
      "availableCaptions": [
        {
          "languageCode": "en-auto",
          "language": "English (auto)",
          "url": "https://hugh.cdn.rumble.cloud/video/fww1/d4/s8/11/c/M/x/_/cMx_A.fn8Si.vtt"
        }
      ],
      "likes": 162,
      "views": 23501,
      "tags": [],
      "isShort": false,
      "channelHandle": "TheAlphaWarriorShow",
      "comments": 10,
      "videoId": "v7hlhmq",
      "categories": [
        "Podcasts",
        "Conspiracies"
      ],
      "channel": "AlphaWarrior Show",
      "sourceQuery": "bitcoin",
      "title": "DO YOU REMEMBER? Q MEETS BITCOIN!",
      "thumbnail": "https://hugh.cdn.rumble.cloud/video/fww1/d4/s8/1/c/M/x/_/cMx_A.OvCc-small-DO-YOU-REMEMBER-Q-MEETS-BIT..jpg",
      "channelAvatar": "https://hugh.cdn.rumble.cloud/video/z8/U/g/d/e/Ugdea.baa.2-TheAlphaWarriorShow-s6yily.jpeg",
      "isLive": false,
      "durationS": 10997,
      "channelId": "_c1061294"
    }
  ]
}
```


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