Requests

API requests

pytwitcherapi.TwitchSession class is the central class for interacting with twitch.tv:

import pytwitcherapi

ts = pytwitcherapi.TwitchSession()

To query all top games use:

topgames = ts.top_games()

Get streams and playlist for every game:

for game in topgames:
    streams = ts.get_streams(game=game)
    for stream in streams:
        channel = stream.channel
        playlist = ts.get_playlist(channel)

As you can see games, channels, streams are wrapped into objects. See pytwitcherapi.Game, pytwitcherapi.Channel, pytwitcherapi.Stream, pytwitcherapi.User.

You can use your own Client-ID for twitch by setting the environment variable PYTWITCHER_CLIENT_ID.

Custom requests

You can also issue custom requests. The pytwitcherapi.TwitchSession is actually a subclass of requests.Session. So basically you can use pytwitcherapi.TwitchSession.request() to issue arbitrary requests. To make it easier to use the different twitch APIs there are a few helpers.

You can get easy access to three different twitch APIs:

• Kraken API witch uses pytwitcherapi.session.TWITCH_KRAKENURL. Use pytwitcherapi.session.TwitchSession.kraken_request().
• Usher API with uses pytwitcherapi.session.TWITCH_USHERURL. Use pytwitcherapi.session.TwitchSession.usher_request().
• The old twitch API pytwitcherapi.session.TWITCH_APIURL. Use pytwitcherapi.session.TwitchSession.oldapi_request().

import pytwitcherapi

ts = pytwitcherapi.TwitchSession()

topgames = ts.top_games()

for game in topgames:
    streams = ts.get_streams(game=game)
    for stream in streams:
        channel = stream.channel
        playlist = ts.get_playlist(channel)