API

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

Change Log

  • 3/23/2019 - Added v4 API (/emotes, /sets and /channels) and marked v3 as deprecated
  • 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 4 - Current

API v4 removes the bunk endpoints and reintroduces CORS.

GET https://api.twitchemotes.com/api/v4/emotes

Parameters

    id - Comma delimited list of emoticon IDs (Limit 100 IDs)

https://api.twitchemotes.com/api/v4/emotes?id=25,1771996

GET https://api.twitchemotes.com/api/v4/sets

Parameters

    id - Comma delimited list of set IDs (Limit 100 IDs)

https://api.twitchemotes.com/api/v4/sets?id=100,29712

GET https://api.twitchemotes.com/api/v4/channels/:channel_id

https://api.twitchemotes.com/api/v4/channels/23161357

Version 3 - Deprecated (Removal Date TBD)

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

Global Emoticons

https://twitchemotes.com/api_cache/v3/global.json

Subscriber Emoticons

https://twitchemotes.com/api_cache/v3/subscriber.json

Emote Set Mapping

https://twitchemotes.com/api_cache/v3/sets.json

Image ID Mapping

https://twitchemotes.com/api_cache/v3/images.json

Caching

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.