Twitch Scraper: Channels, Live Streams, Clips, VODs, and Chat Replay

Twitch Scraper turns Twitch into structured data. Get channel profiles, currently-live streams by game, top games, clips with direct MP4 download links, VOD lists, VOD chapter markers, and VOD chat-replay messages, plus a unified keyword search across channels and games. Paste channel logins, a game category slug, video IDs, or any twitch.tv link, then export the result to JSON, CSV, or Excel, or read it through the API.

Why This Scraper?

• Ten modes in one actor. Channel profile (with clips and VODs attached), live streams by game, a game-streams alias, top games, unified search, clips, VOD lists, VOD metadata with chapters, VOD chat replay, and a URL mode that auto-detects what you paste.
• Playable media links as a default field. Each live stream and VOD metadata record carries a ready-to-play HLS playlist URL, and each clip carries direct MP4 download links in 1080p, 720p, 480p, and 360p.
• Chat history without pulling the archive yourself. VOD chat-replay records come back with the commenter, the message text, the timestamp offset, and any badges or emotes already parsed out.
• VOD chapter markers. Game-change segments with position and duration, useful for building highlight timestamps.
• Two ways to avoid re-collecting data. Resume one interrupted run by pasting its run or dataset ID, or turn on incremental mode for scheduled runs that return only new, updated, or expired records.
• Built for automation. Pipe results into Notion, Linear, Airtable, or your other Apify integrations straight from the run.

Use Cases

• Stream discovery tools: surface currently live channels in a game, sorted by viewers, for a directory or alert bot.
• Channel and esports tracking: monitor a roster of channels' VOD history, clip performance, and follower counts over time.
• Highlight and clip curation: pull top clips per channel with direct MP4 URLs for re-use or archiving.
• Chat research: collect VOD chat-replay messages for sentiment, moderation, or community studies.
• Category and trend monitoring: track which games are trending right now with top games and per-category stream counts.

Data You Get

Sample shape: values are illustrative placeholders, not from a live record.

Field	Example
recordType	"live_stream" (also channel, game, clip, video, vod_metadata, vod_comment, search_channel, search_game)
id	"123456789"
login	"examplelogin"
displayName	"Example Display"
url	"https://www.twitch.tv/examplelogin"
title	"Sample stream title" (live stream, clip, video, VOD metadata)
viewersCount	12345 (live channels and streams)
viewCount	54321 (clip, video, VOD metadata)
followersCount	100000
gameName / gameSlug / gameId	"Sample Game" / "sample-game" / "000000"
boxArtUrl	"https://static-cdn.jtvnw.net/ttv-boxart/000000-285x380.jpg"
thumbnailUrl	preview or profile image URL
isPartner / isAffiliate	false / true
durationSeconds	185 (clip, video, VOD metadata)
tags	["English", "FPS"]
streamHlsUrl	playable HLS playlist URL (live stream, live channel)
vodHlsUrl	playable HLS playlist URL (VOD metadata)
clipMp4Urls	{ "1080": "https://.../1080.mp4", "720": "https://.../720.mp4" } (clip)
chapters	[{ "type": "GAME_CHANGE", "positionMs": 0, "gameName": "Game A" }] (VOD metadata)
messageText / commenterLogin	chat message text and commenter login (VOD chat replay)
changeType / changedFields	"UPDATED" / ["viewersCount", "title"] (incremental mode only)
scrapedAt	"2026-05-09T00:00:00.000Z"

Channel records also carry the description, banner image, primary color, live status flags, last broadcast title, and linked social accounts. Clip records also carry the slug, embed URL, and curator login. VOD metadata records also carry the description, publish date, and mute info. VOD chat records also carry the commenter ID, user color, badges, emotes, and the video ID and URL they belong to.

How to Use

1. Pick a mode: channel, live_streams (or its alias game_streams), top_games, search, clips, videos, vod_metadata, vod_comments, or url.
2. Fill in only the fields for that mode's section. Other sections are ignored.
3. Set Max results (and Max pages for paginated modes) to control run size and cost, then click Start.
4. Download the dataset as JSON, CSV, or Excel, or read it through the API.

Channel profile, plus its clips and recent VODs:

{
  "mode": "channel",
  "channels": ["shroud", "ninja", "pokimane"],
  "includeMediaUrls": true,
  "maxResults": 30
}

Live streams in a game, with playable HLS URLs:

{
  "mode": "live_streams",
  "gameSlug": "valorant",
  "streamSort": "VIEWER_COUNT",
  "includeMediaUrls": true,
  "maxResults": 50,
  "maxPages": 2
}

Top clips for a channel, with MP4 download URLs:

{
  "mode": "clips",
  "channels": ["xqc"],
  "clipPeriod": "LAST_WEEK",
  "includeMediaUrls": true,
  "maxResults": 25
}

VOD chat replay for one video:

{
  "mode": "vod_comments",
  "videoIds": ["2767213751"],
  "maxResults": 200
}

Run it from your code

Python:

from apify_client import ApifyClient

client = ApifyClient("<YOUR_APIFY_TOKEN>")
run = client.actor("abotapi/twitch-scraper").call(run_input={"mode": "live_streams", "gameSlug": "valorant"})
for stream in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(stream["displayName"], stream["viewersCount"])

JavaScript:

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: '<YOUR_APIFY_TOKEN>' });
const run = await client.actor('abotapi/twitch-scraper').call({ mode: 'live_streams', gameSlug: 'valorant' });
const { items } = await client.dataset(run.defaultDatasetId).listItems();

Or connect it to Make, Zapier, n8n, Google Sheets, or webhooks from the Integrations tab.

Media URLs and pagination caps

includeMediaUrls attaches a playable HLS URL to live stream, live channel, and VOD metadata records (clip MP4 URLs are always included). maxResults stops a run after that many records, 0 for unlimited. maxPages caps how many pages (about 30 items each) a paginated mode walks, 0 to walk until the source is exhausted or maxResults is hit. In channel, clips, and videos modes with multiple logins, the cap is shared roughly evenly across the requested channels.

Resume and recurring updates

• Resume (resumeFromRunId) continues one interrupted run: paste its run or dataset ID and this run skips every record already collected there, so you don't pay twice.
• Incremental mode (incrementalMode) is for scheduled runs over the same mode and filters. Each record is classified NEW, UPDATED (with changedFields), UNCHANGED (suppressed and not billed unless emitUnchanged is on), REAPPEARED, or EXPIRED (only after a run that scanned the whole tracked scope, and only with emitExpired). stateKey names or shares the stored state. With incremental mode off, output is exactly as before.

Send results into your apps (MCP connectors)

Optionally pipe the scraped results into the apps you already use, via Model Context Protocol (MCP) connectors. This is an extra delivery step after the scrape: the Apify dataset is never changed.

What gets written to the connector: a condensed, human-readable summary of each record, not the full JSON. Each item becomes one entry with a title and its key fields flattened to plain text. The complete record always stays in the Apify dataset.

1. Authorize a connector once under Apify → Settings → Integrations (Notion, Linear, Airtable, or Apify).
2. Select it in the "Pipe results into your apps" input field. (If the picker is empty, you haven't authorized a connector yet.)
3. For Notion, also set notionParentPageUrl to the page where items should be created.

The connection is mediated by Apify's MCP proxy, so this actor never sees your third-party credentials. Leave the field empty to skip.

Input Parameters

Parameter	Type	Default	Description
mode	string	channel	Which scrape to run: channel, live_streams, game_streams (alias of live_streams), top_games, search, clips, videos, vod_metadata, vod_comments, or url. Only the fields for the chosen mode are read.
channels	array	(none, sample ["shroud"])	Twitch logins, one per line. Used by channel, clips, and videos modes.
clipPeriod	string	LAST_WEEK	Time window for clip collection: LAST_DAY, LAST_WEEK, LAST_MONTH, ALL_TIME. Used by clips mode.
gameSlug	string	(none, sample valorant)	Category URL slug. Used by live_streams and game_streams modes.
streamSort	string	VIEWER_COUNT	Sort order for the live stream list: VIEWER_COUNT, RECENT, RELEVANCE.
searchQuery	string	(none, sample valorant)	Free-text keyword. Used by search mode.
videoIds	array	(none, sample ["2767213751"])	Numeric video IDs. Used by vod_metadata and vod_comments modes.
urls	array	(none, sample twitch.tv links)	Any twitch.tv URLs, one per line. Used by url mode; each is auto-detected as a channel, category, video, or clip link.
resumeFromRunId	string	(none)	Continue one specific interrupted run: paste its run or dataset ID and this run skips every record already collected there.
incrementalMode	boolean	false	Turn on for scheduled or recurring runs against the same mode and filters. Classifies each record against remembered state.
stateKey	string	(none)	Name or share an incremental-mode state. Left empty, a key is derived from the mode and its filters.
emitUnchanged	boolean	false	Incremental mode only: also return (and bill) records that have not changed since the last run.
emitExpired	boolean	false	Incremental mode only: also return (and bill) records no longer found, after a run that fully scanned the tracked scope.
includeMediaUrls	boolean	true	Attach a playable HLS URL to live stream, live channel, and VOD metadata records. Clip MP4 URLs are always included.
maxResults	integer	30	Stop after this many records. 0 means unlimited, still capped by maxPages.
maxPages	integer	0	Pages to walk for paginated modes, about 30 items per page. 0 means walk until the source is exhausted or maxResults is hit.
proxyConfiguration	object	Apify Proxy	Connection settings. Residential is recommended for long pagination walks.
mcpConnectors	array	(none)	Optional: send a summary of each record to apps you authorized under Integrations.
notionParentPageUrl	string	(none)	Notion connector only: page under which records are created.
maxNotifyListings	integer	50	Cap on items written to each connector per run.

Output Example

Sample shape: values are illustrative placeholders, not from a live record.

{
  "recordType": "live_stream",
  "id": "123456789",
  "login": "examplelogin",
  "displayName": "Example Display",
  "url": "https://www.twitch.tv/examplelogin",
  "title": "Sample stream title",
  "viewersCount": 12345,
  "createdAt": "2026-01-01T00:00:00Z",
  "streamType": "live",
  "gameName": "Sample Game",
  "gameSlug": "sample-game",
  "gameId": "000000",
  "boxArtUrl": "https://static-cdn.jtvnw.net/ttv-boxart/000000-285x380.jpg",
  "thumbnailUrl": "https://static-cdn.jtvnw.net/previews-ttv/live_user_examplelogin-0000x0000.jpg",
  "broadcasterId": "00000000",
  "broadcasterDescription": "Sample broadcaster bio.",
  "profileImageUrl": "https://static-cdn.jtvnw.net/jtv_user_pictures/0000-profile_image-70x70.png",
  "isPartner": true,
  "isAffiliate": false,
  "followersCount": 100000,
  "tags": ["English", "FPS"],
  "streamHlsUrl": "https://usher.ttvnw.net/api/channel/hls/examplelogin.m3u8?sig=0000&token=%7B...%7D",
  "scrapedAt": "2026-05-09T00:00:00.000Z"
}

Plan Requirement

The default proxy setting works out of the box. For long pagination walks, or many clip and VOD enrichments in one run, the residential proxy group gives more headroom, pick it under Connection.

FAQ

How much does it cost?

You pay per record returned, with the optional media-URL enrichment billed only when it applies. The Pricing tab shows the current rates. Use Max results to cap the cost of any run.

Is it legal to scrape Twitch?

This actor collects only publicly available channel, stream, clip, video, and chat data. You are responsible for how you use it: follow Twitch's terms and the laws that apply to you, and get legal advice if you plan commercial redistribution. Usernames, chat messages, and other user-generated content may carry privacy or copyright considerations, so handle them accordingly.

Can I get only new or changed records on a schedule?

Yes. Schedule the actor from the Schedules tab and turn on Incremental mode. Each run then returns only new, updated, reappeared, or (if enabled) expired records, and unchanged ones are not billed.

What's the difference between Resume and Incremental mode?

Resume (resumeFromRunId) continues one specific interrupted run: it skips whatever that run already delivered. Incremental mode (incrementalMode) is for running the same mode and filters again and again on a schedule and getting only what changed since last time. They solve different problems and can be combined for a first run.

Why did my run fail instead of returning an empty dataset?

If the site refuses a request and a refreshed session does not help, the run fails with a clear message rather than silently returning nothing, so an empty result is never confused with an unreadable one. A missing required field for the chosen mode (for example no channels in channel mode) also fails the run. A channel with no matching content, a search with no hits, or an incremental run with nothing changed all succeed normally and simply return fewer (or zero) records, with the reason noted on the run's status.

Can I use it with AI agents or MCP?

Yes. Call it from any Apify integration or MCP client, and use the connector field to push results into Notion, Linear, or Airtable.

🔗 Want more video data?

Pair this actor with these related scrapers from the same team:

📱 Tiktok Live Recorder Record TikTok live streams to MP4 with full metadata, all stream quality URLs, and...	📱 Universal Media Extractor Extract videos, audio, and metadata from 1000+ websites including YouTube, TikTok...
📱 ViewStats Scraper Scrape YouTube channel analytics from ViewStats. Look up channels by handle, URL, or...	📱 Lemon8 Media Scraper Lightweight Lemon8 scraper for extracting image and video URLs from posts, with optional...
📱 TikTok Profile, Hashtag, Search, Video & Trending Scraper Scrape TikTok without login. Extract profiles, bios, follower stats and videos; search by...	📱 Lemon8 Search Scraper Scrape Lemon8 posts by keyword across multiple regions. Extract posts, images, videos...

👉 Browse all abotapi scrapers

💬 Support & custom scrapers

• 🐞 Found a bug or a missing field? Open a ticket on the Issues tab. We usually reply within hours.
• 🛠️ Need another site, extra fields or a private build? Email contact@abotapi.com or message Telegram @abotapi.
• ⭐ Enjoying it? A quick review on the actor page helps other users find it.