API

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

Version 3 Current

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

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

Example Response:

Subscriber Emoticons

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

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

Example Response:

Emote Set Mapping

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

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

Example Response:

Image ID Mapping

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

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

Example Response:

Version 2 Deprecated

Version 2 is only returning static content and will not contain any new emote data.

Global Emoticons

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

Subscriber Emoticons

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

Emote Set Mapping

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

Image ID Mapping

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

JSONP, CORS, etc.

JSONP is not supported. However we do offer basic CORS support on the listed endpoints.

Caching

API data is currently updated every 30 minutes (the same as the main site) so polling any more often will not be beneficial.

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.