Work in progress

This documentation page is currently work in progress.
Not all existing DecAPI endpoints are documented here yet. For the currently active documentation, please visit docs.decapi.me.

List BetterTTV channel emotes

Returns a space-separated list of BetterTTV emotes available in the channel.
For users that have the BetterTTV browser extension installed (or use a BetterTTV-enabled chat client), the result will display as emotes in chat.

Endpoint URL

https://decapi.me/bttv/emotes/YOUR_TWITCH_CHANNEL_NAME

See examples below for different ways to use the endpoint, using a real Twitch channel name.

Required URL parameters

• channel - The Twitch channel name to retrieve emotes from.

Query parameters

• types - Optional - A comma-separated list of types to return. Your options are:
  • all - Default if not specified. Returns all types of emotes.
  • gif - Returns only animated GIF emotes.
  • png - Returns only static PNG image emotes.

Examples

These examples use the Twitch channel name: decicus
Make sure to replace decicus in the URL with the correct Twitch channel name for the channel you wish to get the emotes for.

• Example with all types of emotes (default): https://decapi.me/bttv/emotes/decicus
• Example with only getting animated GIF emotes: https://decapi.me/bttv/emotes/decicus?types=gif
• Example with only getting static PNG emotes: https://decapi.me/bttv/emotes/decicus?types=png
• Example with explicitly getting all types of emotes: https://decapi.me/bttv/emotes/decicus?types=gif,png
  • This practically works the same as all (default), but explicitly requests both types of emotes.

Examples for bots

Nightbot

Note: Nightbot will automatically convert variables, such as $(channel) or $(touser) to the correct channel name / username, when the command is used.
You do not have to change those variables.

• All types of emotes (default): $(urlfetch https://decapi.me/bttv/emotes/$(channel))
• Only animated GIF emotes: $(urlfetch https://decapi.me/bttv/emotes/$(channel)?types=gif)
• Only static PNG emotes: $(urlfetch https://decapi.me/bttv/emotes/$(channel)?types=png)

Fossabot

Note: Fossabot will automatically convert variables, such as $(channel) or $(user.login) to the correct channel name / username, when the command is used.
You do not have to change those variables.

• All types of emotes (default): $(customapi https://decapi.me/bttv/emotes/$(channel))
• Only animated GIF emotes: $(customapi https://decapi.me/bttv/emotes/$(channel)?types=gif)
• Only static PNG emotes: $(customapi https://decapi.me/bttv/emotes/$(channel)?types=png)

StreamElements

Note: StreamElements will automatically convert variables, such as ${channel} or ${touser} to the correct channel name / username, when the command is used.
You do not have to change those variables.

• All types of emotes (default): ${customapi.https://decapi.me/bttv/emotes/${channel}}
• Only animated GIF emotes: ${customapi.https://decapi.me/bttv/emotes/${channel}?types=gif}
• Only static PNG emotes: ${customapi.https://decapi.me/bttv/emotes/${channel}?types=png}

Streamlabs Chat Bot

Note: Streamlabs Chat Bot will automatically convert variables, such as $mychannel or $touserid to the correct channel name / username, when the command is used.
You do not have to change those variables.

• All types of emotes (default): $readapi(https://decapi.me/bttv/emotes/$mychannel)
• Only animated GIF emotes: $readapi(https://decapi.me/bttv/emotes/$mychannel?types=gif)
• Only static PNG emotes: $readapi(https://decapi.me/bttv/emotes/$mychannel?types=png)

Streamlabs Cloudbot

Note: Streamlabs Cloudbot will automatically convert variables, such as {channel.name} or {touser.name} to the correct channel name / username, when the command is used.
You do not have to change those variables.

• All types of emotes (default): {readapi.https://decapi.me/bttv/emotes/{channel.name}}
• Only animated GIF emotes: {readapi.https://decapi.me/bttv/emotes/{channel.name}?types=gif}
• Only static PNG emotes: {readapi.https://decapi.me/bttv/emotes/{channel.name}?types=png}

Deepbot

Note: Deepbot will automatically convert variables, such as @stream@ or @user@ to the correct channel name / username, when the command is used.
You do not have to change those variables.

• All types of emotes (default): @customapi@[https://decapi.me/bttv/emotes/@stream@]
• Only animated GIF emotes: @customapi@[https://decapi.me/bttv/emotes/@stream@?types=gif]
• Only static PNG emotes: @customapi@[https://decapi.me/bttv/emotes/@stream@?types=png]

PhantomBot

Note: PhantomBot will automatically convert variables, such as (channelname) or (touser) to the correct channel name / username, when the command is used.
You do not have to change those variables.

• All types of emotes (default): (customapi https://decapi.me/bttv/emotes/(channelname))
• Only animated GIF emotes: (customapi https://decapi.me/bttv/emotes/(channelname)?types=gif)
• Only static PNG emotes: (customapi https://decapi.me/bttv/emotes/(channelname)?types=png)