Our v1.0 (beta) live streaming API will allow you to integrate real time notifications and overlays through your streaming software so you can create a rich and robust stream experience for your audience.
You can create and manage your stream API URLs and keys here: https://rumble.com/account/livestream-api
Only share these URLs with trusted third parties. You can reset the URL and revoke access at any time.
We will be updating this help center article with best practices on how to implement into the most popular streaming platforms. We are also going to be partnering with some for a deeper and robust integration.
For now, you have full reign on using and implementing the Rumble Live Stream API however you want!
In summary, the live stream API includes the following data fields and is updated in real-time:
- Total number of followers of your user profile or channel
- Total number of followers of all of your channels and profile
- Most recent 50 followers by username
- Most recent follower by username
- Chat messages, including username and badges
- Rants, including username, message and dollar amount
- Most recent rant
- Subs, including username
- Most recent sub by username
- Total number of subs
- Video title
- Number of likes and dislikes (thumb ratings)
- Primary and secondary category of stream
- "Watching Now" viewer count
Here is an example output of the full API response:
{
"now": 1695059500,
"type": "user",
"user_id": "XXXXX",
"channel_id": null,
"since": null,
"max_num_results": 50,
"followers": {
"num_followers": 165,
"num_followers_total": 362,
"latest_follower": {
"username": "UserNameA",
"followed_on": "2023-09-17T20:43:56-04:00"
},
"recent_followers": [
{
"username": "UserNameA",
"followed_on": "2023-09-17T20:43:56-04:00"
},
{
"username": "UserNameB",
"followed_on": "2023-09-17T19:10:02-04:00"
},
{
"username": "UserNameC",
"followed_on": "2023-09-16T21:17:47-04:00"
}
]
},
"subscribers": {
"num_subscribers": 5,
"latest_subscriber": {
"username": "UserNameD",
"user": "UserNameD",
"amount_cents": 500,
"amount_dollars": 5,
"subscribed_on": "2023-09-15T21:03:05+00:00"
},
"recent_subscribers": [
{
"user": "UserNameE",
"username": "UserNameE",
"amount_cents": 500,
"amount_dollars": 5,
"subscribed_on": "2023-09-15T21:03:05+00:00"
},
{
"user": "UserNameF",
"username": "UserNameF",
"amount_cents": 500,
"amount_dollars": 5,
"subscribed_on": "2023-09-15T20:50:50+00:00"
},
{
"user": "UserNameG",
"username": "UserNameG",
"amount_cents": 500,
"amount_dollars": 5,
"subscribed_on": "2023-04-09T01:12:26+00:00"
}
]
},
"livestreams": [
{
"id": "XXXXX",
"title": "Title of Live Stream",
"created_on": "2023-09-18T17:51:19+00:00",
"is_live": true,
"categories": {
"primary": {
"slug": "gaming",
"title": "Gaming"
}
"secondary": {
"slug": "simulators",
"title": "Simulators"
}
},
"stream_key": "XXXXXX",
"likes": 3,
"dislikes": 1,
"watching_now": 19,
"chat": {
"latest_message": {
"username": "UserNameH",
"badges": [
"admin",
"premium",
"whale-blue"
],
"text": "test chat",
"created_on": "2023-09-18T17:51:08+00:00"
},
"recent_messages": [
{
"username": "UserNameA",
"badges": [
"admin",
"premium",
"whale-blue"
],
"text": "This is my chat message",
"created_on": "2023-09-18T17:51:08+00:00"
}
],
"latest_rant": {
"username": "UserNameB",
"badges": [
"admin",
"premium",
"whale-blue"
],
"text": "Rant Message Goes Here",
"created_on": "2023-09-18T17:51:37+00:00",
"expires_on": "2023-09-18T17:53:37+00:00",
"amount_cents": 100,
"amount_dollars": 1
},
"recent_rants": [
{
"username": "UserNameB",
"badges": [
"admin",
"premium",
"whale-blue"
],
"text": "Rant Message",
"created_on": "2023-09-18T17:51:37+00:00",
"expires_on": "2023-09-18T17:53:37+00:00",
"amount_cents": 100,
"amount_dollars": 1
},
{
"username": "UserNameC",
"badges": [
"admin",
"premium",
"whale-blue"
],
"text": "Rant Message",
"created_on": "2023-09-18T17:51:37+00:00",
"expires_on": "2023-09-18T17:53:37+00:00",
"amount_cents": 100,
"amount_dollars": 1
},{
"username": "UserNameD",
"badges": [
"admin",
"premium",
"whale-blue"
],
"text": "Rant Message",
"created_on": "2023-09-18T17:51:37+00:00",
"expires_on": "2023-09-18T17:53:37+00:00",
"amount_cents": 100,
"amount_dollars": 1
}
]
}
}
]
}
Please note:
- The API URL includes your user UI as well as your live stream key. Authentication is not required for this version of the API. Please only share this URL to trusted third party sources. You can reset your URL to revoke access any time.
- All of the values under "livestreams" including chat messages and rants are only populated during a live stream.
- A maximum of 50 results total are output for recent chat messages and rants
Additional resources and best practices:
The following tutorial video and plugin for OBS has been working successfully for some of our creators.
https://www.youtube.com/watch?v=E_UMNIfgR5w
https://obsproject.com/forum/resources/url-api-source-fetch-live-data-and-display-it-on-screen.1756/
Please return to this help center article soon for more updates!
.