Create restream

curl --request POST \
  --url https://api.gcore.com/streaming/restreams \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "restream": {
    "name": "first restream",
    "active": true,
    "uri": "rtmp://a.rtmp.youtube.com/live/k17a-13s8",
    "stream_id": 20,
    "client_user_id": 10
  }
}
'

import requests

url = "https://api.gcore.com/streaming/restreams"

payload = { "restream": {
        "name": "first restream",
        "active": True,
        "uri": "rtmp://a.rtmp.youtube.com/live/k17a-13s8",
        "stream_id": 20,
        "client_user_id": 10
    } }
headers = {
    "Authorization": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    restream: {
      name: 'first restream',
      active: true,
      uri: 'rtmp://a.rtmp.youtube.com/live/k17a-13s8',
      stream_id: 20,
      client_user_id: 10
    }
  })
};

fetch('https://api.gcore.com/streaming/restreams', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.gcore.com/streaming/restreams",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'restream' => [
        'name' => 'first restream',
        'active' => true,
        'uri' => 'rtmp://a.rtmp.youtube.com/live/k17a-13s8',
        'stream_id' => 20,
        'client_user_id' => 10
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.gcore.com/streaming/restreams"

	payload := strings.NewReader("{\n  \"restream\": {\n    \"name\": \"first restream\",\n    \"active\": true,\n    \"uri\": \"rtmp://a.rtmp.youtube.com/live/k17a-13s8\",\n    \"stream_id\": 20,\n    \"client_user_id\": 10\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.gcore.com/streaming/restreams")
  .header("Authorization", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"restream\": {\n    \"name\": \"first restream\",\n    \"active\": true,\n    \"uri\": \"rtmp://a.rtmp.youtube.com/live/k17a-13s8\",\n    \"stream_id\": 20,\n    \"client_user_id\": 10\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.gcore.com/streaming/restreams")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"restream\": {\n    \"name\": \"first restream\",\n    \"active\": true,\n    \"uri\": \"rtmp://a.rtmp.youtube.com/live/k17a-13s8\",\n    \"stream_id\": 20,\n    \"client_user_id\": 10\n  }\n}"

response = http.request(request)
puts response.read_body

This response has no body data.

This response has no body data.

Restreams

Create restream

Creates a new restream for a specified live stream.

Specify the target platform’s URI (RTMP, RTMPS, or SRT) and the ID of the source stream.

Restreaming allows you to broadcast a single live stream to multiple platforms or servers simultaneously (e.g., Facebook, YouTube, or a custom media server).

How it works:

Get credentials (stream URL/key or SRT URL) from the target platform.
Create a restream in the Gcore system by specifying the target URI and the source live stream.
Start your live stream; it will be automatically pushed to the target destination.

                +-----------------------+
RTMP/RTMPS      |                       | -------->  Facebook (RTMP)
    or  ------> |    Gcore Streaming    | -------->  YouTube (RTMPS)
SRT             |                       | -------->  Media server (SRT)
                +-----------------------+ -------->  Other RTMP/SRT targets

Supported combinations: RTMP → RTMP, RTMPS → RTMPS, RTMP → SRT, SRT → SRT, SRT → RTMP. For SRT targets, only mode=caller is supported (Gcore initiates a PUSH connection).

Source stream parameters (bitrate, codecs, resolution) are sent “as is”. Ensure they match the destination requirements.

For SRT restreams, specify &latency=N explicitly in the SRT target URL instead of relying on a default value. It helps size the recovery buffer for round-trip time, jitter, and packet loss on the route to the target site. Selecting the right latency is crucial for delivering a smooth live stream. It depends on the geographic distance and network conditions between Gcore and your target platform, especially if they located on different continents.

| Network Conditions      | Recommended Latency |
|-------------------------|---------------------|
| Cross-region            | 1-2 seconds         |
| Public internet         | 2-5 seconds         |

Your target SRT server can accept latency format in seconds, milliseconds, or microseconds. Find out what format your target SRT server accepts in its documentation.

Learn more about SRT latency in product documentation.

POST

streaming

restreams

Create restream

curl --request POST \
  --url https://api.gcore.com/streaming/restreams \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "restream": {
    "name": "first restream",
    "active": true,
    "uri": "rtmp://a.rtmp.youtube.com/live/k17a-13s8",
    "stream_id": 20,
    "client_user_id": 10
  }
}
'

import requests

url = "https://api.gcore.com/streaming/restreams"

payload = { "restream": {
        "name": "first restream",
        "active": True,
        "uri": "rtmp://a.rtmp.youtube.com/live/k17a-13s8",
        "stream_id": 20,
        "client_user_id": 10
    } }
headers = {
    "Authorization": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    restream: {
      name: 'first restream',
      active: true,
      uri: 'rtmp://a.rtmp.youtube.com/live/k17a-13s8',
      stream_id: 20,
      client_user_id: 10
    }
  })
};

fetch('https://api.gcore.com/streaming/restreams', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.gcore.com/streaming/restreams",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'restream' => [
        'name' => 'first restream',
        'active' => true,
        'uri' => 'rtmp://a.rtmp.youtube.com/live/k17a-13s8',
        'stream_id' => 20,
        'client_user_id' => 10
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.gcore.com/streaming/restreams"

	payload := strings.NewReader("{\n  \"restream\": {\n    \"name\": \"first restream\",\n    \"active\": true,\n    \"uri\": \"rtmp://a.rtmp.youtube.com/live/k17a-13s8\",\n    \"stream_id\": 20,\n    \"client_user_id\": 10\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.gcore.com/streaming/restreams")
  .header("Authorization", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"restream\": {\n    \"name\": \"first restream\",\n    \"active\": true,\n    \"uri\": \"rtmp://a.rtmp.youtube.com/live/k17a-13s8\",\n    \"stream_id\": 20,\n    \"client_user_id\": 10\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.gcore.com/streaming/restreams")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"restream\": {\n    \"name\": \"first restream\",\n    \"active\": true,\n    \"uri\": \"rtmp://a.rtmp.youtube.com/live/k17a-13s8\",\n    \"stream_id\": 20,\n    \"client_user_id\": 10\n  }\n}"

response = http.request(request)
puts response.read_body

This response has no body data.

This response has no body data.

Authorizations

Authorization

string

header

required

API key for authentication. Make sure to include the word apikey, followed by a single space and then your token. Example: apikey 1234$abcdef

Body

application/json

restream

object

Show child attributes

Example:

{
  "name": "first restream",
  "active": true,
  "uri": "rtmp://a.rtmp.youtube.com/live/k17a-13s8",
  "stream_id": 20,
  "client_user_id": 10
}

Response

Get all restreams Get restream

⌘I