Ingest

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

View as markdown
Provide feedback for this page

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._idInteger
      Sequential identifier of ingest server.
    • ingests.availabilityFloat
      Reserved for internal use.
    • ingests.defaultBoolean
      Reserved for internal use.
    • ingests.nameString
      Descriptive name of ingest server.
    • ingests.url_templateString
      RTMP URL template for ingest server.
    • ingests.url_template_secureString
      SSL-enabled RTMP URL template for ingest server.
    • ingests.priorityInteger
      Reserved for internal use.
Request Example
curl -X GET 'https://ingest.twitch.tv/ingests'
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
        }
    ]
}