Contents

Bits Reference

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