# Twitch Scraper - Channels, Streams, Clips & Streamer Leads (`scrapesage/twitch-scraper`) Actor Scrape Twitch channels, live streams, games/categories, clips & VODs. Get follower counts, live status, viewers, titles, tags, plus streamer leads (business email, socials & lead score). Search or paste URLs; only-new monitor mode. - **URL**: https://apify.com/scrapesage/twitch-scraper.md - **Developed by:** [Scrape Sage](https://apify.com/scrapesage) (community) - **Categories:** Social media, Lead generation, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $4.00 / 1,000 channel scrapeds 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/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. 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. Actors are written with capital "A". ## 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. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Twitch Scraper — Channels, Live Streams, Clips, VODs & Streamer Leads Extract **complete Twitch data** — streamer profiles, live streams, games/categories, clips and VODs — and turn every channel into a **ready-to-contact influencer-marketing lead** with a business email, social links and a 0–100 lead score. No login, no API key, no browser — fast JSON extraction straight from Twitch's own public GraphQL back end, with **inline queries** that don't break when Twitch rotates its internal query hashes (the failure mode of most other Twitch scrapers). ### Why this Twitch scraper? Most Twitch scrapers return a thin slice (just live streams, or just a follower count) and break whenever Twitch rotates its persisted-query hashes. This actor ships the **richest dataset in the category** and is resilient by design: | Data | Typical scrapers | This actor | |---|---|---| | Channel profile (followers, partner/affiliate, account age) | partial | ✅ full | | Live status + current stream (title, game, viewers, tags, uptime, FPS) | partial | ✅ | | Live-stream **directory** (top overall or by game, with follower counts) | partial | ✅ | | Games / categories with live viewer counts | ❌ | ✅ | | Clips (by channel **or** game, any time window) | partial | ✅ | | Videos / VODs (past broadcasts, highlights, uploads) | partial | ✅ | | Keyword **search** (channels, games, videos) | ❌ | ✅ | | Streamer **business email** (parsed from the bio) | ❌ | ✅ opt-in | | Social links (Instagram, YouTube, TikTok, X, Discord, Facebook…) | ❌ | ✅ opt-in | | Lead score (0–100) per streamer | ❌ | ✅ opt-in | | Only-new / status-change **monitor mode** | ❌ | ✅ | | No start fee | ❌ many charge one | ✅ | ### Use cases - **Influencer & sponsorship outreach** — find streamers by game, size or keyword, then contact them directly with `businessEmail` and their `instagram` / `youtube` / `tiktok` / `twitter` / `discord` links, ranked by `leadScore` and `followersCount`. - **Esports & gaming market research** — track which **games** and **categories** are pulling viewers right now, and who the top live broadcasters are in each. - **Live audience monitoring** — schedule recurring runs to watch when specific streamers go **live/offline** or switch games, and capture viewer counts over time. - **Content & trend discovery** — pull top **clips** and **VODs** by channel or game for highlight reels, recaps and trend analysis. - **Creator analytics** — build dashboards of follower reach, partner status, stream uptime and category mix across any list of channels. ### How to use 1. [Sign up for Apify](https://console.apify.com/sign-up) — the free plan is enough to try this actor. 2. Open the **Twitch Scraper**, pick a **mode**, enter channel names / games / a search query (or paste Twitch URLs), and click **Start**. 3. Watch results stream into the dataset table. 4. **Export** as JSON, CSV, Excel, XML or RSS — or pull results programmatically via the [Apify API](https://docs.apify.com/api/v2). ### Modes | Mode | What you get | Key inputs | |---|---|---| | **channels** | Full streamer profiles + live status | `channelUsernames`, `startUrls` | | **liveStreams** | Live directory (top overall or by game) | `gameNames`, `language`, `maxResults` | | **games** | Categories with live viewer counts | `gameNames` (or top games) | | **clips** | Top clips by channel or game | `channelUsernames` / `gameNames`, `clipPeriod` | | **videos** | VODs (past broadcasts / highlights) | `channelUsernames`, `videoType`, `videoSort` | | **search** | Search channels / games / videos | `searchQuery`, `searchType` | | **streamerLeads** | Channels with lead enrichment forced on | `channelUsernames` | ### Input ```json { "mode": "channels", "channelUsernames": ["pokimane", "jynxzi", "shroud"], "includeStreamerLeads": true, "enrichLeadWebsites": false, "monitorMode": false } ```` Other examples: ```json { "mode": "liveStreams", "gameNames": ["VALORANT", "Just Chatting"], "language": "en", "maxResults": 30 } ``` ```json { "mode": "clips", "channelUsernames": ["jynxzi"], "clipPeriod": "LAST_WEEK", "maxResults": 50 } ``` ```json { "mode": "search", "searchQuery": "speedrun", "searchType": "all" } ``` - **mode** — `channels`, `liveStreams`, `games`, `clips`, `videos`, `search` or `streamerLeads`. - **channelUsernames** — Twitch logins (the name in `twitch.tv/`). - **gameNames** — game/category names (e.g. `VALORANT`, `Just Chatting`). - **searchQuery / searchType** — keyword search; `channels`, `games`, `videos` or `all`. - **startUrls** — paste channel, category, clip or video URLs to auto-route. - **maxResults** — cap per channel/game/search. *Live directory pages are capped at 30 per game by Twitch; games/clips/videos allow up to 100; channels mode is uncapped.* - **language** — keep only matching live streams (`en`, `es`, `de`, …). - **clipPeriod** — `LAST_DAY`, `LAST_WEEK`, `LAST_MONTH`, `ALL_TIME`. - **videoType / videoSort** — `ARCHIVE`/`HIGHLIGHT`/`UPLOAD`/`ALL`, sorted by `TIME` or `VIEWS`. - **includeStreamerLeads** *(default false)* — add business email + socials + lead score to each channel and output dedup'd `streamerLead` records. - **enrichLeadWebsites** *(default false)* — crawl a streamer's linked website (home + /contact + /about) for extra emails and phones. - **monitorMode / monitorKey** — output only new/changed items across scheduled runs. ### Output One record per item, tagged by `type` (`channel`, `stream`, `game`, `clip`, `video`, `searchResult`, `streamerLead`). Example **channel** record with leads enabled: ```json { "type": "channel", "id": "44445592", "login": "pokimane", "displayName": "pokimane", "url": "https://www.twitch.tv/pokimane", "description": "hi ♡ i stream sometimes 📧 Business inquiries: teampokimane@wmeagency.com", "profileImageUrl": "https://static-cdn.jtvnw.net/jtv_user_pictures/…-profile_image-300x300.png", "primaryColorHex": "#E1B5D9", "createdAt": "2013-06-07T14:25:22.266Z", "accountAgeYears": 13, "isPartner": true, "isAffiliate": false, "broadcasterType": "partner", "followersCount": 9459632, "isLive": false, "currentGame": "Just Chatting", "broadcastLanguage": "EN", "lastBroadcast": { "id": "318153812695", "title": "GRWM / AMA !", "startedAt": "2026-06-17T20:05:47Z", "game": "Just Chatting" }, "businessEmail": "teampokimane@wmeagency.com", "emails": ["teampokimane@wmeagency.com"], "instagram": "https://www.instagram.com/pokimanelol/", "youtube": "https://www.youtube.com/pokimane", "tiktok": "https://www.tiktok.com/@poki", "twitter": "https://twitter.com/pokimanelol", "facebook": "https://www.facebook.com/pokimane", "socialLinksCount": 5, "leadScore": 90, "scrapedAt": "2026-06-18T00:16:52.820Z" } ``` A **stream** record (live directory) carries `title`, `viewersCount`, `game`, `language`, `tags`, `uptimeMinutes`, `averageFps`, `thumbnailUrl` and the broadcaster's `login`, `displayName` and `broadcasterFollowersCount`. ### Automate & schedule Run this actor on autopilot and pull results into your own stack: - **[Apify API](https://docs.apify.com/api/v2)** — start runs, fetch datasets, manage schedules over REST. - **[apify-client for JavaScript](https://docs.apify.com/api/client/js/)** and **[apify-client for Python](https://docs.apify.com/api/client/python/)** — official SDKs. - **[Schedules](https://docs.apify.com/platform/schedules)** — run it every few minutes/hours to track when streamers go live, watch a game's directory, or grow a lead list. Turn on **monitor mode** to pay only for new/changed items. - **[Webhooks](https://docs.apify.com/platform/integrations/webhooks)** — trigger downstream actions (CRM import, Slack alert, Discord ping) the moment a run finishes. ```js import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ token: 'MY_APIFY_TOKEN' }); const run = await client.actor('scrapesage/twitch-scraper').call({ mode: 'channels', channelUsernames: ['pokimane', 'jynxzi'], includeStreamerLeads: true, }); const { items } = await client.dataset(run.defaultDatasetId).listItems(); console.log(`Got ${items.length} channels & streamer leads`); ``` ### Integrate with any app Connect the dataset to 5,000+ apps — no code required: - **[Make](https://docs.apify.com/platform/integrations/make)** — multi-step automation scenarios. - **[Zapier](https://docs.apify.com/platform/integrations/zapier)** — push new streamer leads straight into your CRM. - **[Slack](https://docs.apify.com/platform/integrations/slack)** — get pinged when a monitored streamer goes live. - **[Google Drive / Sheets](https://docs.apify.com/platform/integrations/drive)** — auto-export every run to a spreadsheet. - **[Airbyte](https://docs.apify.com/platform/integrations/airbyte)** — pipe results into your data warehouse. - **[GitHub](https://docs.apify.com/platform/integrations/github)** — trigger runs from commits or releases. ### Use with AI assistants (MCP) The output is clean, LLM-ready JSON. Call this actor from Claude, ChatGPT or any agent framework through the **[Apify MCP server](https://docs.apify.com/platform/integrations/mcp)** — ask your assistant to "find the top VALORANT streamers live right now and list their contact emails" and let it run this scraper for you. ### Agent-ready: autonomous payments (x402 & Skyfire) This actor is **agent-ready** — AI agents can discover it, run it, and **pay for it autonomously**, with no Apify account and no human in the loop. It uses [pay-per-event](https://docs.apify.com/platform/actors/publishing/monetize/pay-per-event) pricing and [limited permissions](https://docs.apify.com/platform/actors/development/permissions), so it qualifies for Apify's agentic-payment standards: - **[x402](https://docs.apify.com/platform/integrations/x402)** — an open, HTTP-native payment protocol. Agents pay per run in USDC on the Base network directly through the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp) — no account, no API key. - **[Skyfire](https://docs.apify.com/platform/integrations/skyfire)** — agent-to-service payments for fully autonomous AI-agent workflows. Building an AI agent, MCP tool, or autonomous data pipeline? This scraper is ready to plug in and pay as it goes. ### More scrapers from scrapesage Build a complete **creator-economy & influencer lead-gen stack** — scrape every platform your prospects publish on: - **[Spotify Scraper](https://apify.com/scrapesage/spotify-scraper)** — artists, monthly listeners, tracks, playlists & podcasts. - **[SoundCloud Scraper](https://apify.com/scrapesage/soundcloud-scraper)** — tracks, artists, plays & creator contacts. - **[YouTube Scraper](https://apify.com/scrapesage/youtube-scraper)** — channels, videos & creator email leads. - **[Patreon Scraper](https://apify.com/scrapesage/patreon-scraper)** — creators, membership tiers & earnings estimates. - **[Substack Scraper](https://apify.com/scrapesage/substack-scraper)** — newsletters, subscriber counts & author leads. - **[Linktree Scraper](https://apify.com/scrapesage/linktree-scraper)** — creator bio links, emails & socials. - **[Civitai Scraper](https://apify.com/scrapesage/civitai-scraper)** — generative-AI models, images & creator leads. - **[Product Hunt Scraper](https://apify.com/scrapesage/product-hunt-scraper)** — launches, makers & maker leads. ### Tips - **Build a lead list fast**: run `liveStreams` for a game to discover who's live, copy the `broadcasterLogin`s into `channelUsernames`, then run `channels` with `includeStreamerLeads` for full contact data and lead scores. - **Live directory depth**: Twitch caps directory pages at 30 streams per game without a browser token. Pass several `gameNames` to get 30 each, or use `channels` mode (uncapped) for a known list of streamers. - **Monitoring**: combine [Schedules](https://docs.apify.com/platform/schedules) with `monitorMode` — channels re-emit only when they go live/offline or switch games, so you pay only for change. - **Proxies**: the default is RESIDENTIAL because Twitch returns streamer social links only to residential IPs. For modes that don't need socials (`liveStreams`, `games`, `clips`, `videos`, `search`) you can switch to datacenter to save a little. ### FAQ **Do I need a Twitch API key or login?** No. This actor reads Twitch's public web GraphQL back end — the same data anonymous visitors see — with no key, OAuth or browser. **Can I get a streamer's email?** When `includeStreamerLeads` is on, the actor extracts the business/booking email that streamers publish in their own bio, plus their public social links. With `enrichLeadWebsites` it also checks a linked website. It never accesses private data. **How do I scrape the top streamers for a game?** Use `liveStreams` mode with the game in `gameNames` — you'll get the live directory (up to 30 per game) with viewers, titles, tags and follower counts. **Can I export to Google Sheets, CSV or Excel?** Yes — one click in the dataset view, or automatically on every run via the [Google Drive integration](https://docs.apify.com/platform/integrations/drive). **How do I get alerted when someone goes live?** Run `channels` mode on a [Schedule](https://docs.apify.com/platform/schedules) with `monitorMode` on; channels re-emit when their live status changes. Add a [webhook](https://docs.apify.com/platform/integrations/webhooks) or Slack/Zapier step to push the alert. **A field is null — why?** Some channels don't publish socials, a website or a current game, and offline channels have no live `stream`. Fields are `null` only when the data doesn't exist, not because the scraper skipped them. **Is scraping Twitch legal?** This actor collects publicly available data only. You are responsible for using the data in compliance with applicable laws (GDPR/CCPA for personal data) and Twitch's terms. ### Need help? Open an issue on the actor's **Issues** tab, or visit the [Apify help center](https://help.apify.com/). Feature requests are welcome — this actor is actively maintained. # Actor input Schema ## `mode` (type: `string`): What to scrape. channels = streamer profiles (followers, live status, current stream); liveStreams = live directory (top overall or by game); games = categories with viewer counts; clips = top clips by channel or game; videos = past broadcasts / highlights (VODs) by channel; search = search Twitch by keyword; streamerLeads = channels with lead enrichment forced on. ## `channelUsernames` (type: `array`): Twitch channel logins (the name in twitch.tv/) for channels, clips, videos & streamerLeads modes. Example: \["pokimane", "shroud", "jynxzi"]. ## `gameNames` (type: `array`): Game or category names for liveStreams, games & clips modes. Example: \["VALORANT", "Just Chatting", "Grand Theft Auto V"]. Leave empty in liveStreams/games mode to get the top overall directory. ## `searchQuery` (type: `string`): Keyword to search for (search mode). Returns matching channels, games and/or videos depending on Search type. ## `searchType` (type: `string`): Which result types to return in search mode. ## `startUrls` (type: `array`): Paste Twitch URLs to auto-route: channel pages (twitch.tv/), category pages (twitch.tv/directory/category/), clip or video URLs. Mixed with the mode above. ## `maxResults` (type: `integer`): Cap of results per channel / game / search. Live directory pages are capped at 30 per game (and 30 overall) by Twitch; games/clips/videos allow up to 100. The channels mode has no cap (one query per channel). ## `language` (type: `string`): Optional 2-letter language code to keep only matching live streams in liveStreams mode (e.g. "en", "es", "de", "fr"). Leave empty for all languages. ## `clipPeriod` (type: `string`): Time window for top clips (clips mode). ## `videoType` (type: `string`): Which VOD type to return (videos mode). Archive = past broadcasts. ## `videoSort` (type: `string`): Sort order for videos mode. ## `includeStreamerLeads` (type: `boolean`): For channels mode: enrich each channel record with a business email (parsed from the bio), social links (Instagram, YouTube, TikTok, X, Discord, …), a website and a 0–100 lead score — and also output one dedup'd lead record (type "streamerLead") per channel. Ideal for influencer-marketing outreach. ## `enrichLeadWebsites` (type: `boolean`): When Include streamer leads is on and a channel links a personal/business website, crawl its home + /contact + /about pages for extra emails and phone numbers. Adds a few requests per channel that has a website. ## `monitorMode` (type: `boolean`): Remember items across runs in a named key-value store and output only NEW or CHANGED items. Channels re-emit when they go live/offline or switch games; streams, clips, videos & games are emitted only the first time they're seen. Works alongside Apify Schedules (the schedule triggers the run; monitor mode filters the output). ## `monitorKey` (type: `string`): Name for the monitor's memory store, so separate watch-lists don't collide. Reuse the same key on each scheduled run. ## `proxyConfiguration` (type: `object`): Proxy settings. RESIDENTIAL is the default because Twitch only returns streamer social links (Instagram/YouTube/TikTok/…) to residential IPs. For modes that don't need social links (liveStreams, games, clips, videos, search) you can switch to datacenter ({ "useApifyProxy": true }) to save a little. ## Actor input object example ```json { "mode": "channels", "channelUsernames": [ "pokimane", "shroud" ], "searchType": "channels", "maxResults": 50, "clipPeriod": "LAST_WEEK", "videoType": "ARCHIVE", "videoSort": "TIME", "includeStreamerLeads": false, "enrichLeadWebsites": false, "monitorMode": false, "monitorKey": "default", "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } ``` # Actor output Schema ## `results` (type: `string`): All scraped Twitch records as JSON items in the default dataset. # 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": [ "pokimane", "shroud" ], "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }; // Run the Actor and wait for it to finish const run = await client.actor("scrapesage/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": [ "pokimane", "shroud", ], "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], }, } # Run the Actor and wait for it to finish run = client.actor("scrapesage/twitch-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).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": [ "pokimane", "shroud" ], "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }' | apify call scrapesage/twitch-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=scrapesage/twitch-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Twitch Scraper - Channels, Streams, Clips & Streamer Leads", "description": "Scrape Twitch channels, live streams, games/categories, clips & VODs. Get follower counts, live status, viewers, titles, tags, plus streamer leads (business email, socials & lead score). Search or paste URLs; only-new monitor mode.", "version": "0.1", "x-build-id": "EO97w07hug2zztkp3" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapesage~twitch-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapesage-twitch-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/scrapesage~twitch-scraper/runs": { "post": { "operationId": "runs-sync-scrapesage-twitch-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/scrapesage~twitch-scraper/run-sync": { "post": { "operationId": "run-sync-scrapesage-twitch-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "mode": { "title": "Mode", "enum": [ "channels", "liveStreams", "games", "clips", "videos", "search", "streamerLeads" ], "type": "string", "description": "What to scrape. channels = streamer profiles (followers, live status, current stream); liveStreams = live directory (top overall or by game); games = categories with viewer counts; clips = top clips by channel or game; videos = past broadcasts / highlights (VODs) by channel; search = search Twitch by keyword; streamerLeads = channels with lead enrichment forced on.", "default": "channels" }, "channelUsernames": { "title": "Channel usernames", "type": "array", "description": "Twitch channel logins (the name in twitch.tv/) for channels, clips, videos & streamerLeads modes. Example: [\"pokimane\", \"shroud\", \"jynxzi\"].", "items": { "type": "string" } }, "gameNames": { "title": "Games / categories", "type": "array", "description": "Game or category names for liveStreams, games & clips modes. Example: [\"VALORANT\", \"Just Chatting\", \"Grand Theft Auto V\"]. Leave empty in liveStreams/games mode to get the top overall directory.", "items": { "type": "string" } }, "searchQuery": { "title": "Search query", "type": "string", "description": "Keyword to search for (search mode). Returns matching channels, games and/or videos depending on Search type." }, "searchType": { "title": "Search type", "enum": [ "channels", "games", "videos", "all" ], "type": "string", "description": "Which result types to return in search mode.", "default": "channels" }, "startUrls": { "title": "Start URLs", "type": "array", "description": "Paste Twitch URLs to auto-route: channel pages (twitch.tv/), category pages (twitch.tv/directory/category/), clip or video URLs. Mixed with the mode above.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxResults": { "title": "Max results per query", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Cap of results per channel / game / search. Live directory pages are capped at 30 per game (and 30 overall) by Twitch; games/clips/videos allow up to 100. The channels mode has no cap (one query per channel).", "default": 50 }, "language": { "title": "Stream language filter", "type": "string", "description": "Optional 2-letter language code to keep only matching live streams in liveStreams mode (e.g. \"en\", \"es\", \"de\", \"fr\"). Leave empty for all languages." }, "clipPeriod": { "title": "Clip period", "enum": [ "LAST_DAY", "LAST_WEEK", "LAST_MONTH", "ALL_TIME" ], "type": "string", "description": "Time window for top clips (clips mode).", "default": "LAST_WEEK" }, "videoType": { "title": "Video type", "enum": [ "ARCHIVE", "HIGHLIGHT", "UPLOAD", "ALL" ], "type": "string", "description": "Which VOD type to return (videos mode). Archive = past broadcasts.", "default": "ARCHIVE" }, "videoSort": { "title": "Video sort", "enum": [ "TIME", "VIEWS" ], "type": "string", "description": "Sort order for videos mode.", "default": "TIME" }, "includeStreamerLeads": { "title": "Include streamer leads", "type": "boolean", "description": "For channels mode: enrich each channel record with a business email (parsed from the bio), social links (Instagram, YouTube, TikTok, X, Discord, …), a website and a 0–100 lead score — and also output one dedup'd lead record (type \"streamerLead\") per channel. Ideal for influencer-marketing outreach.", "default": false }, "enrichLeadWebsites": { "title": "Crawl streamer websites for contacts", "type": "boolean", "description": "When Include streamer leads is on and a channel links a personal/business website, crawl its home + /contact + /about pages for extra emails and phone numbers. Adds a few requests per channel that has a website.", "default": false }, "monitorMode": { "title": "Monitor mode (only new / changed)", "type": "boolean", "description": "Remember items across runs in a named key-value store and output only NEW or CHANGED items. Channels re-emit when they go live/offline or switch games; streams, clips, videos & games are emitted only the first time they're seen. Works alongside Apify Schedules (the schedule triggers the run; monitor mode filters the output).", "default": false }, "monitorKey": { "title": "Monitor key", "type": "string", "description": "Name for the monitor's memory store, so separate watch-lists don't collide. Reuse the same key on each scheduled run.", "default": "default" }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Proxy settings. RESIDENTIAL is the default because Twitch only returns streamer social links (Instagram/YouTube/TikTok/…) to residential IPs. For modes that don't need social links (liveStreams, games, clips, videos, search) you can switch to datacenter ({ \"useApifyProxy\": true }) to save a little.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```