# Twitch Scraper - Channels, Live Streams, VODs, Clips & Chat (`topapi/twitch-scraper`) Actor

Scrape Twitch channels, live streams, VODs, clips, top categories and VOD chat: followers, viewers, partner status, emails, socials, schedule, chapters, clip MP4 links. Search, category and language filters, monitor mode. From $0.90 per 1,000 channels, no start fee.

- **URL**: https://apify.com/topapi/twitch-scraper.md
- **Developed by:** [Top Api](https://apify.com/topapi) (community)
- **Categories:** Social media, Videos, Lead generation
- **Features:** Limited permissions
- **Stats:** 3 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.90 / 1,000 channel rows

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

### What does Twitch Scraper do?

**Twitch Scraper** extracts public data from [Twitch](https://www.twitch.tv) and turns channel names, twitch.tv links, search terms or game categories into structured rows: channels with followers, live status and contact links, live streams with viewers, VODs, clips, top categories and VOD chat replays. Built for influencer marketers, esports and games analysts, and sponsorship teams who need Twitch streamer data without the Twitch API's app registration and OAuth tokens.

Twitch Scraper - Twitch API alternative - Twitch streamer stats - Twitch live viewers scraper - Twitch VOD and clip scraper

- **Six kinds of rows in one actor:** channels, live streams, videos (VODs), clips, categories and chat messages. The `type` field says which.
- **Streamer contacts in every channel row:** emails written in the bio or About panels, YouTube, X, Instagram, TikTok, Discord and Facebook links, team, panels.
- **Past Twitch's 30-stream pages:** live streams are collected across Twitch's sort orders and 35 languages, de-duplicated. 1,000 live streams in 3.9 seconds in our test run.
- **VOD chapters, clip MP4 links, chat replay:** each category played in a VOD and when, a download link for every clip, and every chat message of a past broadcast with its time in the VOD.
- **No login, cookies or Twitch API key:** the actor reads the same public data twitch.tv shows a signed-out visitor.
- **Monitor mode:** run it on a schedule and get only new streams, VODs, clips and chat, plus channels that went live, went offline or changed followers.
- **Pay per row, no start fee:** from $0.45 per 1,000 streams, videos or clips and $0.90 per 1,000 channels.
- **Export anywhere:** JSON, CSV, Excel, XML; schedules, webhooks, Make, Zapier, n8n, Google Sheets, Slack, the Apify API and MCP for AI agents.

### What data can you get from Twitch?

<table>
<tr>
<td>👤 Login, display name, bio</td>
<td>👥 Followers (`followersCount`)</td>
<td>🟣 Partner / affiliate (`broadcasterType`)</td>
</tr>
<tr>
<td>🔴 Live now, viewers, stream title</td>
<td>🎮 Current and last category</td>
<td>📅 Last broadcast date</td>
</tr>
<tr>
<td>📧 Emails from bio and panels</td>
<td>🔗 YouTube, X, Instagram, TikTok, Discord</td>
<td>🧩 About panels, team</td>
</tr>
<tr>
<td>🗓️ Stream schedule</td>
<td>😀 Subscriber emotes</td>
<td>🖼️ Avatar, banner, offline image</td>
</tr>
<tr>
<td>📺 Live streams: viewers, uptime, tags, language</td>
<td>🎬 VODs: views, duration, chapters</td>
<td>✂️ Clips: views, creator, VOD moment, MP4</td>
</tr>
<tr>
<td>🏆 Categories: viewers, live channels, followers</td>
<td>💬 Chat replay: sender, text, emotes, badges</td>
<td>🕒 Time in the VOD (`vodTimestamp`)</td>
</tr>
</table>

### How to scrape Twitch with Twitch Scraper

1. [Create a free Apify account](https://console.apify.com/sign-up) (it comes with monthly free credit).
2. Open [Twitch Scraper](https://apify.com/TopApi/twitch-scraper) and click **Try for free**.
3. Type channel names, paste twitch.tv links, add search terms or categories (for example `Just Chatting`).
4. Pick what to read from each category and switch on the extras you want (videos, clips, chat).
5. Click **Start** and wait a few seconds.
6. Download the rows as JSON, CSV or Excel, or connect them to your tools.

### ⬇️ Input

All inputs are optional; combine any of them in one run. With an empty input the actor runs a small sample (channel `shroud` + the top 10 live streams).

| Section | Parameter | Type | Description |
|---|---|---|---|
| 🔍 What to scrape | `channels` | array | Channel logins or links, e.g. `shroud`, `https://www.twitch.tv/pokimane` |
| | `startUrls` | array | Any twitch.tv link: channel, `/videos`, `/clips`, VOD, clip, category, `/directory`, `/directory/all`, `/search?term=` |
| | `searchQueries` + `searchType` | array + select | Search terms; search for channels (default), categories or videos |
| | `categories` + `categoryOutput` | array + select | Category names or slugs; read their live streams (default), the channels streaming them, top clips, videos, or the category row |
| | `topStreams`, `topCategories` | boolean | Most-watched live streams / categories on Twitch now |
| | `chatVideoUrls` | array | VODs whose chat replay to export |
| 🎯 Filters | `languages`, `tags` | array | Stream languages (35) and stream tags such as `DropsEnabled` |
| | `streamSort` | select | Most viewers (default), fewest viewers, recently started, recommended |
| | `clipPeriod`, `clipSort` | select | Last 24 hours / 7 days (default) / 30 days / all time; most viewed or trending |
| | `videoType`, `videoSort` | select | Past broadcasts, highlights, uploads, premieres; newest or most viewed |
| ✂️ Refine results | `minFollowers`, `maxFollowers` | integer | Follower range for channels and streamers |
| | `minViewers`, `maxViewers`, `minViews` | integer | Viewer range for live streams; minimum views for videos and clips |
| | `onlyLive`, `onlyWithEmail`, `broadcasterType` | boolean / select | Live channels only, channels with an email only, partners / affiliates |
| | `dateFrom`, `dateTo`, `maxAgeDays` | date / integer | Date window for videos, clips and stream start |
| ➕ Extra data | `includeVideos` + `videosPerChannel` | boolean + integer | Each channel's videos as rows (default 20 per channel) |
| | `includeClips` + `clipsPerChannel` | boolean + integer | Each channel's top clips as rows (default 20) |
| | `includeClipDownloadUrls` | boolean | MP4 link on every clip row |
| | `includeSchedule`, `includeEmotes`, `includeChapters` | boolean | Schedule and emotes on channel rows; chapters on video rows (default on) |
| | `includeVodChat`, `maxChatMessagesPerVideo`, `chatStartSeconds`, `chatEndSeconds` | boolean / integer | Chat replay of saved VODs; messages per VOD (default 1,000, 0 = all) and window |
| 🔁 Monitoring | `monitorMode`, `monitorOutput`, `monitorStoreName` | boolean / select / string | Save only what is new or changed since the last run |
| 📦 Output | `maxItems` | integer | Most rows per run (default 1,000; chat is capped per VOD) |
| | `maxResultsPerSource` | integer | Rows per category, search term, top list or link (default 30) |
| | `compact` | boolean | Core fields only |
| ⚙️ Advanced | `proxyConfiguration`, `maxConcurrency` | object / integer | Optional proxy; parallel requests (default 4) |

#### Input JSON

```json
{
    "channels": ["shroud", "pokimane"],
    "categories": ["Just Chatting"],
    "categoryOutput": ["streams"],
    "languages": ["EN"],
    "maxResultsPerSource": 20,
    "maxItems": 100
}
```

#### Build a streamer lead list from a game

Put the game in `categories`, choose **Channels streaming it** in `categoryOutput`, and set a follower range. Every streamer live in that category comes back as a full channel row with emails and social links:

```json
{ "categories": ["Fortnite"], "categoryOutput": ["channels"], "minFollowers": 1000, "maxResultsPerSource": 100, "onlyWithEmail": false }
```

In our test run this returned 97 Fortnite streamers with 1,000+ followers in 7.2 seconds; 22% had an email in their bio or panels and 89% had social links.

#### Get more than 30 live streams

Twitch shows about 25 live streams per directory view. Leave `languages` empty and raise `maxResultsPerSource`: the actor reads the other sort orders and every language and removes duplicates. Setting `languages` keeps you inside those languages, which caps a small category at what Twitch lists for them.

#### Paste the page you are looking at

Any twitch.tv link works in `startUrls`: `https://www.twitch.tv/lirik/videos?filter=highlights&sort=views`, `https://www.twitch.tv/directory/category/valorant/clips?range=7d`, `https://clips.twitch.tv/<slug>` or `https://www.twitch.tv/videos/2911460606`. Filters in the link are kept.

### ⬆️ Output

Each row has a `type`. The Output tab has views for channels, channel contacts, live streams, videos, clips, categories and chat.

**Channel** (from the Fortnite lead-list run):

```json
{
  "type": "channel",
  "login": "iitztimmy",
  "url": "https://www.twitch.tv/iitztimmy",
  "followersCount": 2947283,
  "broadcasterType": "partner",
  "isLive": true,
  "currentViewers": 2584,
  "currentGame": "Fortnite",
  "lastBroadcastDate": "2026-10-28T01:13:14.558Z",
  "broadcastLanguage": "en",
  "primaryEmail": "iitztimmy@loaded.gg",
  "youtubeUrl": "https://www.youtube.com/iiTzTimmy",
  "twitterUrl": "https://twitter.com/iiTzTimmy",
  "discordUrl": "https://discord.gg/iitztimmy",
  "team": "loadedllc",
  "createdAt": "2013-06-28T04:15:32.224Z",
  "category": "Fortnite"
}
```

**Live stream**:

```json
{
  "type": "stream",
  "url": "https://www.twitch.tv/theburntpeanut",
  "title": "NUKE CHALLENGE | 30 Kills - 1 Life | COD MW4",
  "viewersCount": 33659,
  "startedAt": "2026-10-27T23:21:30.000Z",
  "language": "en",
  "tags": ["English", "funny", "gaming", "DropsEnabled"],
  "game": "Call of Duty: Modern Warfare 4",
  "broadcasterLogin": "theburntpeanut",
  "broadcasterFollowers": 2608068,
  "broadcasterType": "partner",
  "rank": 1
}
```

**Video with chapters**:

```json
{
  "type": "video",
  "url": "https://www.twitch.tv/videos/2911386630",
  "title": "POGGING",
  "videoType": "ARCHIVE",
  "viewCount": 252861,
  "duration": "6h28m50s",
  "game": "Just Chatting",
  "chapters": [
    { "game": "Just Chatting", "positionSeconds": 0, "durationSeconds": 1846 },
    { "game": "Moon Sweepers", "positionSeconds": 1846, "durationSeconds": 3354 },
    { "game": "World of Warcraft", "positionSeconds": 5200, "durationSeconds": 9900 }
  ],
  "channelLogin": "lirik"
}
```

**Clip**:

```json
{
  "type": "clip",
  "url": "https://www.twitch.tv/lirik/clip/TsundereBelovedFloofDatSheffy-oZIB--tQd6EXRm_p",
  "title": "2 Peasants got their chance to interact with a Lord",
  "viewCount": 9713,
  "durationSeconds": 60,
  "game": "Kingdom Come: Deliverance II",
  "curatorLogin": "villenthessis",
  "vodUrl": "https://www.twitch.tv/videos/2906855210?t=2h30m08s",
  "downloadQuality": "1080p60"
}
```

**Chat message**:

```json
{
  "type": "chatMessage",
  "videoId": "2911460606",
  "channelLogin": "shroud",
  "vodTimestamp": "0:00:25",
  "postedAt": "2026-10-26T17:45:38.360Z",
  "commenterLogin": "chhaavveezz",
  "message": "chhaavDance",
  "emotes": [{ "id": "emotesv2_a3964a9f555b4632a24891cba95cf511", "text": "chhaavDance" }],
  "badges": [{ "setId": "pichu", "version": "1" }],
  "isSubscriber": false
}
```

#### Fields

Measured on our test runs on 2026-10-28 (157 channel rows, 1,000 live streams, 122 videos, 160 clips, 2,000 chat messages).

| Row | Field | Filled |
|---|---|---|
| channel | `followersCount`, `broadcasterType`, `isLive`, `lastBroadcastDate`, `broadcastLanguage`, `createdAt`, `profileImageUrl` | 100% |
| channel | `description` / `videosCount` / `bannerImageUrl` | 91% / 96% / 89% |
| channel | `socialLinks` / `panels` | 86% / 80% |
| channel | `youtubeUrl` / `instagramUrl` / `discordUrl` / `tiktokUrl` / `twitterUrl` | 56% / 52% / 50% / 45% / 44% |
| channel | `emails` (bio and panels) / `team` | 24% / 17% |
| stream | `viewersCount`, `startedAt`, `language`, `broadcasterFollowers`, `thumbnailUrl` | 100% |
| stream | `tags` / `title` / `game` | 99% / 98% / 91% |
| video | `title`, `viewCount`, `durationSeconds`, `game`, `thumbnailUrl`, `language` | 100% |
| video | `chapters` | 51% (VODs with more than one category) |
| clip | `title`, `viewCount`, `curatorLogin`, `vodUrl`, `downloadUrl`, `game` | 100% |
| chatMessage | `message`, `commenterLogin`, `postedAt`, `offsetSeconds` | 100% |
| chatMessage | `userColor` / `badges` / `emotes` | 88% / 78% / 5% |
| category | `viewersCount`, `broadcastersCount`, `followersCount`, `tags`, `boxArtUrl` | 100% |

Monitor runs add `changeType` (`new`, `wentLive`, `wentOffline`, `newBroadcast`, `newStream`, `followersChanged`, `unchanged`) and, on channels, `previousFollowersCount` and `followersChange`.

### Use cases

- 🤝 **Influencer and sponsorship teams:** streamer lists by game, language and follower range, with emails and socials for outreach.
- 📈 **Games and esports analysts:** live viewers and live channels per category, top categories over time, stream uptime.
- 🎯 **Brand and agency reporting:** a creator's follower growth, live status and recent VOD views on a schedule.
- ✂️ **Clip and highlight editors:** top clips per channel or game with MP4 links and the VOD moment they come from.
- 💬 **Community and research teams:** full chat replays of past broadcasts with timestamps, badges and emotes.
- 🗓️ **Event and media planners:** channel schedules and next stream times.

### How much does it cost to scrape Twitch?

Pay per row, no start fee. Rows removed by your filters, duplicates and unchanged rows in monitor mode are not charged.

| Row | Price per 1,000 |
|---|---|
| Channel | $0.90 |
| Live stream, video or clip | $0.45 |
| Category | $0.72 |
| VOD chat message | $0.018 |

| Example run | Rows | Cost |
|---|---|---|
| 100 channels | 100 | $0.09 |
| 1,000 live streams | 1,000 | $0.45 |
| 10 channels + 20 videos + 20 clips each | 410 | $0.189 |
| 100 top categories | 100 | $0.072 |
| 2,000 chat messages | 2,000 | $0.036 |

Set **Maximum cost per run** in the run options to cap any run; the actor stops cleanly at the limit.

### Integrations, API, scheduling & MCP

- **Schedules:** run Twitch Scraper hourly or daily with monitor mode on to collect only new streams, VODs, clips and channel changes.
- **Webhooks:** get a call when a run finishes and pull the dataset.
- **Make, Zapier, n8n, Google Sheets, Slack:** connect through Apify's integrations.
- **API:** start runs and read results from [Python](https://apify.com/TopApi/twitch-scraper/api/python) or [JavaScript](https://apify.com/TopApi/twitch-scraper/api/javascript) with the Apify client.
- **MCP:** AI agents can call the actor through the [Apify MCP server](https://apify.com/TopApi/twitch-scraper/api/mcp).

### More scrapers from TopApi

- 🎬 [YouTube Shorts Scraper](https://apify.com/TopApi/youtube-shorts-scraper): Shorts with views, likes and channel data
- 🎵 [TikTok Scraper](https://apify.com/TopApi/tiktok-scraper): videos, profiles, hashtags and engagement
- 📸 [Instagram Profile Scraper](https://apify.com/TopApi/instagram-profile-scraper): followers, bio, contacts and posts
- 🐦 [X Profile Scraper](https://apify.com/TopApi/x-profile-scraper): X (Twitter) profiles and follower counts
- 🎧 [Spotify Scraper](https://apify.com/TopApi/spotify-scraper): artists, tracks, albums and playlists

All TopApi actors: [apify.com/TopApi](https://apify.com/TopApi)

### Limits & empty runs

- Twitch shows about 25 live streams per directory view and up to 100 videos or clips per list; the actor goes further by reading other sort orders, languages, clip periods and video types, so very deep requests in a small category end at what Twitch lists.
- Twitch publishes follower counts, not follower lists, so no actor can list who follows a channel.
- Social links come from the channel's own socials setting; a channel without it set still gets links found in its panels.
- VOD chat replay is read second by second; in the rare second where chat passes ~59 messages, that second's first page is kept and the run summary counts it.
- Expired, deleted or subscriber-only VODs return no chat and are listed as not found. Clip MP4 links expire after about a day.
- A run that finds nothing ends with a message saying why (no match, filters, nothing new in monitor mode) and charges nothing.

### ❓ FAQ

#### How much does Twitch Scraper cost?

$0.90 per 1,000 channel rows, $0.45 per 1,000 live streams, videos or clips, $0.72 per 1,000 categories and $0.018 per 1,000 chat messages, with no start fee. A 100-channel run costs $0.09.

#### How many results can Twitch Scraper return?

As many as Twitch lists: our test run read 1,000 live streams in 3.9 seconds, 97 streamers of one game in 7.2 seconds and 2,000 chat messages in 10.3 seconds. Set `maxItems` for the run and `maxResultsPerSource` per category or search.

#### Can Twitch Scraper find streamer emails?

Yes, when the streamer wrote one in their bio or About panels: 22-24% of channels in our runs had one. Use `onlyWithEmail` to keep only those channels.

#### Can I monitor Twitch channels and streams on a schedule?

Yes. Turn on `monitorMode` and schedule the actor. Each run saves only new streams, VODs, clips and chat, and channels that went live, went offline or changed followers.

#### Can Twitch Scraper export VOD chat?

Yes. Put VOD links in `chatVideoUrls`, or switch on `includeVodChat` to export the chat of every past broadcast the run saves. `maxChatMessagesPerVideo: 0` exports the whole replay.

#### Can I download Twitch clips?

Switch on `includeClipDownloadUrls`; every clip row gets an MP4 link in the best quality Twitch offers (1080p60 in our runs). Download it within a day.

#### Can I use Twitch Scraper with the Apify API or Python?

Yes. Start a run and read the dataset with the Apify client for Python or JavaScript; see the API tab.

#### Can AI agents use Twitch Scraper through MCP?

Yes, through the Apify MCP server. The `compact` option trims rows to their core fields for agents.

#### Do I need a Twitch account, login or API key?

No. Twitch Scraper reads what twitch.tv shows any signed-out visitor; no Twitch developer app, OAuth token or cookie is needed.

#### Is this the official Twitch API?

No. It is an independent scraper of public Twitch pages and is not affiliated with Twitch.

#### Why did my Twitch Scraper run return no results?

The run's status message says why: a channel login that does not exist, a category name Twitch does not know, filters that removed every row, or nothing new since the last monitor run. Nothing is charged for an empty run.

#### Your feedback

Found a bug or need a field? Open an issue in the [Issues tab](https://apify.com/TopApi/twitch-scraper/issues/open) and we will look at it.

# Actor input Schema

## `channels` (type: `array`):

Channel logins or links, e.g. "shroud", "https://www.twitch.tv/pokimane". One channel row each: followers, live stream, last broadcast, bio, emails, socials, panels, team.

## `startUrls` (type: `array`):

Any twitch.tv link: a channel, /videos, /clips, a VOD (/videos/2911460606), a clip, a category (/directory/category/valorant, /clips, /videos), /directory (top categories), /directory/all (top streams) or /search?term=.

## `searchQueries` (type: `array`):

Words to search Twitch for, e.g. "valorant", "speedrun". Search type below picks channels, categories or videos.

## `searchType` (type: `string`):

What the search terms look for. Channel results are full channel rows.

## `categories` (type: `array`):

Category names or slugs, e.g. "Just Chatting", "valorant", "Grand Theft Auto V". What to read from each is set in Category output.

## `categoryOutput` (type: `array`):

Rows to read from each category: its live streams, the channels streaming it (full channel rows, for lead lists), its top clips, its videos, or the category's own stats row.

## `topStreams` (type: `boolean`):

The most-watched live streams on all of Twitch right now (languages and tags below apply).

## `topCategories` (type: `boolean`):

Twitch's most-watched categories right now (up to 100): viewers, live channels, followers, tags.

## `chatVideoUrls` (type: `array`):

VOD links or ids whose chat replay to export, one row per message, e.g. https://www.twitch.tv/videos/2911460606. Message caps are under Extra data.

## `languages` (type: `array`):

Only streams (and category clips / videos) in these languages. Empty = all languages; Twitch's 30-stream pages are then widened language by language.

## `tags` (type: `array`):

Only live streams carrying these tags, e.g. "DropsEnabled", "Speedrun", "English" (up to 5).

## `streamSort` (type: `string`):

Order of live streams; the other orders are used to go past Twitch's 30-stream page.

## `clipPeriod` (type: `string`):

Clips made in this window (channel and category clips).

## `clipSort` (type: `string`):

Most viewed, or Twitch's trending order.

## `videoType` (type: `string`):

Past broadcasts, highlights, uploads or past premieres. Empty = all types.

## `videoSort` (type: `string`):

Newest first or most viewed first.

## `minFollowers` (type: `integer`):

Channels (and streamers of live streams) with at least this many followers, e.g. 1000.

## `maxFollowers` (type: `integer`):

Channels (and streamers) with at most this many followers, e.g. 50000 for small creators.

## `minViewers` (type: `integer`):

Live streams with at least this many viewers now.

## `maxViewers` (type: `integer`):

Live streams with at most this many viewers now.

## `minViews` (type: `integer`):

Videos and clips with at least this many views.

## `onlyLive` (type: `boolean`):

Keep only channel rows that are live right now.

## `onlyWithEmail` (type: `boolean`):

Keep only channel rows with an email address in the bio or About panels.

## `broadcasterType` (type: `string`):

Channels and streamers by Twitch status.

## `dateFrom` (type: `string`):

Videos and clips created (and streams started) on or after this day, e.g. 2026-10-01.

## `dateTo` (type: `string`):

Videos and clips created (and streams started) on or before this day.

## `maxAgeDays` (type: `integer`):

Videos and clips from the last N days. Pairs well with a daily schedule.

## `includeVideos` (type: `boolean`):

Also save each channel's videos as video rows (title, views, duration, category, chapters) and list the latest 5 on the channel row.

## `videosPerChannel` (type: `integer`):

Videos per channel. Twitch lists 100 per type and sort; more come from the other types and sorts.

## `includeClips` (type: `boolean`):

Also save each channel's top clips as clip rows (views, curator, VOD moment) and list the top 5 on the channel row.

## `clipsPerChannel` (type: `integer`):

Clips per channel within the clip period.

## `includeClipDownloadUrls` (type: `boolean`):

Add an MP4 download link (best quality) to every clip row. Links expire after about a day.

## `includeSchedule` (type: `boolean`):

Add each channel's upcoming scheduled streams and next stream time to the channel row (no extra charge).

## `includeEmotes` (type: `boolean`):

Add each channel's subscriber emotes (name, tier, image) to the channel row (no extra charge).

## `includeChapters` (type: `boolean`):

Add chapters (each category played and when) to video rows (no extra charge).

## `includeVodChat` (type: `boolean`):

Also export the chat replay of every past broadcast this run saves, one row per message.

## `maxChatMessagesPerVideo` (type: `integer`):

Messages per VOD, from the start (or From second). 0 = the whole replay.

## `chatStartSeconds` (type: `integer`):

Start the chat replay this many seconds into the VOD, e.g. 3600 = 1 hour in.

## `chatEndSeconds` (type: `integer`):

Stop the chat replay at this second of the VOD. Empty = to the end.

## `monitorMode` (type: `boolean`):

Save only rows not saved by earlier runs: new streams, videos, clips and chat; channels that are new, went live or offline, or changed followers.

## `monitorOutput` (type: `string`):

What a monitor run saves.

## `monitorStoreName` (type: `string`):

Name of the key-value store that remembers earlier runs. Use one name per watch list.

## `maxItems` (type: `integer`):

Most rows to save in this run (channels, streams, videos, clips, categories). Chat messages are capped per VOD instead. 0 = no cap.

## `maxResultsPerSource` (type: `integer`):

Rows per category, search term, top list or channel /videos /clips link. Twitch shows ~25 live streams per view; more come from other sorts and languages.

## `compact` (type: `boolean`):

Core fields only, trimmed for spreadsheets and AI agents.

## `proxyConfiguration` (type: `object`):

Optional. Twitch answers without a proxy; a proxy you set is tried first.

## `maxConcurrency` (type: `integer`):

Requests to Twitch at the same time.

## Actor input object example

```json
{
  "channels": [
    "shroud",
    "pokimane"
  ],
  "searchType": "channels",
  "categories": [
    "Just Chatting"
  ],
  "categoryOutput": [
    "streams"
  ],
  "streamSort": "VIEWER_COUNT",
  "clipPeriod": "LAST_WEEK",
  "clipSort": "VIEWS_DESC",
  "videoSort": "TIME",
  "broadcasterType": "any",
  "videosPerChannel": 20,
  "clipsPerChannel": 20,
  "includeChapters": true,
  "maxChatMessagesPerVideo": 1000,
  "monitorOutput": "changes",
  "monitorStoreName": "twitch-monitor",
  "maxItems": 100,
  "maxResultsPerSource": 20,
  "maxConcurrency": 4
}
```

# Actor output Schema

## `results` (type: `string`):

One item per Twitch channel, live stream, video, clip, category or VOD chat message (the type field says which).

## `summary` (type: `string`):

Per-source counts (delivered, examined), filtered and duplicate counts, not-found inputs, routes used, field fill and charges.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "channels": [
        "shroud",
        "pokimane"
    ],
    "categories": [
        "Just Chatting"
    ],
    "maxItems": 100,
    "maxResultsPerSource": 20
};

// Run the Actor and wait for it to finish
const run = await client.actor("topapi/twitch-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "channels": [
        "shroud",
        "pokimane",
    ],
    "categories": ["Just Chatting"],
    "maxItems": 100,
    "maxResultsPerSource": 20,
}

# Run the Actor and wait for it to finish
run = client.actor("topapi/twitch-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "channels": [
    "shroud",
    "pokimane"
  ],
  "categories": [
    "Just Chatting"
  ],
  "maxItems": 100,
  "maxResultsPerSource": 20
}' |
apify call topapi/twitch-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,topapi/twitch-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/DlSjm9ph4feFrGizW/builds/X7Ej7QbdYjPg9yBKS/openapi.json
