Games 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 Top Games Gets games sorted by number of current viewers on Twitch, most popular first.

Get Top Games

Gets games sorted by number of current viewers on Twitch, most popular first.

Authentication

None

URL

GET https://api.twitch.tv/kraken/games/top

Optional Query String Parameters

Name Type Description
limit integer Maximum number of objects to return. Default: 10. Maximum: 100.
offset integer Object offset for pagination of results. Default: 0.

Example Request

This gets the 10 currently most-viewed games on Twitch.

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

Example Response

{
   "_total": 1157,
   "top": [
      {
         "channels": 953,
         "viewers": 171708,
         "game": {
            "_id": 32399,
            "box": {
               "large": "https://static-cdn.jtvnw.net/ttv-boxart/Counter-Strike:%20Global%20Offensive-272x380.jpg",
               "medium": "https://static-cdn.jtvnw.net/ttv-boxart/Counter-Strike:%20Global%20Offensive-136x190.jpg",
               "small": "https://static-cdn.jtvnw.net/ttv-boxart/Counter-Strike:%20Global%20Offensive-52x72.jpg",
               "template": "https://static-cdn.jtvnw.net/ttv-boxart/Counter-Strike:%20Global%20Offensive-{width}x{height}.jpg"
            },
            "giantbomb_id": 36113,
            "logo": {
               "large": "https://static-cdn.jtvnw.net/ttv-logoart/Counter-Strike:%20Global%20Offensive-240x144.jpg",
               "medium": "https://static-cdn.jtvnw.net/ttv-logoart/Counter-Strike:%20Global%20Offensive-120x72.jpg",
               "small": "https://static-cdn.jtvnw.net/ttv-logoart/Counter-Strike:%20Global%20Offensive-60x36.jpg",
               "template": "https://static-cdn.jtvnw.net/ttv-logoart/Counter-Strike:%20Global%20Offensive-{width}x{height}.jpg"
            },
            "name": "Counter-Strike: Global Offensive",
            "popularity": 170487
         }
      },
      ...
   ]
}

Errors

503 Service Unavailable if error retrieving games status.