Twitch Streams & Channels Scraper

Export public Twitch stream and channel metadata through the operator's authorized Twitch application. Start from categories, channel searches or public URLs, then inspect live viewers, stable channel IDs, available account details and optional nested VODs, clips and schedules. You do not supply Twitch credentials or receive media downloads.

Quick start

Choose a familiar category or search term, set a small shared channel cap and enable only the optional content you need. The existing example combines category and search sources with bounded enrichment:

{
  "categories": ["Just Chatting", "Minecraft"],
  "searchTerms": ["vtuber"],
  "includeOfflineChannels": true,
  "includeVideos": true,
  "videosPerChannel": 3,
  "includeClips": true,
  "clipsPerChannel": 3,
  "includeSchedule": true,
  "scheduleSegmentsPerChannel": 5,
  "maxEnrichedChannels": 20,
  "maxItems": 75
}

Prefer a video guide? This short Apify walkthrough shows you how to set up and run an Actor. It uses a different Actor, but the setup steps are the same.

Ready-to-run examples

• Export live Twitch channels from Just Chatting
• Find live Minecraft Twitch channels
• Find live and offline Twitch music channels
• Export Twitch channels with recent VODs and clips

Each public task provides a bounded starting input and a dedicated landing page. Duplicate one into your Apify account to run it as-is or customize the input.

With no channel, category, or search input, the Actor exports the current top live Twitch streams.

What you get

One unique channel row with identity, source context, live status and available stream metrics. Optional recentVideos, topClips and schedule data are nested in that row. Follower totals remain null without qualifying broadcaster authorization, and missing optional metadata is not replaced with invented values.

Who is it for?

• Creator partnership teams shortlisting public channels for separate sponsorship research.
• Game and esports analysts inspecting current live category audiences.
• Content researchers reviewing exposed VOD, clip and schedule metadata.
• Dashboard developers storing source-timed channel snapshots for their own comparisons.

How you can use the data

• Inspect a Minecraft category snapshot. Collect a small live sample and keep channelId, streamId, viewerCount, category and scrapedAt together. This records observed viewers rather than measuring unique viewers, total reach or future audience.
• Discover live and offline candidates by topic. Use the existing vtuber search with offline inclusion on. Compare channel identities and biographies, distinguishing offline channels from missing live metrics rather than treating a null viewer count as zero followers.
• Review a bounded content shortlist. Enable recent VODs, top clips and schedules for a small number of selected channels. Use nested IDs, titles, URLs and available times for your own editorial review, without downloading media or assuming empty arrays prove no content exists.
• Build your own monitoring comparison. Retain stable channel and stream IDs beside collection times in your destination, using the scheduling guidance below. Detect title, category or live-state differences downstream rather than asking this Actor to produce an automatic change report.

Input settings

Setting	API key	Description
Twitch URLs	startUrls	Up to 100 public channel, category, or Twitch search URLs.
Categories or games	categories	Up to 100 category names. The legacy games API alias remains accepted.
Channel search terms	searchTerms	Up to 100 public Twitch channel searches.
Maximum saved channels	maxItems	Global unique-row limit from 1 to 10,000. Default: 20.
Include offline channels	includeOfflineChannels	Include offline profiles from direct channel and search inputs. Default: true.
Include recent VODs	includeVideos	Attach public archived broadcasts. Default: false.
VODs per channel	videosPerChannel	Attach 1–5 recent broadcasts. Default: 3.
Include top clips	includeClips	Attach public clips. Default: false.
Clips per channel	clipsPerChannel	Attach 1–5 clips. Default: 3.
Include upcoming schedule	includeSchedule	Attach public upcoming schedule segments. Default: false.
Schedule segments per channel	scheduleSegmentsPerChannel	Attach 1–25 upcoming segments. Default: 5.
Maximum enriched channels	maxEnrichedChannels	Bound optional VOD, clip, and schedule requests to 1–100 channels. Default: 20.
Legacy empty-results setting	allowEmptyResults	Accepted for compatibility. Genuine completed no-match lookups succeed regardless of its value.
Active work deadline	maxRunSeconds	Stop admitting work after 60–270 seconds while preserving cleanup time. Default: 240.
Connection	connectionMode	Direct or Automatic. The form starts with Direct. See field help for API defaults and proxy costs.
Existing/custom proxy settings	proxyConfiguration	Optional advanced override that preserves saved settings and customer pools.

Output data

This synthetic example illustrates the row shape and optional nested metadata. It is not a real extracted channel:

{
  "url": "https://www.twitch.tv/examplechannel",
  "channelId": "123456789",
  "channelName": "examplechannel",
  "displayName": "ExampleChannel",
  "broadcasterType": "partner",
  "channelCreatedAt": "2020-01-15T12:00:00Z",
  "isLive": true,
  "isMature": false,
  "streamId": "987654321",
  "streamTitle": "Ranked matches with viewers",
  "categoryId": "27471",
  "category": "Minecraft",
  "viewerCount": 1245,
  "startedAt": "2026-07-20T10:00:00Z",
  "language": "en",
  "tags": ["English", "Survival"],
  "thumbnailUrl": "https://static-cdn.jtvnw.net/previews-ttv/live_user_examplechannel-440x248.jpg",
  "profileImageUrl": "https://static-cdn.jtvnw.net/jtv_user_pictures/example-profile.png",
  "offlineImageUrl": "https://static-cdn.jtvnw.net/jtv_user_pictures/example-offline.png",
  "followersText": null,
  "followersCount": null,
  "channelDescription": "Public Twitch channel description.",
  "recentVideos": [
    {
      "id": "2468013579",
      "title": "Recent broadcast",
      "url": "https://www.twitch.tv/videos/2468013579",
      "viewCount": 4321,
      "duration": "2h14m8s"
    }
  ],
  "topClips": [
    {
      "id": "InterestingClipSlug",
      "title": "Top play",
      "url": "https://clips.twitch.tv/InterestingClipSlug",
      "viewCount": 9800,
      "durationSeconds": 28.4
    }
  ],
  "schedule": {
    "segments": [{ "id": "segment-1", "startTime": "2026-09-02T10:00:00Z", "endTime": "2026-09-02T12:00:00Z", "title": "Morning show", "category": "Minecraft", "isRecurring": true }],
    "vacation": null
  },
  "warnings": [],
  "sourceType": "category",
  "sourceValue": "Minecraft",
  "scrapedAt": "2026-07-20T11:00:00.000Z"
}

Field	Description
url, channelId, channelName, displayName	Canonical URL plus stable and human-readable channel identity.
broadcasterType, channelCreatedAt	Partner/affiliate type and account creation time when returned.
isLive, isMature, streamId, streamTitle	Current live status and stream identity.
categoryId, category, viewerCount, startedAt	Current game/category and live audience metrics.
language, tags	Public stream or channel classification metadata.
thumbnailUrl, profileImageUrl, offlineImageUrl	Public stream preview and channel imagery.
channelDescription	Public channel biography.
followersText, followersCount	Compatibility keys. They are null without broadcaster-authorized follower access.
recentVideos	Optional nested VOD metadata: IDs, titles (including an empty title when Twitch returns one), dates, URLs, views, language, type, duration, and Twitch-reported visibility (viewable).
topClips	Optional nested clip metadata: IDs, URLs, titles, creators, views, timestamps, duration, and VOD offset.
schedule	Optional bounded public schedule: upcoming segment IDs, times, titles, categories, recurrence, and any vacation window. Present only when includeSchedule is enabled.
warnings	Row-specific non-fatal enrichment or limit warnings.
sourceType, sourceValue, scrapedAt	Provenance and collection time.

The default key-value store also contains RUN_SUMMARY and PENDING_WORK. These records report target failures, warnings, processed work, deadline state, and the latest idempotent cursor checkpoint without adding paid dataset rows.

Download your results

Open your run's dataset, choose Export and select JSON, CSV or Excel. JSON keeps nested fields together. CSV and Excel are useful when you want to review the records in a spreadsheet.

See Apify's download and export guide for the available formats and field options.

Pricing

A valid run charges one start event after Twitch application authentication, followed by one item event for each saved stream or channel row. Optional VODs, clips and schedules stay inside their paid parent row and create no separate result events. Failed targets and unsaved enrichment do not create item charges. An empty run that reaches extraction can still have its start charge.

Use a small channel cap and a small optional-enrichment cap to control work. Apify platform usage can also apply. See the live Apify Pricing tab for current rates.

Tips for best results

• Choose exact Twitch category names. Keep category and source metadata with each sample.
• Keep enrichment bounded. Set small channel and enriched-channel caps before enabling VODs, clips or schedules.
• Select live-only discovery deliberately. Set offline inclusion false when offline profiles are not useful.
• Keep stable IDs with snapshots. Multiple sources share a global cap and deduplicate by Twitch channel identity.
• Inspect summary warnings. An empty nested list can reflect unavailable optional metadata rather than a complete content inventory.

Limits and caveats

• The Actor exports public metadata through an authorized Twitch application. It does not collect Twitch passwords, cookies, chat history, subscriptions, messages, or private account data.
• Twitch follower totals require qualifying broadcaster/moderator authorization. The compatibility fields followersCount and followersText therefore remain null for ordinary public lookups.
• Recent VOD and clip arrays may be empty when a channel has no public content or Twitch does not return it.
• Viewer counts and live state are point-in-time values and can change immediately after collection.

Completed no-match lookups succeed with an empty dataset and a summary reason. Authorization, storage, billing and extraction failures remain failures. If a target or requested enrichment fails, useful rows from the rest of the run remain available. Inspect summary and row warnings before using an incomplete result.

The channel and enrichment caps bound the requested output. Work that cannot finish within the deadline is reported as incomplete, rather than silently marked complete.

Automation and integrations

Save your settings for next time

Once you have an input that works for you, save it as an Apify task. This keeps your settings together so you can use them again without filling in the form from scratch.

Run on a schedule

Need fresh results regularly? You can schedule the Actor or a saved task to run at a time that suits you.

Each scheduled run collects the data again. If you want to compare results or highlight changes, add that step in your own workflow.

Send results to your other tools

Use n8n, Make or Zapier to connect this scraper to the rest of your workflow. For example, you could pass its results to an AI assistant or add records to a spreadsheet. Follow the Apify integration guides for your chosen tool.

For a custom connection, an Apify webhook can notify your app when a run finishes or fails. Your app can then fetch the results or handle the failure.

API usage

Want to collect this data from your own app or automation? The examples below send input to the scraper and show how to collect its results.

The Node.js and Python examples wait for the run to finish before reading its results. The cURL example starts the run and returns its details. Wait for that run to finish, then use its defaultDatasetId to fetch the results.

For setup instructions, see Apify's JavaScript client guide, Python client guide and Actor runs API reference.

cURL

curl -X POST "https://api.apify.com/v2/acts/fetch_cat~twitch-streams-channels-scraper/runs?token=YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"categories":["Minecraft"],"includeVideos":true,"includeClips":true,"maxItems":50}'

Node.js

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: process.env.APIFY_TOKEN });
const run = await client.actor('fetch_cat/twitch-streams-channels-scraper').call({
  categories: ['Minecraft'],
  includeVideos: true,
  includeClips: true,
  maxItems: 50,
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

Python

from apify_client import ApifyClient

client = ApifyClient('YOUR_TOKEN')
run = client.actor('fetch_cat/twitch-streams-channels-scraper').call(run_input={
    'categories': ['Minecraft'],
    'includeVideos': True,
    'includeClips': True,
    'maxItems': 50,
})
items = client.dataset(run['defaultDatasetId']).list_items().items
print(items)

MCP and AI agents

You can ask your AI assistant to collect data with Twitch Streams & Channels Scraper and help you work with the results. The scraper returns the data, and your assistant can then summarize it, compare records or prepare notes.

Connect your assistant through the Apify MCP server. MCP gives your assistant a way to find this scraper, run it and read the results. Follow the official setup and sign-in guide for your app.

Easier setup with an Apify plugin

If you use a supported coding assistant, the official Apify plugin can set up the connection for you. It connects your assistant to Apify and includes instructions for common tasks. Follow the guide for your particular app.

Use Apify AI in Console

Prefer to keep everything in Apify? Open Apify AI in Console and ask it to find Fetch Cat's Twitch Streams & Channels Scraper. You can describe the data you want and ask questions about the results.

Apify AI is currently in beta. It asks for confirmation before starting an Actor, and normal run charges apply.

Choose your assistant

• Claude and Claude Code (Anthropic): Apify setup guide.
• ChatGPT and Codex (OpenAI): Apify setup guides.
• Grok Bot (xAI): Apify plugin guide.
• Gemini CLI (Google): MCP server setup guide. Use the server URL below with the HTTP configuration supported by Gemini CLI.

Connect just this scraper

To keep your setup focused on this scraper, add this server configuration to a compatible MCP client:

{
  "mcpServers": {
    "apify": {
      "url": "https://mcp.apify.com?tools=fetch_cat/twitch-streams-channels-scraper"
    }
  }
}

Sign in to Apify when your client asks. If your client uses a Bearer token instead, follow its setup guide and keep the token in its secure configuration. Configuration formats vary by app, so use the linked guide if your client needs a different format.

Use Apify's general server

Already connected to the general Apify MCP server at https://mcp.apify.com? You can use it to find this scraper without adding another server. Ask your assistant to use Twitch Streams & Channels Scraper by Fetch Cat, or give it the identifier fetch_cat/twitch-streams-channels-scraper.

Your assistant can check the available settings and retrieve the results from the returned run. If the run is still working, it should follow that run rather than start it again. Both connection options use Apify's hosted service.

Example requests

• “Use Fetch Cat’s Twitch Streams & Channels Scraper to collect up to 5 live Minecraft channels without optional content enrichment. Keep stable channel IDs, current viewers, category and collection times without estimating total audience.”
• “Collect up to 5 live or offline channels matching vtuber, with recent VODs and clips limited to the first 3 channels and at most 2 of each per channel. Show source links and available metadata without downloading video.”
• “Retrieve up to 5 current Just Chatting channel rows with schedules enabled for no more than 3 channels and at most 2 schedule segments each. Keep time zones and collection times, without creating a recurring schedule or promising every broadcast.”

Normal Apify charges apply. Check the live Pricing tab before asking your assistant to run a larger batch.

Pay with x402

If your AI agent has a funded wallet, it can pay for Apify usage through x402. This experimental option lets an agent use Apify without a conventional account.

Apify AGI provides a prepaid API token with a spending cap after payment. Your agent can use that token to run this scraper through the Apify API or an authenticated MCP connection.

Some MCP setups also support paying for each request directly. That is a different payment option, so check the official guide for its availability.

Follow the official guide for wallet setup, supported payment options and current terms. Apify handles the payments. Keep wallet keys and payment tokens in your agent's secure configuration.

Other ways for agents to pay

Apify also supports MPP for prepaid access through AGI and Skyfire for eligible Actors. If your agent already uses one of these, see the agentic payment guide to choose the right setup.

FAQ

Do users need a Twitch account or API key?

No. The Actor operator supplies an authorized Twitch application. Run inputs never ask customers for Twitch credentials, login cookies, or access tokens.

Can it export Twitch clips, VODs, and schedules?

Yes. Enable includeClips, includeVideos, or includeSchedule. All selected metadata is nested in each channel row. The Actor does not download media files.

Why are follower counts null?

Twitch restricts follower totals to qualifying broadcaster/moderator authorization. The Actor does not collect that user authorization, so it avoids presenting an unsupported or stale total.

When does an empty dataset succeed?

A completed lookup with no matching public channels succeeds and explains the result in the run summary. Missing schedules also return an empty schedule. Authorization errors, failed extraction and unfinished requested work still fail, even if other channel rows were saved.

Can I export to CSV, Excel, JSON, or an API?

Yes. Apify datasets support CSV, Excel, JSON, XML, RSS, HTML table, API access, webhooks, and integrations.

Can I monitor Twitch channels on a schedule?

Yes. Use Apify schedules and stable channel IDs to compare viewer counts, live state, stream titles, and categories over time.

Related Actors

• YouTube Channel Videos Scraper — Collect recent public YouTube channel video metadata, without promising a complete historical archive.
• YouTube Video Details Scraper — Collect public YouTube video metadata and available engagement from known video URLs.
• TikTok Profile Scraper — Collect available public TikTok profile details and video metadata.
• Instagram Profile Posts Scraper — Collect public Instagram profile details and available post metadata.
• YouTube Search Results Scraper — Collect public YouTube search-result metadata for supported video, channel or playlist searches.

Support and feedback

For custom additions or integrations, email hello@fetchcat.dev.

Found an error or have a feature request? Open an issue with the run URL, a non-sensitive input example and what you expected.

Need help sharing it? See Apify’s guide to sharing a run when reporting an issue. Sharing a run can give the developer access to its input, logs and results, so use a run that contains no sensitive data. Please leave out API tokens, passwords, cookies, private documents and personal data. Use a public sample URL or a redacted example instead.

Tried this scraper? We'd love to hear how it worked for you. Leave a review to help others choose the right tool and help us improve it. Your feedback means a lot to us.

Made with care for curious people, AI agents and the possibilities in data. ♥