View as Markdown
Twitch icon

Twitch ACTION

Get Videos

Gets video information by video ID, user ID, or game ID. See the documentation
  • Action
  • Read only
  • OAuth
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Twitch account once, then configure and run Get Videos from your backend or agent.

import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "twitch-get-videos",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    twitch: { authProvisionId: "apn_xxxxxxx" },
    id: "Video ID",
    userId: "User",
  },
})

console.log(result)

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

Get Videos inputs
Property Type Description
id Video ID string
ID of the video being queried. If this is specified, you cannot use any of the optional query parameters below. Each request must specify one video id, one user_id, or one game_id.
Optional
userId User string
The Twitch user whose videos to retrieve. Accepts a numeric user ID (e.g. 141981764) or login name (e.g. twitchdev). Each request must specify one video ID, user ID, or game ID.
Optional Dynamic
gameId Game ID string
ID of the game the video is of. Each request must specify one video id, one user_id, or one game_id.
Optional
language Stream Language string
Language of the video being queried. A language value must be either the ISO 639-1 two-letter code for a supported stream language or “other”.
Optional
period Period string
Period during which the video was created. Defaults to “all” if left blank
Optional
sort Sort string
Sort order of the videos. Defaults to “time” if left blank
Optional
type Type string
Type of video. Defaults to “all” if left blank
Optional
max Max Items integer
Maximum number of videos to return
Required

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key
twitch-get-videos
Version
0.2.1
App
Twitch
Authentication
OAuth
Read-only
Yes
Destructive
No
Open world
Yes