Teams Reference

Twitch API v5 is deprecated and will be removed on 12/31/18. The new Twitch API is live and we are actively adding new functionality to it.

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
   },
   ...
   ]
}