Skip to content
twitch.apiv2.0

Reference

Reference

Every method, every event type, every scope and every error of the library.

The library has 155 methods in 30 groups, which cover every endpoint of the Helix API, and types the 83 EventSub event types. The group pages and the list of events are generated from the source code, so they always match the published version.

Each group is a property of the client: twitch.chat, twitch.moderation… Its page gives, for each method, the signature, the token it needs, the parameters, what comes back and an example.

GroupCoversMethods
twitch.adsAds: run commercials, read the ad schedule, snooze the next ad.3
twitch.analyticsAnalytics: downloadable reports for your extensions and games.2
twitch.bitsBits: leaderboard, Cheermotes, custom Power-ups and extension transactions.4
twitch.channelPointsChannel Points: custom rewards and their redemptions.6
twitch.channelsChannels: title, category and tags, editors, follows and followers.5
twitch.charityCharity: the active campaign and its donations.2
twitch.chatChat: send messages and announcements, chatters, emotes, badges, settings, colors, pins and shoutouts.19
twitch.clipsClips: create, look up and download clips.4
twitch.conduitsConduits: the EventSub transport that spreads events over several shards.6
twitch.contentLabelsContent classification labels and their localized names.1
twitch.entitlementsDrops entitlements: list them and mark them fulfilled.2
twitch.eventsubEventSub: subscriptions, and the WebSocket, webhook and conduit listeners.6
twitch.extensionsExtensions: configuration, secrets, PubSub and chat messages, Bits products.12
twitch.gamesGames and categories: look them up, list the most watched.2
twitch.goalsCreator goals of a channel.1
twitch.guestStarGuest Star (beta): sessions, invites and slots.12
twitch.hypeTrainHype Train: the current train and the channel records.1
twitch.moderationModeration: bans, timeouts, warnings, AutoMod, blocked terms, moderators, VIPs and Shield Mode.25
twitch.pollsPolls: create, read and end them.3
twitch.predictionsPredictions: create, read, lock and resolve them.3
twitch.raidsRaids: start one, cancel a pending one.2
twitch.scheduleStream schedule: segments, vacation and the iCalendar feed.6
twitch.searchSearch for categories and channels.2
twitch.streamsStreams: who is live, stream keys and markers.5
twitch.subscriptionsSubscriptions: the subscribers of a channel, and whether a user is one.2
twitch.tagsStream tags (deprecated by Twitch, kept for completeness).2
twitch.teamsTeams: look one up, list the teams of a channel.2
twitch.usersUsers: profiles, block list and installed extensions.12
twitch.videosVideos: VODs, highlights and uploads.2
twitch.whispersWhispers: send a private message to a user.1
  • Event types: every EventSub subscription type, its version, its condition and its scope.
  • Scopes: every OAuth scope and the methods it unlocks.
  • Errors: every error class, its fields and when it is thrown.
  • Client options: the options of new Twitch(), the methods of the client and the request options.