Video Broadcast
Reference

Reference

Get Ingest Servers

Get Ingest Servers returns a list of endpoints for ingesting live video into Twitch.

URL

GET https://ingest.twitch.tv/ingests

Authentication

None

Return Values

ParameterTypeDescription
ingestsarrayArray of Ingest Server objects.
_idintegerSequential identifier of ingest server.
availabilityfloatReserved for internal use.
defaultbooleanReserved for internal use.
namestringDescriptive name of ingest server.
url_templatestringRTMP URL template for ingest server
priorityintegerReserved for internal use.

Example

Example Request

curl -X GET 'https://ingest.twitch.tv/ingests' 

Example Response

​​​​​​{
    "ingests": [
        {
            "_id": 0,
            "availability": 1.0,
            "default": false,
            "name": "US East: Atlanta, GA",
            "url_template": "rtmp://atl.contribute.video.net/app/{stream_key}",
            "priority": 0
        },
        {
            "_id": 1,
            "availability": 1.0,
            "default": false,
            "name": "US East: Ashburn, VA (5)",
            "url_template": "rtmp://iad05.contribute.video.net/app/{stream_key}",
            "priority": 1
        },
        {
            "_id": 2,
            "availability": 1.0,
            "default": false,
            "name": "US East: Ashburn, VA (3)",
            "url_template": "rtmp://iad03.contribute.video.net/app/{stream_key}",
            "priority": 2
        },
        {
            "_id": 3,
            "availability": 1.0,
            "default": false,
            "name": "US East: Chicago, IL (2)",
            "url_template": "rtmp://ord02.contribute.video.net/app/{stream_key}",
            "priority": 3
        },
        {
            "_id": 4,
            "availability": 1.0,
            "default": false,
            "name": "US East: Chicago, IL (3)",
            "url_template": "rtmp://ord03.contribute.video.net/app/{stream_key}",
            "priority": 4
        }
    ]
}