Twitch Live Stream, Channel & VOD Metadata Extractor

Collect Twitch metadata without a login, OAuth app, or API key: live streams, channel profiles with social links and published schedules, category directories, category VODs, individual VODs and clips, search results, and resolved twitch.tv links. Every record is public data returned in clean JSON, with empty fields omitted.

What this actor does

• Returns the live directory globally or inside one category, with viewer counts, language, start time, tags, broadcaster followers, partner status, and stream quality details
• Builds channel profiles with bio, images, follower count, roles, social links, About panels, primary team, upcoming schedule, total VOD count, and emails published in the bio
• Pages channel VODs and clips deeply, with VOD type/sort and clip period/sort controls
• Searches Twitch channels, categories, and videos with independent deep pagination for each index
• Adds category VODs, batch channel/VOD/clip lookup, multi-URL resolution, and category stats on stream records
• Omits empty values at every depth instead of returning null, empty strings, or empty objects

Modes

Mode	What you get
topStreams	Current live streams across Twitch, with language, tag, viewer, and sort filters
topGames	Categories sorted by current viewers, with follower and broadcaster counts
search	Channels, categories, and videos from Twitch search, with per-index pagination
byChannel	One or more channel profiles, plus optional recent VODs and clips
byCategory	Live streams in a category, with category viewer/follower/broadcaster stats attached
byCategoryVideos	VODs for a category, filtered by type, language, and sort order
topClips	Top clips for a category over a chosen time window, sorted by views or trending
byVideo	One or many VODs by numeric ID or VOD URL
byClip	One or many clips by slug or clip URL
byUrl	Resolves channel, VOD, clip, and category URLs, including /videos and /clips tabs

Output per record

Every record carries a recordType of stream, channel, video, clip, or game, plus scrapedAt. Invalid URLs produce a typed error row, which does not count toward maxItems.

Live stream (recordType: "stream")

Field	Description
streamId	Twitch stream ID
title	Stream title
viewersCount	Current concurrent viewers
streamType	Broadcast type
language	Broadcast language code
startedAt	Stream start timestamp
previewImageURL	Live preview thumbnail
channelId / channelName / displayName	Broadcaster identifiers
followersCount	Broadcaster follower count
isPartner / isAffiliate	Broadcaster role flags, when true
gameId / gameName / gameSlug	Category identifiers
tags	Freeform stream tags
isMature	Mature-content flag
averageFPS / height / width	Stream quality details
contentClassificationLabels	Twitch content labels, when present
broadcaster	Broadcaster object with images, color, followers, roles, social links
game	Category object with artwork and category stats when available
url	Channel URL

Channel (recordType: "channel")

Field	Description
channelId / channelName / displayName	Channel identifiers
description	Public channel bio
language	Channel broadcast language
createdAt	Account creation date
profileImageURL / bannerImageURL / offlineImageURL	Channel images
primaryColorHex	Brand color
isPartner / isAffiliate / isStaff	Role flags, when true
followersCount	Total followers
streamTitle / currentGame	Configured stream title and category
isLive	Whether the channel is live
liveStream	Nested live-stream details when live
lastBroadcast	Most recent broadcast details
socialLinks[]	Social links shown on the channel page
panels[]	About-page panels with title, text, image, and link
primaryTeam	Primary Twitch team, when set
upcomingSchedule[]	Published upcoming schedule segments
videosCount	Total current VODs on the channel
contactEmails[]	Emails published in the public bio
url	Channel URL

VOD (recordType: "video")

Field	Description
videoId	VOD ID
title / description	Title and description when published
lengthSeconds	Duration in seconds
viewCount	Total views
createdAt / publishedAt / updatedAt / recordedAt	Relevant timestamps
previewImageURL / animatedPreviewURL	Thumbnails
broadcastType / status	VOD type and recording status
language	Video language
contentTags[]	Twitch content tags
gameId / gameName / gameSlug / game	Associated category
channelId / channelName / displayName / owner	Owning channel
url	VOD URL

Clip (recordType: "clip")

Field	Description
clipId / slug	Clip identifiers
title	Clip title
viewCount	Total views
durationSeconds	Clip length
createdAt	Creation timestamp
language	Clip language
isFeatured	Featured flag, when true
thumbnailURL / embedURL	Thumbnail and embed URL
videoOffsetSeconds	Offset into the source broadcast, when known
gameId / gameName / gameSlug / game	Associated category
channelId / channelName / displayName / broadcaster	Broadcaster details
curator	Who created the clip
sourceVideo	Source VOD ID and title, when linked
url	Clip URL

Category (recordType: "game")

Field	Description
gameId	Category ID
name / displayName / slug	Category names and URL slug
viewersCount / followersCount / broadcastersCount	Current category stats
boxArtURL / logoURL / coverURL	Category artwork
description	Category description
tags[]	Category content tags
originalReleaseDate	Release date when published
developers[] / publishers[]	Companies when published
url	Category directory URL

Input

Field	Type	Default	Description
mode	string	topStreams	One of the ten modes above
searchQuery	string	lirik	Search term for search
searchType	string	all	all, channel, game, or video
channelName	string	–	One channel login or URL for byChannel
channelNames	array	[]	Batch channel logins or URLs
categorySlug	string	–	Category slug, name, or directory URL
videoId	string	–	One VOD ID or URL
videoIds	array	[]	Batch VOD IDs or URLs
clipSlug	string	–	One clip slug or URL
clipSlugs	array	[]	Batch clip slugs or URLs
twitchUrls	array	[]	URLs for byUrl
language	string	EN	Broadcast language, or (any)
streamSort	string	VIEWER_COUNT	Most viewers, fewest viewers, recently started, or recommended
streamTags	array	[]	Require all listed freeform tags
streamType	string	–	VOD type filter
videoSort	string	TIME	Newest or most viewed
clipPeriod	string	LAST_WEEK	Last day, week, month, or all time
clipSort	string	VIEWS_DESC	Most viewed or trending
includeChannelClips	boolean	true	Include clips in byChannel
includeChannelVideos	boolean	true	Include VODs in byChannel
minViewersCount	integer	–	Drop streams below this viewer count
minViewCount	integer	–	Drop VODs and clips below this view count
minFollowersCount	integer	–	Drop channels and streams below this follower count
maxFollowersCount	integer	–	Drop channels and streams above this follower count
onlyLive	boolean	false	Drop offline channel profiles
containsKeyword	string	–	Title keyword filter
maxItems	integer	50	Hard record cap (1–5000)

Example: top live streams in English

{
  "mode": "topStreams",
  "language": "EN",
  "streamSort": "VIEWER_COUNT",
  "maxItems": 50
}

Example: channel profiles with schedules and media

{
  "mode": "byChannel",
  "channelNames": ["lirik", "xqc", "pokimane"],
  "includeChannelVideos": true,
  "includeChannelClips": true,
  "maxItems": 60
}

Example: category VODs

{
  "mode": "byCategoryVideos",
  "categorySlug": "minecraft",
  "streamType": "ARCHIVE",
  "videoSort": "VIEWS",
  "maxItems": 100
}

Example: mixed URL resolution

{
  "mode": "byUrl",
  "twitchUrls": [
    "https://www.twitch.tv/shroud",
    "https://www.twitch.tv/videos/2766365638",
    "https://www.twitch.tv/directory/category/just-chatting/videos"
  ],
  "maxItems": 40
}

Use cases

• Creator discovery — find channels by category, language, tags, follower range, or viewer count
• Sponsorship research — compare live audiences and follower totals across streamers
• Clip curation — pull top or trending clips for a category or channel over a chosen window
• VOD archives — collect titles, durations, views, and categories for past broadcasts
• Market monitoring — track category viewers, broadcaster counts, and changing top streams
• Link enrichment — turn lists of Twitch links into structured channel, VOD, clip, or category rows

FAQ

Do I need a Twitch account, OAuth token, or API key? No. All modes work without a login or developer credentials.

Why does a run stop before maxItems? Twitch sometimes has fewer matching rows than requested. Clip lists stop at about 1,000 rows, search categories at about 30 matches, search channels at about 1,000 per term, and search videos at Twitch's 10,000-match ceiling. In byUrl, the cap is shared across the supplied URLs, so a small maxItems can stop before every URL is expanded. The actor reports when the source ends or a cap is reached instead of padding the dataset.

Why are some channel fields missing? Social links, schedules, panels, teams, and bio emails are optional on Twitch. They are included when the channel publishes them and omitted otherwise.

How many live streams can one run return? The live directory pages in groups of up to 30. Requesting thousands of rows means many pages and a longer run; the prefill stays small to keep daily tests cheap.

Can this pull chat messages or video files? No. This actor covers stream, channel, VOD, clip, and category metadata only. Chat replays and media downloads are separate tasks.

What is the difference between byCategory and byCategoryVideos? byCategory returns channels that are live in the category now. byCategoryVideos returns published VODs for that category.

How do I find a category slug? Open the category on Twitch and copy the last part of its URL, or use topGames and read slug.

Are duplicate records removed? Yes. Streams, channels, VODs, clips, and categories are deduplicated by their Twitch IDs across pages and batches.

Is this affiliated with Twitch? No. This actor reads public Twitch data and is not affiliated with, endorsed by, or sponsored by Twitch.