Skip to content
twitch.apiv2.0

Reference / API groups

twitch.teams

Teams: look one up, list the teams of a channel.

Every method of twitch.teams, with its parameters, what it returns and the token it needs.

twitch.teams.ofChannel(params, options?): Promise<ChannelTeam[]>

Lists the teams a broadcaster is a member of. The list is empty when there are none.

Token: app or user.

NameTypeDescription
broadcaster_id requiredstringBroadcaster whose teams to list.

options: Request options for this call: as, token, signal, timeout, retries.

Promise<ChannelTeam[]>

Fields of ChannelTeam
NameTypeDescription
broadcaster_idstringID of the broadcaster.
broadcaster_loginstringLogin name of the broadcaster.
broadcaster_namestringDisplay name of the broadcaster.
background_image_urlstring | nullURL of the background image, or null when the team has none.
bannerstring | nullURL of the banner, or null when the team has none.
created_atstringWhen the team was created, as an RFC 3339 timestamp.
updated_atstringWhen the team was last changed, as an RFC 3339 timestamp.
infostringDescription of the team. May hold HTML, Markdown and line breaks.
thumbnail_urlstringURL of the team logo.
team_namestringName of the team: the one that appears in URLs.
team_display_namestringDisplay name of the team.
idstringID of the team.
const teams = await twitch.teams.ofChannel({ broadcaster_id: "141981764" });

Twitch reference

twitch.teams.get(params, options?): Promise<Team | null>

Gets a team and its members, by name or by ID. Resolves with null when Twitch returns no team.

Token: app or user.

NameTypeDescription
namestringName of the team.
idstringID of the team.

options: Request options for this call: as, token, signal, timeout, retries.

Promise<Team \| null>

Fields of Team
NameTypeDescription
usersTeamMember[]Members of the team.
background_image_urlstring | nullURL of the background image, or null when the team has none.
bannerstring | nullURL of the banner, or null when the team has none.
created_atstringWhen the team was created, as an RFC 3339 timestamp.
updated_atstringWhen the team was last changed, as an RFC 3339 timestamp.
infostringDescription of the team. May hold HTML, Markdown and line breaks.
thumbnail_urlstringURL of the team logo.
team_namestringName of the team: the one that appears in URLs.
team_display_namestringDisplay name of the team.
idstringID of the team.
const team = await twitch.teams.get({ name: "livecoders" });
console.log(team?.users.length);

Twitch reference