Rumble video transcript API
Captions when Rumble has them (its own auto captions count as captions); AI transcription of the audio when it does not.
GET /v1/rumble/video/transcript
GET /v1/rumble/video/transcript
Captions when Rumble has them (its own auto captions count as captions); AI transcription of the audio when it does not.
- Cost: 1 credit for captions; AI transcription 1 up to 2 minutes, then 5 per started minute of the whole video
- Cache: Results are kept up to 30 days; send
max_age_daysto reuse them for free. - Timeout: A request still running after about 25 seconds answers
202with a job to poll (Batch and jobs).
Parameters#
| Name | Type | Required | Description |
|---|---|---|---|
url | URL | yes | Video URL (rumble.com/v...-title.html). Accepted hosts: rumble.com. |
allow_long_transcription | boolean | no | Transcribe audio past 2 minutes with AI, at 5 credits per started minute of the whole video. Without it a longer video answers transcript_unavailable, which is free. Default false. Also accepted as allowLongTranscription. |
Every request also accepts:
trim:truefor a smaller response withoutnullfields andextra.raw:trueto also get the platform's original object asraw.max_age_days: accept a cached result up to this many days old, for 0 credits (Caching).
Example request#
Set your key in the environment first (see Authentication).
1curl -G "https://api.socialscrape.dev/v1/rumble/video/transcript" \2 -H "x-api-key: $SOCIALSCRAPE_API_KEY" \3 --data-urlencode "url=https://rumble.com/v79xhhm-discovery-why-glenn-wants-israel-to-sue-the-new-york-times.html"1import os2import requests34params = {5 "url": "https://rumble.com/v79xhhm-discovery-why-glenn-wants-israel-to-sue-the-new-york-times.html",6}7res = requests.get(8 "https://api.socialscrape.dev/v1/rumble/video/transcript",9 headers={"x-api-key": os.environ["SOCIALSCRAPE_API_KEY"]},10 params=params,11)12body = res.json()1314if body["ok"]:15 print(body["data"])16else:17 print(body["error"]["code"], body["error"]["message"])1const url = new URL("https://api.socialscrape.dev/v1/rumble/video/transcript");2url.search = new URLSearchParams({3 "url": "https://rumble.com/v79xhhm-discovery-why-glenn-wants-israel-to-sue-the-new-york-times.html"4}).toString();5const res = await fetch(url, {6 headers: { "x-api-key": process.env.SOCIALSCRAPE_API_KEY! },7});8const body = await res.json();910if (body.ok) {11 console.log(body.data);12} else {13 console.error(body.error.code, body.error.message);14}1{2 "nodes": [3 {4 "name": "SocialScrape Rumble video transcript",5 "type": "n8n-nodes-base.httpRequest",6 "typeVersion": 4.2,7 "position": [8 0,9 010 ],11 "parameters": {12 "method": "GET",13 "url": "https://api.socialscrape.dev/v1/rumble/video/transcript",14 "sendQuery": true,15 "queryParameters": {16 "parameters": [17 {18 "name": "url",19 "value": "https://rumble.com/v79xhhm-discovery-why-glenn-wants-israel-to-sue-the-new-york-times.html"20 }21 ]22 },23 "sendHeaders": true,24 "headerParameters": {25 "parameters": [26 {27 "name": "x-api-key",28 "value": "={{ $env.SOCIALSCRAPE_API_KEY }}"29 }30 ]31 }32 }33 }34 ],35 "connections": {}36}Example response#
This is a sample from a recorded response, lists and long text are shortened. Status 200.
1{2 "ok": true,3 "credits_charged": 1,4 "credits_remaining": 4999,5 "cached": false,6 "cached_at": null,7 "request_id": "req_a413c023a29c4777d354c3ca",8 "data": {9 "object": "transcript",10 "platform": "rumble",11 "video_id": "v79xhhm",12 "url": "https://rumble.com/v79xhhm-discovery-why-glenn-wants-israel-to-sue-the-new-york-times.html",13 "language": "en",14 "source": "auto_captions",15 "duration_seconds": 1678.0,16 "text": "Let's get into these questions, and we'll try and get through as many as we can. The first one is from Christi Marbet, who says there were a few questions about this. They want you to comment on the following, quote, the Christoph piece on...",17 "segments": [18 {19 "start": 6.83,20 "end": 11.03,21 "text": "Let's get into these questions, and we'll try and get through as many as we can."22 },23 {24 "start": 11.03,25 "end": 15.63,26 "text": "The first one is from Christi Marbet, who says there were a few questions about this."27 },28 {29 "start": 15.63,30 "end": 17.73,31 "text": "They want you to comment on the following, quote,"32 }33 ],34 "available_languages": [35 "en"36 ],37 "extra": {38 "caption_key": "en-auto",39 "language_label": "English (auto)"40 }41 },42 "cursor": null,43 "has_more": null44}Response#
A Transcript object in data.
See Data models for every field. The envelope around data is described in Responses.
Errors#
Failures are free: credits_charged is 0. Branch on error.code, never on the message.
| Code | HTTP | Retry | Meaning |
|---|---|---|---|
invalid_params | 400 | no | A parameter is missing, unknown or has the wrong type. |
unsupported_url | 400 | no | The URL is not one this endpoint accepts (wrong platform or form). |
not_found | 404 | no | The platform says this profile, post or item does not exist. |
transcript_unavailable | 404 | no | No captions exist and AI transcription is not possible for this media. |
Every request can also fail with the account and platform errors listed on the Errors page.
Example error:
1{2 "ok": false,3 "error": {4 "code": "transcript_unavailable",5 "message": "No captions exist and AI transcription is not possible for this media.",6 "retryable": false7 },8 "credits_charged": 0,9 "request_id": "req_7b3b0c917e825875a6012291"10}Related endpoints#
- Rumble video details (
GET /v1/rumble/video) - Rumble channel videos (
GET /v1/rumble/channel/videos) - Rumble search (
GET /v1/rumble/search) - Rumble video comments (
GET /v1/rumble/video/comments)