We have an API available to integrate data into 3rd party applications.

Change Log

  • 2/2/2019 - Added statistics API (/emotes and /top/today)
  • 8/3/2018 - Subscriber_badges, bits_badges, and cheermotes have been removed from Subscriber API due to introduction of affiliate tenure badges. You can use first party APIs to obtain this information anyway.
  • 9/28/2017 - API v2 removed and CORS disabled on v3 due to response size which should not be requested in a browser application anyway

Version 3 Current

v3 brings structural changes to the responses as well and a shift toward channel IDs and instead of names.

Global Emoticons


Provides site-wide emotes available to all users. Keys are emote codes.

Example Response:

Subscriber Emoticons


Provides information about channels with subscriber emotes. Keys are channel IDs.

Example Response:

Emote Set Mapping


Provides a mapping of emoticon sets to channel IDs and names. Keys are emoticon set IDs

Example Response:

Image ID Mapping


Provides channel channel IDs and names for each emote. Keys are emote IDs.

Example Response:


API data is currently updated every 30 minutes (the same as the main site) so polling any more often will not be beneficial. Browser applications or extensions should not send requests to the API directly. You must cache on a your own backend server and then distribute to clients.

Terms of Use

You are free to use this data** as a source for any application as long as you credit the source (this site) in all derivative works. We ask that you do not use this data to create a website directly mimicing our functionality. For applications with large traffic, we ask that you cache this data and do not pull directly from our API.

**Data is defined as added information we provide that is not generally available in the Twitch API (general emote descriptions, set ID -> channel name mappings, etc.)

Emote and badge images are property of Twitch Interactive or their respective owners. Do not reuse without obtaining their permission.

This is an independent site not run by Twitch. We love the community and wanted to build this resource for them.