Contents

Games Reference

Twitch API v5 is deprecated. Please use the latest version of the 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 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",
         }
      },
      ...
   ]
}
+