Skip to main content

$(channel)

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)

    fossabot

$(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)

    3 years, 2 months and 1 day

$(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)

    Mon, 06 Apr 2015 23:09:03 UTC

$(channel.bio)

Returns the Twitch bio of the channel.

Parameters

This variable does not take any parameters.

Example Output

  • $(channel.bio)

    Fossabot is a Twitch chat bot that has all the features you need to create the ultimate chat experience for yourself and your audience. Built by the community, for the community.

Error Output

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

    <empty>

$(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)

    Fossabot

$(channel.followers)

Returns the current number of followers of a broadcaster.

Parameters

This variable does not take any parameters.

Example Output

  • $(channel.followers)

    5305

$(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)

    123

$(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)

    fossabot

$(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)

    twitch

$(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)

    237719657

$(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)

    fossabot

$(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)

    123456789

Error Output

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

    [Error: Stream is offline.]

$(channel.subscribers)

Returns the current number of users subscribed to a broadcaster.

Parameters

This variable does not take any parameters.

Example Output

  • $(channel.subscribers)

    36

$(channel.subpoints)

Returns the current number of sub points of a broadcaster.

Parameters

This variable does not take any parameters.

Example Output

  • $(channel.subpoints)

    46

$(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)

    3 hours and 25 minutes

Error Output

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

    [Error: Stream is offline.]

$(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)

    36

Error Output

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

    [Error: Stream is offline.]