View as Markdown
Twitch icon

Twitch ACTION

Search Channels

Returns 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 channels.
  • Action
  • Read only
  • OAuth
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Twitch account once, then configure and run Search Channels 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-search-channels",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    twitch: { authProvisionId: "apn_xxxxxxx" },
    max: 10,
    query: "Query",
  },
})

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.

Search Channels inputs
Property Type Description
max Max Items integer
Maximum number of channels to return
Required
query Query string
The search query
Required
liveOnly Live Only boolean
Filter results for live streams only
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-search-channels
Version
0.1.6
App
Twitch
Authentication
OAuth
Read-only
Yes
Destructive
No
Open world
Yes