# Rumble API guide



## Choose a Rumble operation



Start with the object your task needs. The groups below use the current catalogue; open an endpoint to check accepted identifiers, filters, price and availability before retrieving.



### Posts and media



- [Rumble channel videos](https://www.monocrawl.com/docs/endpoints/rumble/channel-videos) — A channel's videos, newest first, one page at a time, with the channel's name, URL and handle.

- [Rumble video](https://www.monocrawl.com/docs/endpoints/rumble/video) — One video: title, description, duration, publish time, views, likes and dislikes, channel, embed URL and caption languages.



### Search and discovery



- [Rumble search](https://www.monocrawl.com/docs/endpoints/rumble/search) — Videos and shorts matching a query on Rumble, with views, duration, publish time and channel.



### Comments and replies



- [Rumble video comments](https://www.monocrawl.com/docs/endpoints/rumble/video-comments) — Comments on a video: text, time, likes, dislikes, reply count and author.



### Transcripts



- [Rumble video transcript](https://www.monocrawl.com/docs/endpoints/rumble/video-transcript) — The transcript of a video, with its language; has_transcript is false when there are no captions.



## Check fields and collection limits



Use the endpoint’s declared parameters and returned continuation. Filters from another platform do not automatically apply here. Preserve source identifiers, URLs and warnings; a successful page does not establish complete history. Published response schemas identify whether they come from a reviewed shaper or observed response shapes.



Agents can use `get_endpoint` for the current contract and `get_docs` with topic `platforms/rumble` to read this page. The [coverage guide](https://www.monocrawl.com/docs/data-availability) explains nulls and partial results, and the [production guide](https://www.monocrawl.com/docs/production-checklist) covers budgets and recovery.



## Endpoint reference

## rumble/channel-videos

`GET /v1/rumble/channel-videos`

A channel's videos, newest first, one page at a time, with the channel's name, URL and handle.

*Rumble channel videos*

| Parameter | Required | Description |
| --- | --- | --- |
| `url` | yes | Channel URL (or pass handle) — e.g. `https://rumble.com/c/nasa` |
| `handle` | no | Channel handle, instead of url — e.g. `nasa` |
| `cursor` | no | Opaque cursor from the previous page |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |

### Useful optional inputs

- `cursor`: Continue the same source traversal with the complete returned cursor. Saved-result retrieval and a new source page can have different prices; quote the next call.
- `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees.

**Cost:** 2 credits at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/rumble/channel-videos?url=https%3A%2F%2Frumble.com%2Fc%2Fnasa" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "items": [],
  "cursor": null
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/rumble/channel-videos#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/rumble/channel-videos.json)


## rumble/search

`GET /v1/rumble/search`

Videos and shorts matching a query on Rumble, with views, duration, publish time and channel.

*Rumble search*

| Parameter | Required | Description |
| --- | --- | --- |
| `query` | yes | Search query — e.g. `rocket launch` |
| `cursor` | no | Opaque cursor from the previous page |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |

### Useful optional inputs

- `cursor`: Continue the same source traversal with the complete returned cursor. Saved-result retrieval and a new source page can have different prices; quote the next call.
- `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees.

**Cost:** 2 credits at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/rumble/search?query=rocket%20launch" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "cursor": null,
  "dropped": 0,
  "items": [
    {
      "channel": {
        "handle": "example",
        "name": "example",
        "url": "https://example.com/example"
      },
      "id": "example",
      "kind": "example",
      "platform": "example",
      "published_at": "2026-09-01T12:00:00Z",
      "thumbnail_url": "https://example.com/example",
      "title": "example",
      "url": "https://example.com/example",
      "views": 0
    }
  ],
  "shorts": []
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/rumble/search#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/rumble/search.json)


## rumble/video

`GET /v1/rumble/video`

One video: title, description, duration, publish time, views, likes and dislikes, channel, embed URL and caption languages.

*Rumble video*

| Parameter | Required | Description |
| --- | --- | --- |
| `url` | yes | Video URL — e.g. `https://rumble.com/v784xoi-president-donald-j.-trump-and-secwar-pete-hegseth-hold-a-press-conference-a.html` |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |

### Useful optional inputs

- `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees.

**Cost:** 2 credits at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/rumble/video?url=https%3A%2F%2Frumble.com%2Fv784xoi-president-donald-j.-trump-and-secwar-pete-hegseth-hold-a-press-conference-a.html" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "caption_languages": [
    "example"
  ],
  "channel": {
    "handle": "example",
    "name": "example",
    "url": "https://example.com/example"
  },
  "description": "example",
  "dislikes": 0,
  "duration_s": 0,
  "embed_url": "https://example.com/example",
  "id": "example",
  "is_live": false,
  "likes": 0,
  "platform": "example",
  "published_at": "2026-09-01T12:00:00Z",
  "thumbnail_url": "https://example.com/example",
  "title": "example",
  "url": "https://example.com/example",
  "views": 0
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/rumble/video#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/rumble/video.json)


## rumble/video-comments

`GET /v1/rumble/video-comments`

Comments on a video: text, time, likes, dislikes, reply count and author.

*Rumble video comments*

| Parameter | Required | Description |
| --- | --- | --- |
| `url` | yes | Video URL — e.g. `https://rumble.com/v784xoi-president-donald-j.-trump-and-secwar-pete-hegseth-hold-a-press-conference-a.html` |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |

### Useful optional inputs

- `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees.

**Cost:** 2 credits at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/rumble/video-comments?url=https%3A%2F%2Frumble.com%2Fv784xoi-president-donald-j.-trump-and-secwar-pete-hegseth-hold-a-press-conference-a.html" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "_meta": {
    "billing": {
      "charged": 0,
      "list_price": 0,
      "reason": "example"
    }
  },
  "count": 0,
  "items": [],
  "video_id": "example"
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/rumble/video-comments#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/rumble/video-comments.json)


## rumble/video-transcript

`GET /v1/rumble/video-transcript`

The transcript of a video, with its language; has_transcript is false when there are no captions.

*Rumble video transcript*

| Parameter | Required | Description |
| --- | --- | --- |
| `url` | yes | Video URL — e.g. `https://rumble.com/v784xoi-president-donald-j.-trump-and-secwar-pete-hegseth-hold-a-press-conference-a.html` |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |

### Useful optional inputs

- `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees.

**Cost:** 5 credits at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/rumble/video-transcript?url=https%3A%2F%2Frumble.com%2Fv784xoi-president-donald-j.-trump-and-secwar-pete-hegseth-hold-a-press-conference-a.html" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "has_transcript": false,
  "id": "example",
  "language": "example",
  "platform": "example",
  "transcript": "example",
  "url": "https://example.com/example"
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/rumble/video-transcript#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/rumble/video-transcript.json)