Use cases
What teams build with it. From one request.
- Monitor a Rumble channel for new uploads and live streams
- Export a creator's full Rumble catalog
- Find a channel's most viewed videos or shorts
- Track a creator's scheduled and past live streams
What you get
Posts in one schema. The same on every platform.
platformstring- Platform ID (tiktok, youtube, …).
idstring- Platform-native post ID (string; Instagram shortcode, Reddit without t3_).
urlstring- Canonical post URL.
typestring- Normalized content shape. New values may be added; treat unknown values as other.
platform_typestring- The platform's own product label, lowercase (reel, short, story, live, tweet, …).
titlestring- Headline (YouTube title, Reddit title); null on caption-only platforms.
textstring- Caption, description or body as plain text.
languagestring- BCP-47 language of text, when the platform states it.
Every field, its type and when it is null: the response reference and the post schema.
Example request
curl -G 'https://staging.socialtap.dev/v1/rumble/posts' \
--data-urlencode 'handle=Bongino' \
-H "x-api-key: $SOCIALTAP_API_KEY"const params = new URLSearchParams({
handle: "Bongino",
});
const res = await fetch(`https://staging.socialtap.dev/v1/rumble/posts?${params}`, {
headers: { "x-api-key": process.env.SOCIALTAP_API_KEY ?? "" },
});
const body = await res.json();
if (!res.ok) throw new Error(`${body.error.code}: ${body.error.message}`);
const { data, page, meta } = body;
console.log(data, meta.credits_charged);import os
import requests
res = requests.get(
"https://staging.socialtap.dev/v1/rumble/posts",
params={"handle": "Bongino"},
headers={"x-api-key": os.environ["SOCIALTAP_API_KEY"]},
)
body = res.json()
if not res.ok:
raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
data, page, meta = body["data"], body["page"], body["meta"]
print(data, meta["credits_charged"])package main
import (
"encoding/json"
"fmt"
"log"
"net/http"
"net/url"
"os"
)
func main() {
q := url.Values{}
q.Set("handle", "Bongino")
req, err := http.NewRequest("GET", "https://staging.socialtap.dev/v1/rumble/posts?"+q.Encode(), nil)
if err != nil {
log.Fatal(err)
}
req.Header.Set("x-api-key", os.Getenv("SOCIALTAP_API_KEY"))
res, err := http.DefaultClient.Do(req)
if err != nil {
log.Fatal(err)
}
defer res.Body.Close()
var body struct {
Data json.RawMessage `json:"data"`
Page json.RawMessage `json:"page"`
Meta map[string]any `json:"meta"`
Error *struct {
Code string `json:"code"`
Message string `json:"message"`
} `json:"error"`
}
if err := json.NewDecoder(res.Body).Decode(&body); err != nil {
log.Fatal(err)
}
if body.Error != nil {
log.Fatalf("%s: %s", body.Error.Code, body.Error.Message)
}
fmt.Println(string(body.Data), body.Meta["credits_charged"])
}<?php
$query = http_build_query([
'handle' => 'Bongino',
]);
$ch = curl_init('https://staging.socialtap.dev/v1/rumble/posts?' . $query);
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['x-api-key: ' . getenv('SOCIALTAP_API_KEY')],
]);
$body = json_decode(curl_exec($ch), true);
if (curl_getinfo($ch, CURLINFO_RESPONSE_CODE) >= 400) {
throw new RuntimeException($body['error']['code'] . ': ' . $body['error']['message']);
}
print_r($body['data']);
echo $body['meta']['credits_charged'], PHP_EOL;require "json"
require "net/http"
uri = URI("https://staging.socialtap.dev/v1/rumble/posts")
uri.query = URI.encode_www_form('handle' => 'Bongino')
req = Net::HTTP::Get.new(uri)
req["x-api-key"] = ENV.fetch("SOCIALTAP_API_KEY")
res = Net::HTTP.start(uri.host, uri.port, use_ssl: uri.scheme == "https") { |http| http.request(req) }
body = JSON.parse(res.body)
raise "#{body["error"]["code"]}: #{body["error"]["message"]}" unless res.is_a?(Net::HTTPSuccess)
pp body["data"]
puts body["meta"]["credits_charged"]import java.net.URI;
import java.net.URLEncoder;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.nio.charset.StandardCharsets;
public class Main {
public static void main(String[] args) throws Exception {
String query = "handle=" + encode("Bongino");
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://staging.socialtap.dev/v1/rumble/posts?" + query))
.header("x-api-key", System.getenv("SOCIALTAP_API_KEY"))
.GET()
.build();
HttpResponse<String> response = HttpClient.newHttpClient()
.send(request, HttpResponse.BodyHandlers.ofString());
// An error is {"error": {"code", "message", ...}}; success is {data, meta}, meta.credits_charged its price.
if (response.statusCode() >= 400) throw new RuntimeException(response.body());
System.out.println(response.body());
}
static String encode(String value) {
return URLEncoder.encode(value, StandardCharsets.UTF_8);
}
}using System.Text.Json;
using var http = new HttpClient();
http.DefaultRequestHeaders.Add("x-api-key", Environment.GetEnvironmentVariable("SOCIALTAP_API_KEY"));
var query = string.Join("&",
"handle=" + Uri.EscapeDataString("Bongino"));
var res = await http.GetAsync("https://staging.socialtap.dev/v1/rumble/posts?" + query);
using var body = JsonDocument.Parse(await res.Content.ReadAsStringAsync());
if (!res.IsSuccessStatusCode)
{
var error = body.RootElement.GetProperty("error");
throw new Exception($"{error.GetProperty("code")}: {error.GetProperty("message")}");
}
Console.WriteLine(body.RootElement.GetProperty("data"));
Console.WriteLine(body.RootElement.GetProperty("meta").GetProperty("credits_charged"));// Cargo.toml: reqwest = { version = "0.12", features = ["blocking", "json"] }, serde_json = "1"
use std::env;
fn main() -> Result<(), Box<dyn std::error::Error>> {
let res = reqwest::blocking::Client::new()
.get("https://staging.socialtap.dev/v1/rumble/posts")
.query(&[("handle", "Bongino")])
.header("x-api-key", env::var("SOCIALTAP_API_KEY")?)
.send()?;
let ok = res.status().is_success();
let body: serde_json::Value = res.json()?;
if !ok {
return Err(format!("{}: {}", body["error"]["code"], body["error"]["message"]).into());
}
println!("{} {}", body["data"], body["meta"]["credits_charged"]);
Ok(())
}{
"data": [
{
"approximate_fields": [],
"author": {
"avatar_url": "https://hugh.cdn.rumble.cloud/video/z8/U/K/d/b/UKdba.baa.4-bongino-t8rqq7.jpeg",
"display_name": "The Dan Bongino Show",
"id": "_c276782",
"is_verified": true,
"url": "https://rumble.com/c/bongino",
"username": "bongino"
},
"coauthors": [],
"duration_ms": 3233000,
"hashtags": [],
"id": "v7haadi",
"is_nsfw": false,
"is_pinned": null,
"is_sponsored": null,
"language": null,
"media": [
{
"alt_text": null,
"duration_ms": 3233000,
"expires_at": null,
"height": 1080,
"thumbnail_url": "https://hugh.cdn.rumble.cloud/video/fww1/25/s8/1/g/a/y/9/gay9A.OvCc-small-Bongino-Weekend-Report-Week..jpg",
"type": "video",
"url": "https://hugh.cdn.rumble.cloud/video/fww1/25/s8/2/g/a/y/9/gay9A.haa.mp4",
"width": 1920
}
],
"mentions": [],
"metrics": {
"comment_count": 80,
"like_count": 1182,
"quote_count": null,
"repost_count": 3,
"save_count": null,
"share_count": null,
"view_count": 207825
},
"platform": "rumble",
"platform_specific": {
"rumble": {
"author_follower_count": 3673478,
"caption_tracks": [],
"category": null,
"concurrent_viewer_count": null,
"dislike_count": 13,
"embed_id": "v7f3xg0",
"embed_url": "https://rumble.com/embed/v7f3xg0/",
"files": [],
"is_age_restricted": false,
"is_live_now": false,
"keywords": [],
"live_started_at": null,
"numeric_id": "448640784",
"scheduled_start_at": null,
"secondary_category": null
}
},
"platform_type": "video",
"published_at": "2026-10-24T11:01:00Z",
"text": null,
"thumbnail_url": "https://hugh.cdn.rumble.cloud/video/fww1/25/s8/1/g/a/y/9/gay9A.OvCc-small-Bongino-Weekend-Report-Week..jpg",
"title": "Bongino Weekend Report - Week of 10/19/26",
"type": "video",
"unknown_fields": [
"hashtags",
"mentions",
"platform_specific.rumble.keywords"
],
"url": "https://rumble.com/v7haadi-bongino-weekend-report-week-of-101926.html"
},
{
"approximate_fields": [],
"author": {
"avatar_url": "https://hugh.cdn.rumble.cloud/video/z8/U/K/d/b/UKdba.baa.4-bongino-t8rqq7.jpeg",
"display_name": "The Dan Bongino Show",
"id": "_c276782",
"is_verified": true,
"url": "https://rumble.com/c/bongino",
"username": "bongino"
},
"coauthors": [],
"duration_ms": 3316000,
"hashtags": [],
"id": "v7gyjd4",
"is_nsfw": false,
"is_pinned": null,
"is_sponsored": null,
"language": null,
"media": [
{
"alt_text": null,
"duration_ms": 3316000,
"expires_at": null,
"height": 1080,
"thumbnail_url": "https://hugh.cdn.rumble.cloud/video/fww1/bd/s8/1/i/k/s/7/iks7A.OvCc-small-Bongino-Weekend-Report-Week..jpg",
"type": "video",
"url": "https://hugh.cdn.rumble.cloud/video/fww1/bd/s8/2/i/k/s/7/iks7A.haa.mp4",
"width": 1920
}
],
"mentions": [],
"metrics": {
"comment_count": 119,
"like_count": 1170,
"quote_count": null,
"repost_count": 2,
"save_count": null,
"share_count": null,
"view_count": 257009
},
"platform": "rumble",
"platform_specific": {
"rumble": {
"author_follower_count": 3673478,
"caption_tracks": [],
"category": null,
"concurrent_viewer_count": null,
"dislike_count": 25,
"embed_id": "v7es6fm",
"embed_url": "https://rumble.com/embed/v7es6fm/",
"files": [],
"is_age_restricted": false,
"is_live_now": false,
"keywords": [],
"live_started_at": null,
"numeric_id": "448092562",
"scheduled_start_at": null,
"secondary_category": null
}
},
"platform_type": "video",
"published_at": "2026-10-17T13:00:00Z",
"text": null,
"thumbnail_url": "https://hugh.cdn.rumble.cloud/video/fww1/bd/s8/1/i/k/s/7/iks7A.OvCc-small-Bongino-Weekend-Report-Week..jpg",
"title": "Bongino Weekend Report - Week of 10/12/26",
"type": "video",
"unknown_fields": [
"hashtags",
"mentions",
"platform_specific.rumble.keywords"
],
"url": "https://rumble.com/v7gyjd4-bongino-weekend-report-week-of-101226.html"
},
{
"approximate_fields": [],
"author": {
"avatar_url": "https://hugh.cdn.rumble.cloud/video/z8/U/K/d/b/UKdba.baa.4-bongino-t8rqq7.jpeg",
"display_name": "The Dan Bongino Show",
"id": "_c276782",
"is_verified": true,
"url": "https://rumble.com/c/bongino",
"username": "bongino"
},
"coauthors": [],
"duration_ms": 3350000,
"hashtags": [],
"id": "v7go45s",
"is_nsfw": false,
"is_pinned": null,
"is_sponsored": null,
"language": null,
"media": [
{
"alt_text": null,
"duration_ms": 3350000,
"expires_at": null,
"height": 1080,
"thumbnail_url": "https://hugh.cdn.rumble.cloud/video/fwe2/2c/s8/1/q/C/B/5/qCB5A.OvCc-small-Bongino-Weekend-Report-Week..jpg",
"type": "video",
"url": "https://hugh.cdn.rumble.cloud/video/fwe2/2c/s8/2/q/C/B/5/qCB5A.haa.mp4",
"width": 1920
}
],
"mentions": [],
"metrics": {
"comment_count": 164,
"like_count": 1143,
"quote_count": null,
"repost_count": 0,
"save_count": null,
"share_count": null,
"view_count": 265418
},
"platform": "rumble",
"platform_specific": {
"rumble": {
"author_follower_count": 3673477,
"caption_tracks": [],
"category": null,
"concurrent_viewer_count": null,
"dislike_count": 22,
"embed_id": "v7ehr8a",
"embed_url": "https://rumble.com/embed/v7ehr8a/",
"files": [],
"is_age_restricted": false,
"is_live_now": false,
"keywords": [],
"live_started_at": null,
"numeric_id": "447606298",
"scheduled_start_at": null,
"secondary_category": null
}
},
"platform_type": "video",
"published_at": "2026-10-10T16:03:02Z",
"text": null,
"thumbnail_url": "https://hugh.cdn.rumble.cloud/video/fwe2/2c/s8/1/q/C/B/5/qCB5A.OvCc-small-Bongino-Weekend-Report-Week..jpg",
"title": "Bongino Weekend Report - Week of 10/05/26",
"type": "video",
"unknown_fields": [
"hashtags",
"mentions",
"platform_specific.rumble.keywords"
],
"url": "https://rumble.com/v7go45s-bongino-weekend-report-week-of-100526.html"
}
],
"page": {
"has_more": true,
"next_cursor": "c1.EXAMPLE_CURSOR",
"next_cursor_expires_at": "2026-10-26T12:00:00Z",
"end_reason": null
},
"meta": {
"request_id": "req_3f9c2a7d1e8b4c6a9f0e2d4b6a8c0e1f",
"platform": "rumble",
"source": "page",
"is_cached": false,
"credits_charged": 1,
"latency_ms": 0,
"fetched_at": "2026-10-25T12:00:00Z",
"input": {
"kind": "profile",
"id": "_c276782",
"url": "https://rumble.com/c/bongino"
},
"credits_remaining": 9999,
"client_request_id": null,
"warnings": [],
"mode": "live"
}
}Long arrays and strings are shortened for display; real responses are complete.
Pricing
Pay per page. Only when it succeeds.
| Source | Price per successful page | Per 1,000 pages |
|---|---|---|
| Any source | 1 credit | $0.75–$1.45 |
- Failed requests are free: errors cost 0 credits.
- Cache hits are free: responses served from the cache cost 0 credits.
- Credits never expire.
- One credit balance for every endpoint and platform.
Credit packs · How this endpoint is priced · How credits work
FAQ