Login

Simulcast to 3rd party platforms

Simulcasting allows you to broadcast a live video feed to multiple 3rd party social platforms or channels at the same time. This can include platforms like YouTube, Facebook Live, Twitch, and others.


Simulcast targets

Live simulcasting can be used with any RTMP server. Presently, FastPix supports simulcast targets from the following platforms. All of these platforms supports the RTMP protocol.

  • YouTube
  • Facebook live
  • Twitch

📘

PLEASE NOTE

We’re constantly upscaling our APIs and adding more simulcast targets from other popular platforms. Please react out to us if you have any other specific requirements.


Simulcast your live stream

Take reference from the create a simulcast API endpoint to add simulcasting to the FastPix live stream.

Once you have added the simulcast target to your request, the live stream event will be set up for simulcasting. The targets can be added when the live stream object is first or after the live stream event creation.


📘

PLEASE NOTE

Simulcast targets can only be added when the live stream object status is idle that is when it’s not active.


Request body parameters

url

  • It is like the address you need to know to connect and share your live video with a third-party streaming service.
  • It's the way your live stream knows where to go and how to reach its destination on the internet.

streamKey:

  • When you want to share a live video on a specific platform, they provide you with a unique address called the RTMPS url, and a streamKey. You combine these two pieces of information, to create a connection.
  • This connection allows your live video to be sent to and displayed on that platform. Each platform has its own unique RTMPS URL and stream key, acting as the special code to broadcast on that platform.

metadata:

  • Stores additional details about the live stream, such as its title, category, or any other relevant information.

Request example to create a simulcast:

curl -X POST 'https://v1.fastpix.io/live/streams/{streamId}/simulcast'
   --user {Access Token ID}:{Secret Key} \
   -H 'Content-Type: application/json' \
   -d '{
   "url": "rtmp://hyd01.contribute.live-video.net/app/",
   "streamKey": "live_1012464221_DuM8W004MoZYNxQEZ0czODgfHCFBhk",
   "metadata": {
      "livestream_name": "Tech-Connect Summit"
   }
}'

Here's what you will get in response:

{
  "success": true,
  "data": {
    "simulcastId": "8717422d89288ad5958d4a86e9afe2a2",
    "url": "rtmp://hyd01.contribute.live-video.net/app/",
    "streamKey": "live_1012464221_DuM8W004MoZYNxQEZ0czODgfHCFBhk",
    "isEnabled": true,
    "metadata": {
      "livestream_name": "Tech-Connect Summit"
    }
  }
}

You can find below examples of different streaming platforms along with their RTMP URL and stream key:


Simulcast for YouTube Live

  • Use Live Stream ID to set up a simulcast on YouTube.
  • Get the RTMP URL and stream key for YouTube.
  • Create a simulcast API by setting up a POST request for YouTube.

📘

PLEASE NOTE

The streamKey is intended for a single use on each platform; once the stream concludes, it becomes inactive. It is advisable to regularly reset the streamKey for optimal functionality.



  • RTMP URL: rtmp://a.rtmp.youtube.com/live2
  • Stream Key: 2hqw-g9aq-ah0q-1r6s-9y8d

{
    "url": "rtmp://a.rtmp.youtube.com/live2/37q0-tvp6-4ju3-47dk-318b",
    "streamKey": "37q0-tvp6-4ju3-47dk-318b",
    "metadata": {
        "Key1": "567",
        "Key2": "567"
    }
}

{
    "success": true,
    "data": {
    "simulcastId": "8717422d89288ad5958d4a86e9afe2a2",
    "url": "rtmp://a.rtmp.youtube.com/live2/37q0-tvp6-4ju3-47dk-318b",
    "streamKey": "37q0-tvp6-4ju3-47dk-318b",
    "isEnabled": true,
    "metadata": {
    "Key1": "567",
    "Key2": "567"
     }
}

Live streaming in YouTube




Simulcast for Facebook Live

  • Use Live Stream ID to set up a simulcast on Facebook live (If you want more simulcast).
  • Get the RTMP URL and stream key for Facebook.
  • Create a simulcast by setting up a POST request for Facebook.


  • RTMP URL: rtmps://live-api-s.facebook.com:443/rtmp/
  • Stream Key: FB-1697910214069303-0-AbztZAbPLLvaxRjs

{
    "url": "rtmps://live-api-s.facebook.com:443/rtmp/FB-1729821800878144-0-Abw5V0aoUI7NK0SD",
    "streamKey": "FB-1729821800878144-0-Abw5V0aoUI7NK0SD",
    "metadata": {
        "Key1": "567",
        "Key2": "567"
    }
}

{
  "success": true,
   "data": {
      "simulcastId": "9717422d89288ad5958d4a86e9afe2a2",
      "url": "rtmps://live-api-s.facebook.com:443/rtmp/FB-1729821800878144-0-Abw5V0aoUI7NK0SD",
      "streamKey": "FB-1729821800878144-0-Abw5V0aoUI7NK0SD",
      "isEnabled": true,
   "metadata": {
       "Key1": "567",
       "Key2": "567"
   }
 }
}

Live streaming in Facebook




Simulcast for Twitch

  • Use Live Stream ID to set up a simulcast on Twitch (If you want more simulcast)
  • Get the RTMP URL and stream key for Twitch.
  • Create a simulcast by setting up a POST request for Twitch.


  • RTMP URL: rtmps://live.twitch.tv/app
  • Stream Key: live_1012464221_3nnFycVb0J7Ch1fto4KkfnmKcVCXS5

{
    "url": "rtmp://hyd01.contribute.live-video.net/app/live_1012464221_aJ9wwRkGeNQoHHe64Bfid8Ct7NZsUG",
    "streamKey": "live_1012464221_aJ9wwRkGeNQoHHe64Bfid8Ct7NZsUG",
    "metadata": {
        "Key1": "567",
        "Key2": "567"
    }
}

{
  "success": true,
   "data": {
       "simulcastId": "8717422d89288ad5958d4a86e9afe2a2",
       "url": "rtmp://hyd01.contribute.live-video.net/app/live_1012464221_aJ9wwRkGeNQoHHe64Bfid8Ct7NZsUG",
       "streamKey": "live_1012464221_aJ9wwRkGeNQoHHe64Bfid8Ct7NZsUG",
       "isEnabled": true,
    "metadata": {
       "Key1": "567",
       "Key2": "567"
      }
    }
  }
}

Live streaming in Twitch




Configure OBS

Once you are done setting up your simulcasting targets, you would need to configure the OBS (Open Broadcaster Software) to finally start the live streaming while also sharing the stream to 3rd party social platforms.

Here are the steps you need to follow:

  • Open OBS on your system
  • Go to “Settings” and click on “Stream”.
  • Enter our RTMP URL (rtmps://live.fastpix.io:443/live) and streamKey (The one that got generated when you created the live stream).
  • Set up your video and audio sources (input that you want to stream).
  • Start streaming: Click on “Start Streaming” in OBS. The stream will get started in all platforms simultaneously.
  • To stop streaming: Click “Stop Streaming” in OBS. The stream ends on all platforms simultaneously.


Simulcast events to know status

Utilizing simulcast target events is crucial for developing a user interface that provides users with real-time information on the status of their set third-party endpoints. This becomes especially beneficial when designing a UI to present the current state of each simulcast target and to monitor any updates in their status as they happen.


WebhooksDescription
video.live_stream.simulcast_target.createdA new simulcast has been created for a live stream.
video.live_stream.simulcast_target.deletedWhen the simulcast of a live stream has been deleted.
video.live_stream.simulcast_target.updatedWhen the simulcast of a live stream has been updated.