Contents

Games 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 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.

Errors

503 Service Unavailable if error retrieving games status.

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