> ## Documentation Index
> Fetch the complete documentation index at: https://domoinc-openapi-sync-dataflows.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Twitch.tv Connector

## Intro

Twitch is a live streaming video platform that focuses on video gaming, including playthroughs of video games, broadcasts of eSports competitions, creative content, and music broadcasts. To learn more about the Twitch API, visit their page ([https://dev.Twitch/](https://dev.Twitch/ "https://dev.Twitch/") ).

You connect to your Twitch account in the Data Center. This topic discusses the fields and menus that are specific to the Twitch connector user interface. General information for adding DataSets, setting update schedules, and editing DataSet information is discussed in [Adding a DataSet Using a Data Connector](https://domo-support.domo.com/s/article/360042926274?language=en_US "Adding a DataSet Using a Data Connector").

## Prerequisites

To connect to your Twitch account and create a DataSet, you must have the username and password for your Twitch account.

## Connecting to Your Twitch Account

This section enumerates the options in the **Credentials** and **Details** panes in the Twitch Connector page. The components of the other panes in this page, **Scheduling** and **Name & Describe Your DataSet,** are universal across most connector types and are discussed in greater length in [Adding a DataSet Using a Data Connector](https://domo-support.domo.com/s/article/360042926274?language=en_US "Adding a DataSet Using a Data Connector").

### Credentials Pane

The Domo Twitch connector uses OAuth to connect, so there is no need to enter credentials within Domo. Click **Connect** (or select **Add Account** if you have existing Twitch accounts in Domo) to open the Twitch OAuth screen where you can enter your Twitch username and password. Once you have entered valid Twitch credentials, you can use the same account any time you go to create a new Twitch DataSet. You can manage connector accounts in the **Accounts** tab in the Data Center. For more information about this tab, see [Managing User Accounts for Connectors](https://domo-support.domo.com/s/article/360042926054?language=en_US "Managing User Accounts for Connectors").

<Note>
  **Note:** If you are already logged into Twitch when you connect in Domo, you are authenticated automatically when you click **Add account**. If you want to connect to an account that is different from the one you are logged into, you must first log out of Twitch.
</Note>

### Details Pane

This pane contains a primary **Reports** menu, along with various other menus which may or may not appear depending on the report type you select.

<table border="1" cellpadding="1" cellspacing="1" data-aura-rendered-by="33:195;a"><thead><tr><th colspan="1" rowspan="1"><p> Menu </p></th><th colspan="1" rowspan="1"><p> Description </p></th></tr></thead><tbody><tr><td colspan="1" rowspan="1"><p> Report </p></td><td colspan="1" rowspan="1"><p> Select the Twitch report you want to run. The following reports are available: </p><table border="1" cellpadding="1" cellspacing="1"><tbody><tr><td colspan="1" rowspan="1"><b> Report Name </b></td><td colspan="1" rowspan="1"><b> Description </b></td></tr><tr><td colspan="1" rowspan="1"><p> Active Teams(Deprecated) </p></td><td colspan="1" rowspan="1"> Gets a list of all active teams. </td></tr><tr><td colspan="1" rowspan="1"><p> All Streams(Deprecated) </p></td><td colspan="1" rowspan="1"> Gets a list of all live streams. </td></tr><tr><td colspan="1" rowspan="1"><p> Banned Event </p></td><td colspan="1" rowspan="1"> Retrieves all user bans and un-bans in a channel. </td></tr><tr><td colspan="1" rowspan="1"><p> Banned User </p></td><td colspan="1" rowspan="1"> Retrieves all banned and timed-out users in a channel. </td></tr><tr><td colspan="1" rowspan="1"><p> Bits Leader Board </p></td><td colspan="1" rowspan="1"> Retrieves a ranked list of Bits leaderboard information for an authorized broadcaster. </td></tr><tr><td colspan="1" rowspan="1"><p> Broadcaster Subscriptions </p></td><td colspan="1" rowspan="1"> Retrieves all of a broadcaster's subscriptions. </td></tr><tr><td colspan="1" rowspan="1"><p> Channel Information </p></td><td colspan="1" rowspan="1"> Retrieves channel information for users. </td></tr><tr><td colspan="1" rowspan="1"><p> Channel Follows(Deprecated) </p></td><td colspan="1" rowspan="1"> Gets a list of users who follow a specified channel. </td></tr><tr><td colspan="1" rowspan="1"><p> Channel Streams(Deprecated) </p></td><td colspan="1" rowspan="1"> Gets stream information for a specified user. </td></tr><tr><td colspan="1" rowspan="1"><p> Cheermotes </p></td><td colspan="1" rowspan="1"> Retrieves the list of available Cheermotes, animated emotes to which viewers can assign Bits, to cheer in chat. </td></tr><tr><td colspan="1" rowspan="1"><p> Clips </p></td><td colspan="1" rowspan="1"> Retrieves clip information by clip ID (one or more), broadcaster ID (one only), or game ID (one only). </td></tr><tr><td colspan="1" rowspan="1"><p> Code Status </p></td><td colspan="1" rowspan="1"> Retrieves the status of one or more provided codes. </td></tr><tr><td colspan="1" rowspan="1"><p> Current Streams Summary(Deprecated) </p></td><td colspan="1" rowspan="1"> Gets a summary of live streams. </td></tr><tr><td colspan="1" rowspan="1"><p> Extension Analytics </p></td><td colspan="1" rowspan="1"> Retrieves a URL that extension developers can use to download analytics reports (CSV files) for their extensions. The URL is valid for 5 minutes. </td></tr><tr><td colspan="1" rowspan="1"><p> Extension Transactions </p></td><td colspan="1" rowspan="1"> Retrieves a list of transactions that have occur for their extension across all of Twitch. </td></tr><tr><td colspan="1" rowspan="1"><p> Followed Streams(Deprecated) </p></td><td colspan="1" rowspan="1"> Gets a list of online streams a user follows. </td></tr><tr><td colspan="1" rowspan="1"><p> Game Analytics </p></td><td colspan="1" rowspan="1"> Retrieves a URL that game developers can use to download analytics reports (CSV files) for their games. The URL is valid for 5 minutes. </td></tr><tr><td colspan="1" rowspan="1"><p> Games </p></td><td colspan="1" rowspan="1"> Retrieves game information by game ID or name. </td></tr><tr><td colspan="1" rowspan="1"><p> Get Specific Channel(Deprecated) </p></td><td colspan="1" rowspan="1"> Gets a list of specified channel details. </td></tr><tr><td colspan="1" rowspan="1"><p> Hype Train Events </p></td><td colspan="1" rowspan="1"> Retrieves the information of the most recent Hype Train of the given channel ID. When there is currently an active Hype Train, it returns information about that Hype Train. </td></tr><tr><td colspan="1" rowspan="1"><p> Moderator Events </p></td><td colspan="1" rowspan="1"> Retrieves a list of moderators or users added and removed as moderators from a channel. </td></tr><tr><td colspan="1" rowspan="1"><p> Moderators </p></td><td colspan="1" rowspan="1"> Retrieves all moderators in a channel. </td></tr><tr><td colspan="1" rowspan="1"><p> Search Channels </p></td><td colspan="1" rowspan="1"> Retrieves a list of channels (users who have streamed within the past 6 months) that match the query via channel name or description either entirely or partially. Results include both live and offline channel. </td></tr><tr><td colspan="1" rowspan="1"><p> Stream Markers </p></td><td colspan="1" rowspan="1"> Retrieves a list of markers for either a specified user's most recent stream. </td></tr><tr><td colspan="1" rowspan="1"><p> Search Streams(Deprecated) </p></td><td colspan="1" rowspan="1"> Searches for streams based on a specified search query. A list of streams is returned if the search query parameter is matched entirely or partially, in the channel description or in the game name. </td></tr><tr><td colspan="1" rowspan="1"><p> Stream Tags </p></td><td colspan="1" rowspan="1"> Retrieves the list of all stream tags defined by Twitch, optionally filtered by tag ID(s). </td></tr><tr><td colspan="1" rowspan="1"><p> Streams </p></td><td colspan="1" rowspan="1"> Retrieves information about active streams. Streams are returned sorted by the number of current viewers, in descending order. </td></tr><tr><td colspan="1" rowspan="1"><p> Top Games </p></td><td colspan="1" rowspan="1"> Retrieves games sorted by the number of current viewers on Twitch, most popular first. </td></tr><tr><td colspan="1" rowspan="1"><h3> Users </h3></td><td colspan="1" rowspan="1"> Retrieves information about one or more specified Twitch users. Users are identified by optional user IDs and/or login name. If neither a user ID nor a login name is specified, the user is looked up by Bearer token. </td></tr><tr><td colspan="1" rowspan="1"><p> User's Channels(Deprecated) </p></td><td colspan="1" rowspan="1"> Get a list of all User's Channels. </td></tr><tr><td colspan="1" rowspan="1"><p> Users Follow </p></td><td colspan="1" rowspan="1"> Retrieves information on follow relationships between two Twitch users. At a minimum, from\_id or to\_id must be provided for a query to be valid. </td></tr><tr><td colspan="1" rowspan="1"><p> User Extensions </p></td><td colspan="1" rowspan="1"> Retrieves a list of all extensions (both active and inactive) for a specified user, identified by a Bearer token. </td></tr><tr><td colspan="1" rowspan="1"><p> Videos </p></td><td colspan="1" rowspan="1"> Retrieves video information by game ID (one only), user ID (one only) or video ID(up to 100). </td></tr></tbody></table></td></tr><tr><td colspan="1" rowspan="1"><p> Username </p></td><td colspan="1" rowspan="1"><p> Enter the username of the user you want to retrieve information for. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Channel Name </p></td><td colspan="1" rowspan="1"><p> Enter the name of the video channel you want to retrieve information for. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Search Query </p></td><td colspan="1" rowspan="1"><p> Enter the query you want to return results for. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Period </p></td><td colspan="1" rowspan="1"><p> Select the timeframe for the report. </p></td></tr><tr><td colspan="1" rowspan="1"><p> User's Channel </p></td><td colspan="1" rowspan="1"><p> Returns a list of all of your channels. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Videos </p></td><td colspan="1" rowspan="1"><p> Returns a list of VODs (Videos on Demand) for a specified channel. </p></td></tr></tbody></table>

### Other Panes

For information about the remaining sections of the connector interface, including how to configure scheduling, retry, and update options, see [Adding a DataSet Using a Data Connector](https://domo-support.domo.com/s/article/360042926274?language=en_US "Adding a DataSet Using a Data Connector").