Contents

Bits Reference

Legacy Twitch API v5 is deprecated and scheduled to be decommissioned on February 28, 2022. For more information, refer to the timeline announcement and the v5 migration guide to use the latest version of the Twitch API.

Endpoint Description
Get Cheermotes

Retrieves the list of available cheermotes, animated emotes to which viewers can assign Bits, to cheer in chat. The cheermotes returned are available throughout Twitch, in all Bits-enabled channels.

Get Cheermotes

Retrieves the list of available cheermotes, animated emotes to which viewers can assign Bits, to cheer in chat. The cheermotes returned are available throughout Twitch, in all Bits-enabled channels.

Authentication

None

URL

GET https://api.twitch.tv/kraken/bits/actions

Optional Query Parameters

Name Type Description
channel_id string If this is specified, the cheermote for this channel is included in the response (if the channel owner has uploaded a channel-specific cheermote).

Example Request

This gets a list of all Twitch cheermotes.

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

Example Response

{
   "actions": [
      {
         "backgrounds": [
               "light",
               "dark"
         ],
         "prefix": "Cheer",
         "scales": [
               "1",
               "1.5",
               "2",
               "3",
               "4"
         ],
         "states": [
               "static",
               "animated"
         ],
         "tiers": [
               {
                  "color": "#979797",
                  "id": "1",
                  "images": {
                     "dark": {
                           "animated": {
                              "1": "https://d3aqoihi2n8ty8.cloudfront.net/actions/cheer/dark/animated/1/1.gif",
                              "1.5": "https://d3aqoihi2n8ty8.cloudfront.net/actions/cheer/dark/animated/1/1.5.gif",
                              "2": "https://d3aqoihi2n8ty8.cloudfront.net/actions/cheer/dark/animated/1/2.gif",
                              "3": "https://d3aqoihi2n8ty8.cloudfront.net/actions/cheer/dark/animated/1/3.gif",
                              "4": "https://d3aqoihi2n8ty8.cloudfront.net/actions/cheer/dark/animated/1/4.gif"
                           },
                           "static": {
                              "1": "https://d3aqoihi2n8ty8.cloudfront.net/actions/cheer/dark/static/1/1.png",
                              "1.5": "https://d3aqoihi2n8ty8.cloudfront.net/actions/cheer/dark/static/1/1.5.png",
                              "2": "https://d3aqoihi2n8ty8.cloudfront.net/actions/cheer/dark/static/1/2.png",
                              "3": "https://d3aqoihi2n8ty8.cloudfront.net/actions/cheer/dark/static/1/3.png",
                              "4": "https://d3aqoihi2n8ty8.cloudfront.net/actions/cheer/dark/static/1/4.png"
                           }
                     },
                     "light": {
                           "animated": {
                              "1": "https://d3aqoihi2n8ty8.cloudfront.net/actions/cheer/light/animated/1/1.gif",
                              "1.5": "https://d3aqoihi2n8ty8.cloudfront.net/actions/cheer/light/animated/1/1.5.gif",
                              "2": "https://d3aqoihi2n8ty8.cloudfront.net/actions/cheer/light/animated/1/2.gif",
                              "3": "https://d3aqoihi2n8ty8.cloudfront.net/actions/cheer/light/animated/1/3.gif",
                              "4": "https://d3aqoihi2n8ty8.cloudfront.net/actions/cheer/light/animated/1/4.gif"
                           },
                           "static": {
                              "1": "https://d3aqoihi2n8ty8.cloudfront.net/actions/cheer/light/static/1/1.png",
                              "1.5": "https://d3aqoihi2n8ty8.cloudfront.net/actions/cheer/light/static/1/1.5.png",
                              "2": "https://d3aqoihi2n8ty8.cloudfront.net/actions/cheer/light/static/1/2.png",
                              "3": "https://d3aqoihi2n8ty8.cloudfront.net/actions/cheer/light/static/1/3.png",
                              "4": "https://d3aqoihi2n8ty8.cloudfront.net/actions/cheer/light/static/1/4.png"
                           }
                     }
                  },
                  "min_bits": 1
               },
               ...
         ]
      },
      ...
   ]
}
+