Work in progress

This documentation page is currently work in progress.
Not all existing DecAPI endpoints are documented here yet - mostly Twitch and YouTube endpoints. The rest of the endpoints should have accurate documentation :)
For the currently active documentation, please visit docs.decapi.me.

Cached endpoint

This endpoint is cached and won't always be fully up-to-date. See the Cached endpoints page for more information.

Subscriber emotes - Subscriber emotes for a Twitch channel

Retrieves the subscriber emotes for the specified channel and lists them (space-separated).

Depending on your bot's subscription status and subscription tier, emotes may either be listed as plain text, the actual emotes or a mix of both.

Endpoint URL

https://decapi.me/twitch/subscriber_emotes/CHANNEL_USERNAME_HERE

Required URL parameters

• channel - Required - Twitch channel to retrieve subscriber emotes for.

Query parameters

• tiers - Optional (only available in JSON responses) - When specified, emotes are split into their respective subscriber tiers.

Notes

• JSON results are supported, pass the header Accept: application/json to receive JSON output.

Examples

• Decicus' subscriber emotes: https://decapi.me/twitch/subscriber_emotes/decicus
• LIRIK's subscriber emotes with tiers in JSON: https://decapi.me/twitch/subscriber_emotes/lirik?tiers=1
  • Only works when passing the Accept: application/json header, example with cURL:
    curl -H "Accept: application/json" "https://decapi.me/twitch/subscriber_emotes/lirik?tiers=1"

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.

• Get subscriber emotes for a channel
  $(urlfetch https://decapi.me/twitch/subscriber_emotes/$(channel))

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.

• Get subscriber emotes for a channel
  $(customapi https://decapi.me/twitch/subscriber_emotes/$(channel))

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.

• Get subscriber emotes for a channel
  ${customapi.https://decapi.me/twitch/subscriber_emotes/${channel}}

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.

• Get subscriber emotes for a channel
  $readapi(https://decapi.me/twitch/subscriber_emotes/$mychannel)

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.

• Get subscriber emotes for a channel
  {readapi.https://decapi.me/twitch/subscriber_emotes/{channel.name}}

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.

• Get subscriber emotes for a channel
  @customapi@[https://decapi.me/twitch/subscriber_emotes/@stream@]

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.

• Get subscriber emotes for a channel
  (customapi https://decapi.me/twitch/subscriber_emotes/(channelname))