Search Rumble videos

Try in Playground

Read one page of the public Videos search tab by keyword.

GET/v1/rumble/searchx-api-key

Headers

Get your API key

x-api-keystringrequiredheader

Your ScrapeAtlas customer key. Create one on /account/ and set SCRAPEATLAS_API_KEY.

Query parameters

querystringrequiredquery

Required trimmed keyword query, 1–200 characters.

min 1 chars · max 200 chars

Examplewaterfalls

cursorstringquery

Optional next page number, or null. Input is a decimal integer from 1 through 999; one page per request.

Response fields

requestIdstring

Request correlation UUID.

Upstream attempts, decoded response bytes delivered to the HTML reader, and elapsed milliseconds. An interrupted browser transfer may not be included in responseBytes.

accounting.upstreamRequestsinteger

Always included.

≥ 0

accounting.responseBytesinteger

Always included.

≥ 0

accounting.durationMsnumber

Always included.

≥ 0

successboolean

True when usable public data is returned.

statusenum

success, partial, failed or challenged. HTTP 200 may be partial.

one of: success, partial

sourceUrlstring

Public source page fetched, including this page number.

absolute HTTPS URL

fetchedAtstring

UTC retrieval timestamp.

Complete means the supported records of this page. Warnings include malformed_item, restricted_item, channel_mismatch, unsupported_item, record_limit, featured_video_omitted, shorts_shelf_unavailable, invalid_pagination and page_limit.

coverage.sourcestring

Always included.

coverage.completeboolean

Always included.

coverage.warningsstring[]

Always included.

Public video/live entries in source order. At most 100 returned records across both arrays.

up to 100 items

videos.idstring

Always included.

videos.urlstring

Always included.

absolute HTTPS URL

videos.titlestring

Always included.

min 1 chars

videos.typeenum

Always included.

one of: video, short, live

videos.thumbnailstringnullable

Always included.

videos.durationstringnullable

Always included.

videos.durationSecondsintegernullable

Always included.

videos.publishedAtstringnullable

Always included.

videos.publishedTextstringnullable

Always included.

videos.viewCountTextstringnullable

Always included.

videos.viewCountIntintegernullable

Always included.

videos.channel.namestringnullable

Always included.

videos.channel.urlstring

Always included.

absolute HTTPS URL

videos.channel.handlestring

Always included.

videos.channel.verifiedbooleannullable

Always included.

Shorts present in the embedded video grids; separately loaded shelves are flagged.

up to 100 items

shorts.idstring

Always included.

shorts.urlstring

Always included.

absolute HTTPS URL

shorts.titlestring

Always included.

min 1 chars

shorts.typeenum

Always included.

one of: video, short, live

shorts.thumbnailstringnullable

Always included.

shorts.durationstringnullable

Always included.

shorts.durationSecondsintegernullable

Always included.

shorts.publishedAtstringnullable

Always included.

shorts.publishedTextstringnullable

Always included.

shorts.viewCountTextstringnullable

Always included.

shorts.viewCountIntintegernullable

Always included.

shorts.channel.namestringnullable

Always included.

shorts.channel.urlstring

Always included.

absolute HTTPS URL

shorts.channel.handlestring

Always included.

shorts.channel.verifiedbooleannullable

Always included.

cursorstringnullable

Optional next page number, or null. Input is a decimal integer from 1 through 999; one page per request.

HTTP 200 returns the success variant. Check status: partial means usable data with warnings, and failed or challenged requests carry a failure object described in Errors & responses.

Error codes

HTTP	failure.code	Meaning
400	`invalid_request`	Missing, duplicate or unsupported parameters.
401	`unauthorized`	Invalid API key.
404	`not_found`	Source page missing or gone.
429	`upstream_rate_limited`	Source throttled retrieval.
502	`upstream_challenged`	Source challenged access.
502	`unsupported_page`	Missing, malformed or mismatched supported page data.
502	`response_too_large` `payload_too_complex`	Source exceeds parsing limits.
502	`unsafe_redirect` `upstream_error` `request_limit`	Bounded retrieval failed.
503	`busy`	All slots occupied.
504	`timeout`	Total deadline exceeded.

Code example

curl "https://api.scrapeatlas.com/v1/rumble/search?query=waterfalls" \
  -H "x-api-key: YOUR_API_KEY"

const response = await fetch(
  "https://api.scrapeatlas.com/v1/rumble/search?query=waterfalls",
  {
    headers: {
      "x-api-key": "YOUR_API_KEY"
    }
  }
);

const data = await response.json();
console.log(data.status, data);

type Result = {
  status: "success" | "partial" | "failed" | "challenged";
  requestId: string;
  [field: string]: unknown;
};

const response = await fetch(
  "https://api.scrapeatlas.com/v1/rumble/search?query=waterfalls",
  {
    headers: {
      "x-api-key": process.env.SCRAPEATLAS_API_KEY!
    }
  }
);

const data = (await response.json()) as Result;
if (data.status === "failed" || data.status === "challenged") {
  throw new Error(`Rumble request failed: ${data.requestId}`);
}
console.log(data);

import requests

response = requests.get(
    "https://api.scrapeatlas.com/v1/rumble/search",
    headers={"x-api-key": "YOUR_API_KEY"},
    params={
        "query": "waterfalls"
    },
    timeout=60,
)
data = response.json()
print(data["status"], data)

package main

import (
	"encoding/json"
	"fmt"
	"net/http"
)

func main() {
	req, _ := http.NewRequest("GET", "https://api.scrapeatlas.com/v1/rumble/search?query=waterfalls", nil)
	req.Header.Set("x-api-key", "YOUR_API_KEY")
	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	var data map[string]interface{}
	json.NewDecoder(resp.Body).Decode(&data)
	fmt.Println(data["status"], data)
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Main {
    public static void main(String[] args) throws Exception {
        var client = HttpClient.newHttpClient();
        var request = HttpRequest.newBuilder()
            .uri(URI.create("https://api.scrapeatlas.com/v1/rumble/search?query=waterfalls"))
            .GET()
            .header("x-api-key", "YOUR_API_KEY")
            .build();
        var response = client.send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.body());
    }
}

Use your sa_live_… customer key at https://api.scrapeatlas.com.

Responses

Successful result. Synthetic example validated against the runtime contract.

{
  "success": true,
  "status": "success",
  "requestId": "00000000-0000-4000-8000-000000000001",
  "sourceUrl": "https://rumble.com/search/video?q=waterfalls",
  "fetchedAt": "2026-09-11T00:00:00.000Z",
  "coverage": {
    "source": "public_page",
    "complete": true,
    "warnings": []
  },
  "accounting": {
    "upstreamRequests": 1,
    "responseBytes": 250000,
    "durationMs": 900
  },
  "videos": [
    {
      "id": "v123abc",
      "url": "https://rumble.com/v123abc-waterfall.html",
      "title": "Waterfall & forest",
      "type": "video",
      "thumbnail": "https://example.com/thumb.jpg",
      "duration": "1:23",
      "durationSeconds": 83,
      "publishedAt": "2026-09-10T12:00:00+00:00",
      "publishedText": "1 day ago",
      "viewCountText": "1.2K",
      "viewCountInt": null,
      "channel": {
        "name": "Example",
        "url": "https://rumble.com/c/Example",
        "handle": "Example",
        "verified": true
      }
    }
  ],
  "shorts": [],
  "cursor": "2"
}

Missing, duplicate or unsupported parameters.

{
  "requestId": "9d2f1c0a-6b1e-4c7d-9a8e-2f3b4c5d6e7f",
  "accounting": {
    "upstreamRequests": 0,
    "responseBytes": 0,
    "durationMs": 0
  },
  "success": false,
  "status": "failed",
  "failure": {
    "code": "invalid_request",
    "message": "Invalid request: missing, duplicate, unsupported or malformed parameters."
  }
}