View as Markdown
Twitch icon

Twitch ACTION

Get Clips

Gets clip information by clip ID, user ID, or game ID
  • Action
  • Read only
  • OAuth
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Twitch account once, then configure and run Get Clips 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-clips",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    twitch: { authProvisionId: "apn_xxxxxxx" },
    id: "Clip ID",
    broadcaster: "Broadcaster Id",
  },
})

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 Clips inputs
Property Type Description
id Clip ID string
ID of the video being queried. For a query to be valid, id, broadcaster_id, or game_id must be specified. You may specify only one of these parameters.
Optional
broadcaster Broadcaster Id string
ID of the broadcaster for whom clips are returned. Results are ordered by view count. For a query to be valid, id, broadcaster_id, or game_id must be specified. You may specify only one of these parameters.
Optional
gameId Game ID string
ID of the game the clip is of. For a query to be valid, id, broadcaster_id, or game_id must be specified. You may specify only one of these parameters.
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-clips
Version
0.1.6
App
Twitch
Authentication
OAuth
Read-only
Yes
Destructive
No
Open world
Yes