Chat

Endpoint Description
Get Chat Badges by Channel Gets a list of badges that can be used in chat for a specified channel.
Get Chat Emoticons by Set Gets all chat emoticons (not including their images) in one or more specified sets. If no set is specified, all chat emoticons are returned.
Get All Chat Emoticons Gets all chat emoticons (including their images).

Get Chat Badges by Channel

Gets a list of badges that can be used in chat for a specified channel.

Authentication

None

URL

GET https://api.twitch.tv/kraken/chat/<channel ID>/badges

Optional Query String Parameters

None

Example Request

This gets a list of chat badges for channel 44322889.

1
2
3
curl -H 'Accept: application/vnd.twitchtv.v5+json' \
-H 'Client-ID: uo6dggojyb8d6soh92zknwmi5ej1q2' \
-X GET 'https://api.twitch.tv/kraken/chat/44322889/badges'

Example Response

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
{
   "admin": {
      "alpha": "https://static-cdn.jtvnw.net/chat-badges/admin-alpha.png",
      "image": "https://static-cdn.jtvnw.net/chat-badges/admin.png",
      "svg": "https://static-cdn.jtvnw.net/chat-badges/admin.svg"
   },
   "broadcaster": {
      "alpha": "https://static-cdn.jtvnw.net/chat-badges/broadcaster-alpha.png",
      "image": "https://static-cdn.jtvnw.net/chat-badges/broadcaster.png",
      "svg": "https://static-cdn.jtvnw.net/chat-badges/broadcaster.svg"
   },
   "global_mod": {
      "alpha": "https://static-cdn.jtvnw.net/chat-badges/globalmod-alpha.png",
      "image": "https://static-cdn.jtvnw.net/chat-badges/globalmod.png",
      "svg": "https://static-cdn.jtvnw.net/chat-badges/globalmod.svg"
   },
   "mod": {
      "alpha": "https://static-cdn.jtvnw.net/chat-badges/mod-alpha.png",
      "image": "https://static-cdn.jtvnw.net/chat-badges/mod.png",
      "svg": "https://static-cdn.jtvnw.net/chat-badges/mod.svg"
   },
   "staff": {
      "alpha": "https://static-cdn.jtvnw.net/chat-badges/staff-alpha.png",
      "image": "https://static-cdn.jtvnw.net/chat-badges/staff.png",
      "svg": "https://static-cdn.jtvnw.net/chat-badges/staff.svg"
   },
   "subscriber": null,
   "turbo": {
      "alpha": "https://static-cdn.jtvnw.net/chat-badges/turbo-alpha.png",
      "image": "https://static-cdn.jtvnw.net/chat-badges/turbo.png",
      "svg": "https://static-cdn.jtvnw.net/chat-badges/turbo.svg"
   }
}

Get Chat Emoticons by Set

Gets all chat emoticons (not including their images) in one or more specified sets.

Caution: When not specifying the emotesets parameter, this endpoint returns a large amount of data.

Authentication

None

URL

GET https://api.twitch.tv/kraken/chat/emoticon_images

Optional Query String Parameter

Name Type Description
emotesets list of integers Specifies the set(s) of emoticons to retrieve. If no set is specified, all chat emoticons are returned.

Example Request

This gets a list of emoticons in set 19151.

1
2
3
curl -H 'Accept: application/vnd.twitchtv.v5+json' \
-H 'Client-ID: uo6dggojyb8d6soh92zknwmi5ej1q2' \
-X GET 'https://api.twitch.tv/kraken/chat/emoticon_images?emotesets=19151'

Example Response with Emotesets

1
2
3
4
5
6
7
8
{
   "emoticon_sets": {
      "19151": [{
         "code": "TwitchLit",
         "id": 115390
      }]
   }
}

Example Request

This gets a list of all emoticons.

1
2
3
curl -H 'Accept: application/vnd.twitchtv.v5+json' \
-H 'Client-ID: uo6dggojyb8d6soh92zknwmi5ej1q2' \
-X GET 'https://api.twitch.tv/kraken/chat/emoticon_images'

Example Response without Emotesets

1
2
3
4
5
6
7
8
9
10
11
{
   "emoticons": [
      ...
      {
         "code": "TwitchLit",
         "emoticon_set": 19151,
         "id": 115390
      },
      ...
   ]
}

Get All Chat Emoticons

Gets all chat emoticons (including their images).

Caution: This endpoint returns a large amount of data.

Authentication

None

URL

GET https://api.twitch.tv/kraken/chat/emoticons

Optional Query String Parameters

None

Example Request

This gets a list of all emoticons.

1
2
3
curl -H 'Accept: application/vnd.twitchtv.v5+json' \
-H 'Client-ID: uo6dggojyb8d6soh92zknwmi5ej1q2' \
-X GET 'https://api.twitch.tv/kraken/chat/emoticons'

Example Response

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
{
   "_links": {
      "self": "http://api.twitch.tv/kraken/chat/emoticons"
   },
   "emoticons": [
      {
         "regex": "TwitchLit",
         "images": [
            {
               "width": 28,
               "height": 28,
               "url": "https://static-cdn.jtvnw.net/jtv_user_pictures/emoticon-115390-src-b577ded8522fc1a1-28x28.png",
               "emoticon_set": 19151
            }
         ]
      },
      {
         "regex": "Kappa",
         "images": [
            {
               "width": 28,
               "height": 28,
               "url": "https://static-cdn.jtvnw.net/jtv_user_pictures/emoticon-80393-src-cf7c8d03a4c5cb75-28x28.png",
               "emoticon_set": 15940
            }
         ]
      }
      ...
   ]
}