Get Ingest Servers
Get Ingest Servers returns a list of endpoints for ingesting live video into Twitch.
Note
The Client-Id and Authorization headers are not required.
Endpoint
GEThttps://ingest.twitch.tv/ingests
Authorization
No authorization required.
Response Body
ingestsObject[]Array of Ingest Server objects.Hide child attributesShow child attributes
ingests._idIntegerSequential identifier of ingest server.ingests.availabilityFloatReserved for internal use.ingests.defaultBooleanReserved for internal use.ingests.nameStringDescriptive name of ingest server.ingests.url_templateStringRTMP URL template for ingest server.ingests.url_template_secureStringSSL-enabled RTMP URL template for ingest server.ingests.priorityIntegerReserved for internal use.
Request Example
example language for Get Ingest Servers
curl -X GET 'https://ingest.twitch.tv/ingests'$response = Invoke-RestMethod -Uri "https://ingest.twitch.tv/ingests" `
-Method Getconst response = await fetch("https://ingest.twitch.tv/ingests", {
method: "GET",
});
const data = await response.json();import requests
response = requests.get(
"https://ingest.twitch.tv/ingests",
)
data = response.json()req, _ := http.NewRequest("GET", "https://ingest.twitch.tv/ingests", nil)
res, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer res.Body.Close()
data, _ := io.ReadAll(res.Body)$ch = curl_init("https://ingest.twitch.tv/ingests");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "GET");
curl_setopt($ch, CURLOPT_HTTPHEADER, [
]);
$response = curl_exec($ch);
curl_close($ch);using var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Get, "https://ingest.twitch.tv/ingests");
var response = await client.SendAsync(request);
var data = await response.Content.ReadAsStringAsync();let client = reqwest::Client::new();
let response = client
.get("https://ingest.twitch.tv/ingests")
.send()
.await?;
let data = response.text().await?;Response Example
{
"ingests": [
{
"_id": 0,
"availability": 1.0,
"default": false,
"name": "Default",
"url_template": "rtmp://ingest.global-contribute.live-video.net/app/{stream_key}",
"url_template_secure": "rtmps://ingest.global-contribute.live-video.net/app/{stream_key}",
"priority": 0
},
{
"_id": 1,
"availability": 1.0,
"default": false,
"name": "US West (Oregon)",
"url_template": "rtmp://usw20.contribute.live-video.net/app/{stream_key}",
"url_template_secure": "rtmps://usw20.contribute.live-video.net/app/{stream_key}",
"priority": 1
},
{
"_id": 2,
"availability": 1.0,
"default": false,
"name": "US East (Ohio)",
"url_template": "rtmp://use20.contribute.live-video.net/app/{stream_key}",
"url_template_secure": "rtmps://use20.contribute.live-video.net/app/{stream_key}",
"priority": 2
},
{
"_id": 3,
"availability": 1.0,
"default": false,
"name": "US East (N. Virginia)",
"url_template": "rtmp://use10.contribute.live-video.net/app/{stream_key}",
"url_template_secure": "rtmps://use10.contribute.live-video.net/app/{stream_key}",
"priority": 3
},
{
"_id": 4,
"availability": 1.0,
"default": false,
"name": "Europe (Ireland)",
"url_template": "rtmp://euw10.contribute.live-video.net/app/{stream_key}",
"url_template_secure": "rtmps://euw10.contribute.live-video.net/app/{stream_key}",
"priority": 4
}
]
}