Skip to main content
Returns a range of metadata around a broadcaster’s channel that can be accessed via multiple different variable members for each unique piece of information.

$(channel)

Returns the same as $(channel.login), the lowercase version of a broadcaster’s username (otherwise known as login).

Parameters

This variable does not take any parameters.

Example Output

  • $(channel)

$(channel.accountage)

Returns the time that has passed since a broadcaster created their Twitch account.

Parameters

This variable does not take any parameters.

Example Output

  • $(channel.accountage)

$(channel.accountsince)

Returns the date when a broadcaster created their Twitch account in coordinated universal time (UTC).

Parameters

This variable does not take any parameters.

Example Output

  • $(channel.accountsince)

$(channel.bio)

Returns the Twitch bio of the channel.

Parameters

This variable does not take any parameters.

Example Output

  • $(channel.bio)

Error Output

  • In case the channels’ bio is empty/not set, returns the following:

$(channel.display_name)

Returns the uppercase version, or internationalized version of a broadcaster’s username.

Parameters

This variable does not take any parameters.

Example Output

  • $(channel.display_name)

$(channel.followers)

Returns the current number of followers of a broadcaster.

Parameters

This variable does not take any parameters.

Example Output

  • $(channel.followers)

$(channel.id)

Returns the internal Fossabot ID of a broadcaster, not to be confused with the Twitch ID.

Parameters

This variable does not take any parameters.

Example Output

  • $(channel.id)

$(channel.login)

Returns the same as $(channel), the lowercase version of a broadcaster’s username (otherwise known as login).

Parameters

This variable does not take any parameters.

Example Output

  • $(channel.login)

$(channel.provider)

Returns the platform a broadcaster’s account was created on (i.e. twitch).

Parameters

This variable does not take any parameters.

Example Output

  • $(channel.provider)

$(channel.provider_id)

Returns the platform ID (e.g. the Twitch ID) of a broadcaster, not to be confused with the internal Fossabot ID.

Parameters

This variable does not take any parameters.

Example Output

  • $(channel.provider_id)

$(channel.slug)

Returns the Fossabot channel URL of a broadcaster. This is useful for linking to commands pages, and dashboards on Fossabot.
Fossabot slugs might not match a broadcaster’s username!It’s important to note that just like Twitch, Fossabot has to ensure that all channel URLs on the platform remain unique. Therefore we handle cases where someone may have had the same name as you on Twitch before in a special way.For example, someone named bob logged into Fossabot. Later, bob namechanged to bob123 and never logged into Fossabot again. If you changed your username to bob and tried to log into Fossabot, you would likely get a randomly generated channel slug such as bob_2353.If you believe that your channel name is available and that the user that has taken your name is inactive, feel free to reach out to us on Discord and we might be able to help you obtain your original channel slug.

Parameters

This variable does not take any parameters.

Example Output

  • $(channel.slug)

$(channel.stream_id)

Returns the provider ID of the current live stream session.

Parameters

This variable does not take any parameters.

Example Output

  • $(channel.stream_id)

Error Output

  • In case a broadcaster’s stream is currently offline, returns the following:

$(channel.subscribers)

Returns the current number of users subscribed to a broadcaster.

Parameters

This variable does not take any parameters.

Example Output

  • $(channel.subscribers)

$(channel.subpoints)

Returns the current number of sub points of a broadcaster.

Parameters

This variable does not take any parameters.

Example Output

  • $(channel.subpoints)

$(channel.uptime)

Returns the time that has passed since a broadcaster’s stream has gone live.

Parameters

This variable does not take any parameters.

Example Output

  • $(channel.uptime)

Error Output

  • In case a broadcaster’s stream is currently offline, returns the following:

$(channel.viewers)

Returns the current number of viewers watching a broadcaster’s stream.

Parameters

This variable does not take any parameters.

Example Output

  • $(channel.viewers)

Error Output

  • In case a broadcaster’s stream is currently offline, returns the following: