Rumble Upload API
Rumble Upload API
- Endpoint: https://rumble.com/api/simple-upload.php
- Accepts
multipart/form-data
content with the following fields:access_token
: required string, 40 characterstitle
: required stringdescription
: required stringlicense_type
: required integer,0
for "not for sale",6
for "Rumble only"channel_id
: optional integerguid
: optional string, this should be your own internal ID for the video for mappingthumb
: optional thumbnail filevideo
: video filecc_<language-code>
: close captions file, e.g.cc_en
,cc_es
,cc_fr
etc. You can upload multiple files for different languages at once. We support the following formats:vtt
,srt
,sbv
,stl
,sub
.
- Response HTTP codes:
- 403: access denied (invalid
access_token
or user is banned) - otherwise 200
- 403: access denied (invalid
- Response body is JSON
- On success:
{ "success": true, "video_id": <string>, "video_id_int": <int>, "url_monetized": <string>, "embed_url_monetized": <string>, "embed_html_monetized": <string>, "embed_js_monetized": <string> }
- On failure:
{ "success": false, "errors": [ "<field_name>": { "code": <string>, "message": <string>, "internal_code": <arbitrary type> }, ... ] }
errors
— array, will not exist if there were no errors.errors.<field_name>
— here<field_name>
maps to the incoming field names (i.e.title
,description
, etc.), or_
for some error that is not directly related to any field.errors.field_name.code
— string.errors.field_name.message
— optional string, detailed description of the error.errors.field_name.internal_code
— optional value of arbitrary type that can help us (Rumble) to investigate a problem whenerrors.field_name.code
is"SOMETHING_WENT_WRONG"
.
- On success:
- CURL example:
curl -F "access_token=0123456789abcdef0123456789abcdef01234567" \ -F "title=A cool video" \ -F "description=Some detailed description" \ -F "license_type=0" \ -F "channel_id=123" \ -F "video=@video.mp4" \ -F "thumb=@thumbnail.jpg" \ -F "cc_en=@cc.srt" \ -F "cc_fr=@fr.vtt" \ "https://rumble.com/api/simple-upload.php"
- Please contact bd@rumble.com to set up your unique access token.