# Twitch Scraper — Channels, Streams, Leads (`memo23/twitch-scraper`) Actor Build Twitch influencer & sponsorship lists in minutes. Channel profiles with socials and contact emails, live streams by game, VODs, clips and schedules. Filter by follower band, live viewers or language, export creator leads as JSON, CSV or Excel. Keyless, no browser. - **URL**: https://apify.com/memo23/twitch-scraper.md - **Developed by:** [Muhamed Didovic](https://apify.com/memo23) (community) - **Categories:** Social media, Lead generation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $2.00 / 1,000 results 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 ## Twitch Scraper — Channels, Streams, Games, Clips & Leads **Turn any Twitch username, game, or search term into structured creator data — with socials and contact emails inline.** Scrape full channel profiles, live streams by game, the top-games directory, VODs, clips, and stream schedules straight from Twitch's public GraphQL API. Every channel row carries follower counts, partner/affiliate status, live status, the streamer's social links, and the business email from their bio and panels — the lead-gen fields most Twitch scrapers skip. No browser, no login, no API key. JSON, CSV or Excel out, charged per result. #### How it works ![How Twitch Scraper works](https://api.apify.com/v2/key-value-stores/IWd2o71L8AmXFkYqn/records/how-it-works-twitch.png) #### ✨ Why use this scraper? Building an influencer outreach list? Tracking who's live in your game category? Researching the streaming market, or monitoring a set of channels? Most Twitch actors give you follower counts and stop there — this one gives you the whole record and the way to reach the streamer. - 🎯 **8 modes, one actor.** Channel profiles, keyword channel search, live streams by game, top streams, the top-games directory, VODs, clips, and published stream schedules — pick a mode, paste your targets. - 📇 **Socials + contact emails, built in.** Every channel row includes the streamer's linked socials (YouTube, Instagram, X, TikTok, Discord…), their own website, and any business email parsed from their bio and channel panels — no separate "leads" actor needed. - 🔍 **Real lead-gen filters.** Narrow discovery by follower band (min/max), live viewer band, broadcaster language, "has email", or "has socials" — find the exact tier of streamer you want to reach. - 🌐 **Keyless GraphQL, no browser.** Talks to `gql.twitch.tv` the way the Twitch web app does — fast, light (runs at 256 MB), and reliable. No Playwright, no login, no cookies. - 📈 **Deeper directory coverage.** Game and top-stream directories fan out over sort and language partitions and dedupe broadcasters, pulling well past the 30-result ceiling most competitors admit to. - 📥 **Flexible input.** Usernames, `@handles`, full channel URLs, `/directory/category/…` links, game names or slugs, video and clip URLs — all auto-detected and merged. *** ### Overview Twitch Scraper extracts public data from [twitch.tv](https://www.twitch.tv) via Twitch's own GraphQL endpoint. It's built for marketers building creator/influencer lists, agencies sourcing sponsorship prospects, analysts tracking category viewership, and developers who need Twitch data without touching the rate-limited official Helix API or standing up a browser farm. Each run produces one row per result, with a `_type` field (`channel`, `stream`, `game`, `video`, `clip`, or `schedule`) so mixed-mode datasets stay filterable. Channel rows are the richest — a full profile plus socials, website, and emails. Stream rows embed the broadcaster's profile so a directory sweep doubles as a lead list. The scraper is HTTP-only (impit + a global sliding-window concurrency model). Twitch's public client ID is embedded at build time and **self-heals** — if Twitch rotates it, the actor re-extracts the current one from twitch.tv and retries, with no redeploy needed. *** ### Pricing | Event | When | Price | |---|---|---| | Actor start | Once per run (per GB of memory, 256 MB default) | $0.005 | | Result | Each row: channel, stream, game, video, clip or schedule entry | $0.002 | | Contact email | Each email found by the opt-in website lookup (`enrichEmails`); emails in the bio and panels are included in the row price | $0.05 | Example: 1,000 streamer profiles with socials and bio emails cost $2.00. ### Supported Inputs You can target Twitch four ways, mixed freely in one run: | Input field | Accepts | Example | |---|---|---| | `channelUsernames` | usernames, `@handles`, or channel URLs | `shroud`, `@pokimane`, `https://www.twitch.tv/caseoh_` | | `gameNames` | game/category names, slugs, or directory URLs | `Fortnite`, `just-chatting`, `https://www.twitch.tv/directory/category/valorant` | | `searchQueries` | free-text keywords (searchChannels mode) | `chess`, `speedrun`, `cooking` | | `startUrls` | any twitch.tv URL — channel, directory, video, or clip | `https://www.twitch.tv/videos/2820701541` | **Copy-pasteable start example:** ```json { "mode": "channels", "channelUsernames": ["shroud", "@pokimane", "https://www.twitch.tv/caseoh_"] } ``` **Not supported:** private/subscriber-only data, live chat messages, whispers/DMs, follower *lists* (Twitch gates these behind an integrity token), watch-time or revenue analytics, and anything requiring a logged-in session. See the FAQ. *** ### Use Cases | Audience | What they pull | |---|---| | Influencer marketing | Streamer shortlists filtered by follower band + language, with socials and contact emails for outreach | | Sponsorship agencies | Live-in-category prospect lists (who's streaming your game right now, at what audience size) | | Market research | Category viewership, top-games directory, streamer counts over time | | Brand monitoring | Track a set of channels — live status, current game, last broadcast, schedule | | Content / clips teams | Top clips by game or channel for a chosen period; VOD catalogs | | Data / dev teams | Clean Twitch data feed without the Helix API's OAuth + rate limits | *** ### How It Works 1. **You provide targets** — usernames, game names, search terms, or twitch.tv URLs — and pick a mode. 2. **The actor classifies each target** (user vs game vs video vs clip) and merges everything into one work list. 3. **It queries Twitch's public GraphQL API** — batching channel lookups (35 per request), fanning directory sweeps across sort/language partitions, and paginating search and video/clip lists. 4. **It enriches channel rows** — parsing socials and bio/panel emails, and (optionally) visiting the streamer's own website for a business email. 5. **It applies your filters** (followers, viewers, language, has-email, has-socials) and **pushes one clean row per result** to the dataset — export as JSON, CSV or Excel. *** ### Input Configuration Only fields that exist in the actor are listed. | Field | Type | Description | |---|---|---| | `mode` | select | `channels`, `searchChannels`, `gameStreams`, `topStreams`, `topGames`, `videos`, `clips`, `schedule`. Default `channels`. | | `channelUsernames` | array | Usernames, `@handles`, or channel URLs (channels/videos/clips/schedule). | | `gameNames` | array | Game/category names, slugs, or directory URLs (gameStreams/clips). | | `searchQueries` | array | Keywords for searchChannels mode; paginates far past the first page. | | `startUrls` | array | Any twitch.tv URLs — auto-detected and merged with the above. | | `maxItems` | integer | Stop after this many dataset rows. Default 100. | | `languages` | array | Two-letter broadcaster language codes, e.g. `["EN","DE"]`. | | `minFollowers` / `maxFollowers` | integer | Keep only channels/streams inside this follower band. | | `minViewers` / `maxViewers` | integer | Stream modes: keep streams inside this live-viewer band. | | `onlyWithEmail` | boolean | Keep only rows that surfaced a contact email. | | `onlyWithSocials` | boolean | Keep only rows with at least one social/website link. | | `includePanels` | boolean | Fetch channel panels for extra links/emails. Default true. | | `includeVideos` | boolean | Attach a `recentVideos` list to channel rows. | | `includeClips` | boolean | Attach a `topClips` list to channel rows. | | `maxVideosPerChannel` | integer | Cap for videos mode and nested VOD lists. Default 30. | | `maxClipsPerChannel` | integer | Cap for clips mode and nested clip lists. Default 30. | | `videoType` | select | `ALL`, `ARCHIVE` (past broadcasts), `HIGHLIGHT`, `UPLOAD`. | | `videoSort` | select | `TIME` or `VIEWS`. | | `clipPeriod` | select | `LAST_DAY`, `LAST_WEEK`, `LAST_MONTH`, `ALL_TIME`. | | `clipSort` | select | `VIEWS_DESC`, `CREATED_AT_DESC`, `TRENDING`. | | `enrichEmails` | boolean | Opt-in, free: crawl the streamer's own website for a business email. | | `maxConcurrency` | integer | Parallel requests against Twitch. Default 10. | | `proxy` | object | Optional. Twitch usually works with no proxy; add one only for rate-limiting. | **Example — find mid-tier English Fortnite streamers with an email, for outreach:** ```json { "mode": "gameStreams", "gameNames": ["Fortnite"], "languages": ["EN"], "minFollowers": 5000, "maxFollowers": 200000, "onlyWithEmail": true, "maxItems": 200 } ``` **Example — discover channels by keyword, with contact enrichment:** ```json { "mode": "searchChannels", "searchQueries": ["chess", "speedrun"], "enrichEmails": true, "maxItems": 100 } ``` *** ### Output Overview One row per result. The `_type` field tells you the shape. A **channel** row is a full streamer profile: identity, follower count, partner/affiliate flags, live status and current stream, last broadcast, total VOD count, socials, website, and any emails found in the bio/panels. **stream** rows embed the broadcaster's profile (so directory sweeps double as lead lists); **game**, **video**, **clip**, and **schedule** rows carry their own natural fields. *** ### Output Samples **Channel row** (from `mode: channels`, username `pokimane`, trimmed): ```json { "_type": "channel", "channelId": "44445592", "username": "pokimane", "displayName": "pokimane", "url": "https://www.twitch.tv/pokimane", "bio": "hi ♡ i stream sometimes 📧 Business inquiries: teampokimane@wmeagency.com", "followersCount": 9460991, "isPartner": true, "isAffiliate": false, "language": "EN", "isLive": false, "currentStream": null, "lastBroadcast": { "title": "see you soon!", "game": "Just Chatting", "startedAt": "2026-07-14T22:00:40Z" }, "totalVideos": 568, "socials": [ { "platform": "instagram", "url": "https://www.instagram.com/imane", "title": "Instagram" }, { "platform": "youtube", "url": "https://www.youtube.com/pokimane", "title": "YouTube" }, { "platform": "tiktok", "url": "https://www.tiktok.com/@poki", "title": "TikTok" } ], "website": null, "bioEmail": "teampokimane@wmeagency.com", "allEmails": ["teampokimane@wmeagency.com"] } ``` **Stream row** (from `mode: gameStreams`, trimmed): ```json { "_type": "stream", "streamId": "320501021019", "title": "DROPS ON! ranked grind", "viewersCount": 633, "language": "EN", "game": "Fortnite", "tags": ["English", "Controller"], "username": "swearin", "displayName": "swearin", "url": "https://www.twitch.tv/swearin", "followersCount": 63489, "isPartner": true, "bioEmail": "swearin@dulcedo.com", "socials": [{ "platform": "twitter", "url": "https://twitter.com/swearin", "title": "Twitter" }] } ``` *** ### Key Output Fields **Identity** — `channelId`, `username`, `displayName`, `url`, `bio`, `accountCreatedAt`, `profileImageUrl`, `bannerImageUrl`. **Audience & status** — `followersCount`, `isPartner`, `isAffiliate`, `isLive`, `language`, `team`, `totalVideos`. **Live / recent** — `currentStream` (title, game, viewers, startedAt, tags), `lastBroadcast` (title, game, startedAt). **Lead-gen** — `socials[]` (platform + url), `website`, `bioEmail`, `allEmails[]`, plus `contactEmail` / `contactWebsite` / `emailEnrichment` when `enrichEmails` is on. **Stream rows** — `streamId`, `viewersCount`, `startedAt`, `tags[]`, `thumbnailUrl`, `game`, `gameId` + the embedded broadcaster profile. **Game rows** — `name`, `slug`, `viewersCount`, `followersCount`, `broadcastersCount`, `boxArtUrl`. **Video rows** — `videoId`, `title`, `viewCount`, `lengthSeconds`, `publishedAt`, `type`, `game`, `url`. **Clip rows** — `clipId`, `slug`, `title`, `viewCount`, `durationSeconds`, `createdAt`, `game`, `curator`, `url`. **Schedule rows** — `segmentId`, `title`, `startAt`, `endAt`, `categories[]`. *** ### FAQ **Which URLs and inputs are supported?** Channel usernames/`@handles`/URLs, game names/slugs/directory URLs, search keywords, and video/clip URLs — see Supported Inputs. Everything is auto-classified. **Do I need a Twitch API key or login?** No. The actor uses Twitch's public web GraphQL endpoint. No OAuth, no cookies, no key. **Can it get streamer contact emails?** Yes, when the streamer publishes one. Emails are parsed from the channel bio and panels. Turn on `enrichEmails` to also visit the streamer's own linked website and scan its contact/about pages. Emails that aren't published anywhere public can't be found. **Can it scrape live chat, whispers, or a channel's full follower list?** No. Live chat, whispers, and follower/following lists are either private or gated behind Twitch's integrity token and are out of scope. The actor covers public profile, directory, video, clip, and schedule data. **Why are some directory results capped?** Twitch integrity-gates deep `after` pagination on live-stream directories. The actor works around this by sweeping multiple sort orders and languages and deduping broadcasters — giving materially more coverage than a single 30-result page — but a single game's live streams are still bounded by what Twitch exposes keylessly. **Is `schedule` data always present?** Only when the streamer has published a schedule. Channels without one return no schedule rows (logged, not an error). **Do I need a proxy?** Usually not — Twitch's public API accepts direct connections. Add a proxy only if you hit rate-limiting on a shared IP. *** ### Support Found a bug or need a field that isn't captured? Open an issue on the actor's **Issues** tab on the Apify Store, and it'll be looked at promptly. Include your input JSON and, where relevant, an example Twitch URL so the case can be reproduced. *** ### Additional Services Need a tailored export (a specific schema, a scheduled daily creator feed, a bundled multi-platform dataset), or a custom Twitch workflow? Custom scraping and enrichment work is available on request — reach out through the Issues tab or the developer profile. *** ### Explore More Scrapers This actor is part of a broader portfolio of directory, social, and lead-generation scrapers on the Apify Store. Browse the developer's other actors — job boards, real-estate portals, review sites, and social platforms — from the profile page linked on the actor listing. *** ### ⚠️ Disclaimer This actor is an independent tool and is **not affiliated with, endorsed by, or sponsored by Twitch Interactive, Inc. or Amazon.com, Inc.** "Twitch" and all related names, marks, and logos are trademarks of their respective owners and are used here only to describe the actor's function. The actor scrapes **publicly available data only** — information any visitor can see on twitch.tv without logging in. It does not access private, subscriber-only, or authenticated content, and it does not bypass access controls. You are responsible for using it in compliance with Twitch's Terms of Service, applicable laws, and data-protection regulations including GDPR and CCPA. Personal data (such as contact emails published by creators) must be processed on a lawful basis and only for legitimate purposes. Use responsibly. *** ### SEO Keywords Twitch scraper, Twitch API scraper, scrape Twitch channels, Twitch data extractor, Twitch streamer scraper, Twitch channel scraper, Twitch live streams scraper, Twitch clips scraper, Twitch VOD scraper, Twitch game directory scraper, Twitch email scraper, Twitch influencer scraper, streamer lead generation, influencer outreach data, creator contact emails, Twitch marketing data, Twitch follower data, Twitch category viewership, streamer discovery tool, Twitch schedule scraper, social media scraping, creator economy data, gaming influencer leads, Twitch analytics export # Actor input Schema ## `mode` (type: `string`): channels — full streamer profiles (socials, bio email, followers) for the usernames/URLs you provide.
searchChannels — discover channels by keyword (finds offline channels too, paginates deep).
gameStreams — live streams for the given games/categories.
topStreams — top live streams across all of Twitch.
topGames — the games/categories directory.
videos — VODs of the given channels.
clips — clips of the given channels or games.
schedule — published stream schedules of the given channels. ## `channelUsernames` (type: `array`): Twitch usernames, @handles, or full channel URLs — e.g. shroud, @pokimane, https://www.twitch.tv/caseoh\_. Used by the channels, videos, clips and schedule modes. ## `gameNames` (type: `array`): Game or category names (Fortnite, Just Chatting), slugs (just-chatting), or directory URLs (https://www.twitch.tv/directory/category/fortnite). Used by the gameStreams and clips modes. ## `searchQueries` (type: `array`): Keywords for searchChannels mode, e.g. chess, cooking, speedrun. Each query paginates far beyond the first page of Twitch search. ## `startUrls` (type: `array`): Any twitch.tv URLs — channel pages, directory/category pages, video or clip links. They are auto-detected and merged with the lists above. ## `maxItems` (type: `integer`): Stop after this many dataset rows (across all targets). ## `languages` (type: `array`): Two-letter language codes (e.g. EN, DE, ES). Stream modes filter server-side; channel modes filter on the channel's broadcast language. ## `minFollowers` (type: `integer`): Keep only channels/streams with at least this many followers. ## `maxFollowers` (type: `integer`): Keep only channels/streams with at most this many followers — ideal for finding micro/mid-tier streamers open to sponsorships. ## `minViewers` (type: `integer`): Stream modes only: keep streams with at least this many current viewers. ## `maxViewers` (type: `integer`): Stream modes only: keep streams with at most this many current viewers. ## `onlyWithEmail` (type: `boolean`): Keep only streamers whose bio/panels (or the opt-in enrichment) surfaced an email address. ## `onlyWithSocials` (type: `boolean`): Keep only streamers with at least one social/website link. ## `includePanels` (type: `boolean`): Fetch each channel's panels too — they often carry the streamer's own website, sponsor links and extra emails. One extra request per channel. ## `includeVideos` (type: `boolean`): Adds a recentVideos list to every channel row (channels/searchChannels modes). ## `includeClips` (type: `boolean`): Adds a topClips list to every channel row (channels/searchChannels modes). ## `maxVideosPerChannel` (type: `integer`): Cap for the videos mode and the nested recentVideos list. ## `maxClipsPerChannel` (type: `integer`): Cap for the clips mode and the nested topClips list. ## `videoType` (type: `string`): Filter VODs by type (videos mode). ## `videoSort` (type: `string`): Sort VODs by recency or views (videos mode). ## `clipPeriod` (type: `string`): Time window for clips. ## `clipSort` (type: `string`): Sort clips by views, recency, or trending. ## `enrichEmails` (type: `boolean`): Opt-in: when a streamer links their own website (in panels or social links), visit it and its contact/about pages to find a business email. Adds contactEmail, contactWebsite and a detailed emailEnrichment object. Best-effort. ## `maxConcurrency` (type: `integer`): Parallel requests against the Twitch API. ## `proxy` (type: `object`): Optional. Twitch's public API usually works without any proxy; add one only if you see rate-limiting. ## Actor input object example ```json { "mode": "channels", "channelUsernames": [ "shroud", "pokimane" ], "maxItems": 100, "onlyWithEmail": false, "onlyWithSocials": false, "includePanels": true, "includeVideos": false, "includeClips": false, "maxVideosPerChannel": 30, "maxClipsPerChannel": 30, "videoType": "ALL", "videoSort": "TIME", "clipPeriod": "LAST_WEEK", "clipSort": "VIEWS_DESC", "enrichEmails": false, "maxConcurrency": 10, "proxy": { "useApifyProxy": false } } ``` # Actor output Schema ## `results` (type: `string`): Rows told apart by `_type`: `channel`, `stream`, `game`, `video`, `clip` and `schedule`. # 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "channelUsernames": [ "shroud", "pokimane" ], "proxy": { "useApifyProxy": false } }; // Run the Actor and wait for it to finish const run = await client.actor("memo23/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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "channelUsernames": [ "shroud", "pokimane", ], "proxy": { "useApifyProxy": False }, } # Run the Actor and wait for it to finish run = client.actor("memo23/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 '{ "channelUsernames": [ "shroud", "pokimane" ], "proxy": { "useApifyProxy": false } }' | apify call memo23/twitch-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "type": "http", "url": "https://mcp.apify.com/?tools=fetch-actor-details,memo23/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 ` 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/tk12bXqlAqfx3bQmH/builds/BKxUZMTJGfkB4nB9o/openapi.json