Introduction

This actor extracts Channels in a Search from Twitch. It collects channel metadata, current stream status, and historical broadcast information from search result pages. You can use this data to analyze streamer reach and content trends.

Data Fields

Field Name	Description	Example
User Login	The unique username of the channel	"ninja"
Display Name	The formatted name shown on Twitch	"Ninja"
Profile Image URL	URL to the channel profile picture	"https://static-cdn.jtvnw.net/user-default-pictures-uv/cdd517cc-def4-11e9-b944-784f43822e1e-profile_image-300x300.png"
Description	The channel bio or about text	"Professional gamer and streamer."
Broadcast Title	Title of the current or last stream	"Playing Fortnite with friends"
Followers Count	Total number of followers	18500000
Last Broadcast ID	ID of the most recent stream	"41234567890"
Last Broadcast Started At	ISO timestamp of the last stream start	"2023-10-27T18:00:00Z"
Game ID	Unique identifier for the game	"33214"
Game Slug	URL-friendly name of the game	"fortnite"
Game Name	Display name of the game	"Fortnite"
Stream ID	ID of the active stream	"49876543210"
Stream Type	Status of the stream (e.g. live)	"live"
Stream Viewers Count	Current number of live viewers	15400
Stream Preview Image URL	URL to the current stream thumbnail	"https://static-cdn.jtvnw.net/previews-ttv/live_user_ninja-440x248.jpg"
Stream Freeform Tags	Array of tags applied to the stream	["English", "Competitive"]
Is Partner	Boolean indicating partner status	true
Latest Video ID	ID of the most recent VOD	"19543210"
Latest Video Title	Title of the most recent VOD	"Epic Wins Only"
Latest Video Length	Duration of the latest video	"04:15:20"
Top Clip ID	ID of the most popular clip	"FamousClipSlug"
Top Clip Title	Title of the top clip	"Insane Headshot"
Top Clip Duration	Length of the top clip in seconds	30
Channel Schedule Next Segment	Next scheduled stream time	"2023-10-28T15:00:00Z"
Stream URL	Direct link to the live stream	"https://www.twitch.tv/ninja"
Channel About URL	Link to the channel about page	"https://www.twitch.tv/ninja/about"
Game URL	Link to the game category page	"https://www.twitch.tv/directory/game/Fortnite"

Input

• urls: Array of Twitch search URL strings.
• maxItems: Maximum number of channels to extract per URL. Default is 100.

Example Input

{
  "urls": ["https://www.twitch.tv/search?term=gaming"],
  "maxItems": 50
}

Example Output

[
  {
    "userLogin": "streamer_one",
    "displayName": "StreamerOne",
    "profileImageUrl": "https://static-cdn.jtvnw.net/example1.jpg",
    "description": "Variety streamer from the UK.",
    "broadcastTitle": "Morning Coffee and Games",
    "followersCount": 50000,
    "lastBroadcastId": "401234567",
    "lastBroadcastStartedAt": "2023-10-27T09:00:00Z",
    "gameId": "509658",
    "gameSlug": "just-chatting",
    "gameName": "Just Chatting",
    "streamId": "401234567",
    "streamType": "live",
    "streamViewersCount": 1200,
    "streamPreviewImageUrl": "https://static-cdn.jtvnw.net/previews/1.jpg",
    "streamFreeformTags": ["English", "Chill"],
    "isPartner": true,
    "latestVideoId": "1823456",
    "latestVideoTitle": "Yesterday's Stream",
    "latestVideoLength": "03:00:00",
    "topClipId": "ClipOne",
    "topClipTitle": "Funny Moment",
    "topClipDuration": 60,
    "channelScheduleNextSegment": "2023-10-28T09:00:00Z",
    "streamUrl": "https://www.twitch.tv/streamer_one",
    "channelAboutUrl": "https://www.twitch.tv/streamer_one/about",
    "gameUrl": "https://www.twitch.tv/directory/game/Just%20Chatting"
  },
  {
    "userLogin": "pro_player",
    "displayName": "ProPlayer",
    "profileImageUrl": "https://static-cdn.jtvnw.net/example2.jpg",
    "description": "Professional esports athlete.",
    "broadcastTitle": "Ranked Grind",
    "followersCount": 250000,
    "lastBroadcastId": "401234568",
    "lastBroadcastStartedAt": "2023-10-27T20:00:00Z",
    "gameId": "32399",
    "gameSlug": "counter-strike",
    "gameName": "Counter-Strike",
    "streamId": null,
    "streamType": null,
    "streamViewersCount": 0,
    "streamPreviewImageUrl": null,
    "streamFreeformTags": [],
    "isPartner": true,
    "latestVideoId": "1823457",
    "latestVideoTitle": "Tournament Finals",
    "latestVideoLength": "05:30:00",
    "topClipId": "ClipTwo",
    "topClipTitle": "Ace",
    "topClipDuration": 45,
    "channelScheduleNextSegment": "2023-10-29T18:00:00Z",
    "streamUrl": "https://www.twitch.tv/pro_player",
    "channelAboutUrl": "https://www.twitch.tv/pro_player/about",
    "gameUrl": "https://www.twitch.tv/directory/game/Counter-Strike"
  }
]

Want more from Twitch?

This actor only covers Channels in a Search. The full Twitch Scraper browser extension also includes Messages in a Chat, Channels in a List, Videos in a List, Clips in a List, Channel Details with unlimited personal use, real-time scraping with your logged-in sessions, CSV/Excel/JSON export, field customization, and scheduled monitoring.

Get the Twitch Scraper extension

Disclaimer

This tool extracts publicly available data. Users are responsible for compliance with applicable terms of service.