Contents

Teams Reference

While you can migrate from v3 to v5, know that v5 is deprecated and will be shutdown in the future. We prefer that you migrated directly to the new Twitch API.

Endpoint Description
Get All Teams

Gets all active teams.

Get Team

Gets a specified team object.

Get All Teams

Gets all active teams.

Authentication

None

URL

GET https://api.twitch.tv/kraken/teams

Optional Query String Parameters

Name Type Description
limit integer Maximum number of objects to return, sorted by creation date. Default: 25. Maximum: 100.
offset integer Object offset for pagination of results. Default: 0.

Example Request

This gets the team objects for the 25 most recently created teams.

curl -H 'Accept: application/vnd.twitchtv.v5+json' \
-H 'Client-ID: uo6dggojyb8d6soh92zknwmi5ej1q2' \
-X GET 'https://api.twitch.tv/kraken/teams'

Example Response

{
   "teams": [{
      "_id": 10,
      "background": null,
      "banner": "https://static-cdn.jtvnw.net/jtv_user_pictures/team-staff-banner_image-606ff5977f7dc36e-640x125.png",
      "created_at": "2011-10-25T23:55:47Z",
      "display_name": "Twitch Staff",
      "info": "Twitch staff stream here. Drop in and say \"hi\" sometime :)",
      "logo": "https://static-cdn.jtvnw.net/jtv_user_pictures/team-staff-team_logo_image-76418c0c93a9d48b-300x300.png",
      "name": "staff",
      "updated_at": "2014-10-16T00:44:11Z"
   },
   ...
   ]
}

Get Team

Gets a specified team object.

Authentication

None

URL

GET https://api.twitch.tv/kraken/teams/<team name>

Optional Query String Parameters

None

Example Request

This gets the staff team.

curl -H 'Accept: application/vnd.twitchtv.v5+json' \
-H 'Client-ID: uo6dggojyb8d6soh92zknwmi5ej1q2' \
-X GET 'https://api.twitch.tv/kraken/teams/staff'

Example Response

{
   "_id": 10,
   "background": null,
   "banner": "https://static-cdn.jtvnw.net/jtv_user_pictures/team-staff-banner_image-606ff5977f7dc36e-640x125.png",
   "created_at": "2011-10-25T23:55:47Z",
   "display_name": "Twitch Staff",
   "info": "Twitch staff stream here. Drop in and say \"hi\" some time :)",
   "logo": "https://static-cdn.jtvnw.net/jtv_user_pictures/team-staff-team_logo_image-76418c0c93a9d48b-300x300.png",
   "name": "staff",
   "updated_at": "2014-10-16T00:44:11Z",
   "users": [{
         "_id": 5582097,
         "broadcaster_language": "en",
         "created_at": "2009-04-13T21:22:28Z",
         "display_name": "Sarbandia",
         "followers": 1182,
         "game": "Hearthstone: Heroes of Warcraft",
         "language": "en",
         "logo": "https://static-cdn.jtvnw.net/jtv_user_pictures/sarbandia-profile_image-6693b5952f31c847-300x300.jpeg",
         "mature": false,
         "name": "sarbandia",
         "partner": false,
         "profile_banner": "https://static-cdn.jtvnw.net/jtv_user_pictures/sarbandia-profile_banner-247cdbe62dbcf4d9-480.jpeg",
         "profile_banner_background_color": null,
         "status": "Midrange shaman laddering",
         "updated_at": "2016-12-15T19:02:40Z",
         "url": "https://www.twitch.tv/sarbandia",
         "video_banner": null,
         "views": 8168
   },
   ...
   ]
}
+