Castr API Documentation: Pull URLs

Overview

Pull URLs serve as an essential feature for re-broadcasting existing online live streams from Castr to other streaming tools. These URLs can also act as a source for new broadcast sessions.

Use Cases

• Multi-window Broadcasts: Concerts, sports events
• Cross-Region Events: Simultaneous broadcasting across different locations
• Live Interviews: Host interviews across different platforms
• Game Streaming: Showcase multiple gamers in a single session

Supported Formats: RTMP and SRT.

Prerequisites

• A live stream must be active (broadcasting_status: online) to fetch its Pull URLs.

Fetching Pull URLs

To retrieve the Pull URLs of an active live stream, make a GET request to the /live_streams/{id} endpoint.

Endpoint

GET /live_streams/{id}

Sample Request

curl --location --request GET 'https://api.castr.com/v2/live_streams/631c4b222537d7ce5a90c458' \
--header 'Content-Type: application/json;charset=UTF-8' \
--header 'Authorization: {your_authentication}'

Sample Response

{
  ...
  "broadcasting_status": "online",
  "pull_urls": {
    "rtmp": "rtmp://ingest.castr.com/live_d24df56030e211ed998b63dd43698e32",
    "srt": "srt://ingest.castr.com:9998/?streamid=#!::r=live_d24df56030e211ed998b63dd43698e32,m=request"
  },
  ...
}

Testing Pull URLs

You can quickly verify the Pull URLs using software like VLC by selecting the 'Open Network Stream' option.

Limitations

• Availability: Pull URLs are only available when the stream's broadcasting_status is set to online.