# Twitch Videos Scraper — VOD Metadata & Metrics (`khadinakbar/twitch-videos-scraper`) Actor Extract public Twitch channel videos (VODs) with titles, descriptions, views, duration, dates, category, thumbnails, and channel metadata. One dataset item per video; no login required. - **URL**: https://apify.com/khadinakbar/twitch-videos-scraper.md - **Developed by:** [Khadin Akbar](https://apify.com/khadinakbar) (community) - **Categories:** Videos, Social media, MCP servers - **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $4.00 / 1,000 twitch video scrapeds This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows. 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 Videos Scraper — VOD Metadata & Metrics Extract public Twitch archived-video (VOD) metadata from one or more known channels. Each dataset item is one video, ready for creator research, content inventories, stream analytics, and AI-agent workflows. Use this actor when you have Twitch channel URLs or logins and need recent VOD titles, views, duration, publication dates, game/category, thumbnails, and channel metadata. It does not search Twitch, return clips, download video files, access private content, or monitor a live stream. ### What you get | Field | Description | | --- | --- | | `videoId`, `videoUrl`, `title` | Stable Twitch VOD identity and public title | | `publishedAt`, `durationSeconds`, `viewCount` | Public video timing and point-in-time metrics | | `gameId`, `gameName`, `broadcastType` | Category and Twitch video classification | | `channelLogin`, `channelDisplayName`, `channelFollowerCount` | Public broadcaster context | | `thumbnailUrl`, `scrapedAt`, `source` | Provenance and freshness information | ### Input ```json { "channelUrls": ["https://www.twitch.tv/shroud", "pokimane"], "maxVideosPerChannel": 20, "maxTotalVideos": 100 } ```` `channelUrls` accepts public Twitch channel URLs or bare logins. The actor returns the most recent archived videos that Twitch exposes, up to the per-channel and whole-run caps. ### Output example ```json { "recordType": "twitch-video", "channelLogin": "shroud", "videoId": "2819944258", "videoUrl": "https://www.twitch.tv/videos/2819944258", "title": "beating old school games with my broy", "publishedAt": "2026-07-14T17:47:00.000Z", "durationSeconds": 21466, "viewCount": 162934, "gameName": "Resident Evil 5" } ``` ### Pricing | Event | Price | | --- | ---: | | Actor start | $0.00005 per GB of configured memory (minimum one event) | | Validated Twitch video written | $0.004 per video | The actor displays an upper event-charge estimate before collection and stops before exceeding `maxTotalVideos`. Apify platform usage is billed separately. ### Reliability and limits The actor uses Twitch's public web GraphQL endpoint and needs no account or cookie. Availability, historical retention, descriptions, thumbnails, and metrics are controlled by Twitch and can change. A valid channel with no available archived videos ends as `VALID_EMPTY`; upstream failures end honestly as `UPSTREAM_FAILED`. Every terminal run writes `OUTPUT` and `RUN_SUMMARY` to the default key-value store. For full public broadcaster profiles, live status, top clips, and channel-level metadata, use the [Twitch Channel Scraper](https://apify.com/khadinakbar/twitch-channel-scraper). ### Responsible use Use public data in accordance with Twitch's terms, applicable law, and your own privacy obligations. Do not use this actor to collect private content or make decisions about people without appropriate review. # Actor input Schema ## `channelUrls` (type: `array`): Use this when you know the Twitch channels whose archived videos you need. Enter full public channel URLs or bare logins, for example "https://www.twitch.tv/shroud" or "shroud". This is not a Twitch search query, video URL, clip URL, game/category, or @mention list. ## `maxVideosPerChannel` (type: `integer`): Use this when you want to cap recent VODs returned from each channel. Accepted range is 1–100 and the default is 20. The actor returns newest available archived videos first; this setting is not a date filter. ## `maxTotalVideos` (type: `integer`): Use this when you need a firm whole-run result and cost cap across all channels. Accepted range is 1–500 and the default is 100. At $0.004 per saved video, this also limits primary event charges; platform usage is additional. ## Actor input object example ```json { "channelUrls": [ "shroud", "https://www.twitch.tv/pokimane" ], "maxVideosPerChannel": 20, "maxTotalVideos": 100 } ``` # Actor output Schema ## `dataset` (type: `string`): One public archived Twitch video record per dataset item. ## `output` (type: `string`): Compact stable run outcome and billing summary. ## `runSummary` (type: `string`): Detailed diagnostics, including route errors and terminal outcome. # 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 = { "channelUrls": [ "https://www.twitch.tv/shroud" ] }; // Run the Actor and wait for it to finish const run = await client.actor("khadinakbar/twitch-videos-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 = { "channelUrls": ["https://www.twitch.tv/shroud"] } # Run the Actor and wait for it to finish run = client.actor("khadinakbar/twitch-videos-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 '{ "channelUrls": [ "https://www.twitch.tv/shroud" ] }' | apify call khadinakbar/twitch-videos-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=khadinakbar/twitch-videos-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Twitch Videos Scraper — VOD Metadata & Metrics", "description": "Extract public Twitch channel videos (VODs) with titles, descriptions, views, duration, dates, category, thumbnails, and channel metadata. One dataset item per video; no login required.", "version": "0.3", "x-build-id": "1jXgq3Kk7OdWq9Fkl" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/khadinakbar~twitch-videos-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-khadinakbar-twitch-videos-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/khadinakbar~twitch-videos-scraper/runs": { "post": { "operationId": "runs-sync-khadinakbar-twitch-videos-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/khadinakbar~twitch-videos-scraper/run-sync": { "post": { "operationId": "run-sync-khadinakbar-twitch-videos-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", "required": [ "channelUrls" ], "properties": { "channelUrls": { "title": "Twitch channels", "type": "array", "description": "Use this when you know the Twitch channels whose archived videos you need. Enter full public channel URLs or bare logins, for example \"https://www.twitch.tv/shroud\" or \"shroud\". This is not a Twitch search query, video URL, clip URL, game/category, or @mention list.", "items": { "type": "string" } }, "maxVideosPerChannel": { "title": "Max videos per channel", "minimum": 1, "maximum": 100, "type": "integer", "description": "Use this when you want to cap recent VODs returned from each channel. Accepted range is 1–100 and the default is 20. The actor returns newest available archived videos first; this setting is not a date filter.", "default": 20 }, "maxTotalVideos": { "title": "Whole-run video cap", "minimum": 1, "maximum": 500, "type": "integer", "description": "Use this when you need a firm whole-run result and cost cap across all channels. Accepted range is 1–500 and the default is 100. At $0.004 per saved video, this also limits primary event charges; platform usage is additional.", "default": 100 } } }, "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 } } } } } } } } } } ```