Rumble Platform API
Rumble Platform API
This document describes the API provided by Rumble. The API is for developers who want to integrate Rumble into their application.
To use the API, your application will need to make an HTTPS request and parse the response. The response format can be in either JSON or MRSS.
Because the API is based on open standards, you can use any web development language to access the API.
API is available at the location https://rumble.com/api/v0/
Authentication
Authentication
To be able to use API you need to provide an API key through _p get parameter. You can get this key from your Rumble contact, and it can be set up to have different defaults, filters, mappings and output formats.
Methods
Rumble Platform Methods
Media.Item
- This methods is used to retrieve a video by given ID.
- Parameters:
| Parameter Name | Parameter Type | Description |
|---|---|---|
| fid | Int | ID of video to return Example: https://rumble.com/api/v0/Media.Item?_p=APIKey |
Media.Search
- This method is used to retrieve videos using various filters. You can search for a video, choose in which language you want results, specify a channel, etc…
- Parameters:
| Parameter Name | Parameter Type | Description |
|---|---|---|
| criteria | Complex | Each parameter and examples are described in Criteria parameters section. |
| lang | String | Used to specify in which language title and description will re retrieved. Available options: • en • fr • es • jp • pt-br Default: en Example: https://rumble.com/api/v0/Media.Search?_p=APIKey |
| q | String | Filter videos by given string. If string contains multiple words they must be separated by %20 Example: https://rumble.com/api/v0/Media.Search?_p=API |
| syndicated | Int | Determines whether to include syndicated videos or not. Available options: • 0 • 1 Defautl: 0 Example: https://rumble.com/api/v0/Media.Search?_p=APIKey&syndicate=1 |
| channel | Int | String | Filter results to a specific channel, either a channel id or slug can be provided. The slug can be found on Rumble when viewing a channel in the URL. The slug is ‘dogs-puppies’ in the following URL: https://rumble.com/c/dogs-puppies/ A list of channels can also be retrieved from the following URL: https://rumble.com/api/v0/Media.Channels.mrss?_p=APIKey |
| channel | Int | String | Filter results to a specific channel, either a channel ID or slug can be provided. The slug can be found on Rumble when viewing a channel in the URL. The slug is ‘dogs-puppies’ in the following URL: https://rumble.com/c/dogs-puppies/ A list of channels can also be retrieved from the following URL: https://rumble.com/api/v0/Media.Channels.mrss?_p=APIKey |
| user | Int | String | User ID or user name of the user you want to filter the results to. Example: https://rumble.com/api/v0/Media.Search.mrss?_p=API Key&criteria=sort=date&user=reutersnews |
| ext | String | Response format. Instead of specifying response format through this parameter you can put one of available options after the Media.Search part in URL (look at example #2). Available options: • JSON • mRSS Default: JSON Example #1: https://rumble.com/api/v0/Media.Search.json?_p=APIKey Example #2: https://rumble.com/api/v0/Media.Search.mrss?_p=APIKey |
| debug | It’s used for debugging purpose. This parameter does not have a value. Example: https://rumble.com/api/v0/Media.Search?_p=APIKey&debug=1 |
Criteria parameters:
| Parameter Name | Parameter Type | Description |
|---|---|---|
| pg | Int | Determines page number of results which will be returned. Available options: •Min: 1 •Max: 10 Default: 1 Example: https://rumble.com/api/v0/Media.Search?_p=APIKey&criteria=pg=2 |
| sort | String | Order in which videos will be returned. Available options: • date •views Default: none Example: https://rumble.com/api/v0/Media.Search?_p=APIKey&criteria=sort=views |
| tier | Int | Syndication tier ID. Example: https://rumble.com/api/v0/Media.Search?_p=APIKey&criteria=tier=1 |
| limit | Int | Number of items per page Available options: • Min: 1 •Max: 100 Default: 25 Example: https://rumble.com/api/v0/Media.Search?_p=APIKey&criteria=limit0 |
| editorpicks | It’s used to specify whether to return editor picks or not. This parameter doesn’t have a value. Example: https://rumble.com/api/v0/Media.Search?_p=APIKey&criteria=editorpicks |
If you want to provide multiple criteria you separate them by comma (,).
Example:
https://rumble.com/api/v0/Media.Search?_p=APIKey&criteria=editorpicks,limit=10,pg=2