Twitch Stream Schedules

📺 Plan Twitch streams before they start

For streamers, esports teams, creator researchers, and developers, Twitch Stream Schedules collects public Twitch channel details, live status, and upcoming broadcasts. Choose channel names or search terms, set a future window, and get schedule data with public links and the time it was observed.

Use it to:

• Check Twitch Channel Details for public profile fields, follower counts, tags, and the channel link.
• Find public channels with Twitch Channel Search and see the submitted value that led to each saved row.
• Check Twitch Live Status to see whether a channel was live when its public data was observed.
• Plan Upcoming Twitch Streams with broadcast times, titles, categories, and public Twitch links.
• Review a Twitch Channel Schedule for a chosen channel and future planning window.

📊 Twitch channel profiles and schedules

Each saved row describes one public Twitch channel. It includes channel identity and profile details, live status, current broadcast data when live, upcoming broadcasts, the schedule status, the submitted value that led to the row when known, and the time the data was observed.

Schedule entries include a source ID and public Twitch schedule link when Twitch provides them. A noUpcomingBroadcasts status means the selected window had no public upcoming broadcasts. It is a valid result, not a failed collection.

▶️ Check live status and plan broadcasts

Choose one target

Set target to channels to inspect named public channels, or set it to search to find public channels with search terms. Use one target type in a run.

Add targets

Enter one or more Twitch channel login names for channels, or one or more words or phrases for search. The saved discoveredBy object shows which submitted value led to a row when that value is known.

Set a window

Use scheduleWindowDays to choose how many days ahead to include upcoming broadcasts. The value must be at least 1. Live status and public channel details are included with the result.

⚙️ Input

Choose a target type and fill in only the fields for that type. No Twitch login or API key is needed.

Input fields

Field	Type	What it does
target	choice	Select channels to inspect named channels or search to find public channels.
channels	list of strings	Public Twitch channel login names to inspect when target is channels. Each name may contain 1 to 25 letters, numbers, or underscores.
searchTerms	list of strings	Words or phrases used to find public Twitch channels when target is search.
scheduleWindowDays	integer	Number of days ahead to include upcoming broadcasts. It must be 1 or more. Live status and public channel details are always included.

Example default input

A successful default run used this input:

{
  "target": "channels",
  "channels": [
    "twitchdev"
  ],
  "scheduleWindowDays": 7
}

Input notes

Use channels for a list of known public channel login names. Use searchTerms when you want to discover public channels from words or phrases. The two lists are separate target modes, so fill in only the list that matches target.

🧾 Output

The results output field links to the default dataset in Apify. Each dataset row uses one channel shape, with optional fields for a current stream, language, discovery details, and schedule values that Twitch may not provide.

Dataset row fields

Field	Type	What it does
channel	object	Public Twitch channel details.
channel.id	string	Stable public Twitch ID for the channel.
channel.login	string	Channel login name used by Twitch.
channel.displayName	string	Name shown on Twitch.
channel.url	URL	Public Twitch page for the channel.
channel.description	string	Public channel description, when provided.
channel.followerCount	integer	Number of public channel followers, when provided.
channel.isPartner	boolean	Whether Twitch marks the channel as a Partner, when provided.
channel.language	string	Main language reported for the channel, when provided.
channel.tags	array of strings	Public tags assigned to the channel.
isLive	boolean	Whether the channel was live when the data was observed.
currentStream	object, when live	Details about the current broadcast when the channel is live.
currentStream.id	string	Stable public Twitch ID for the current broadcast.
currentStream.title	string	Title of the current broadcast.
currentStream.category	string	Twitch category for the current broadcast.
currentStream.startedAt	date-time	Time when the current broadcast started.
currentStream.viewerCount	integer	Public viewer count for the current broadcast.
schedules	array of objects	Upcoming public broadcasts within the requested window.
schedules[].id	string	Stable public Twitch ID for a scheduled broadcast.
schedules[].title	string	Title of the scheduled broadcast.
schedules[].category	string	Twitch category for the scheduled broadcast.
schedules[].startTime	date-time	Planned start time for the broadcast.
schedules[].endTime	date-time	Planned end time when Twitch provides it.
schedules[].url	URL	Public Twitch location for the scheduled broadcast when provided.
scheduleStatus	choice	available when upcoming broadcasts were found, or noUpcomingBroadcasts when none were found in the window.
discoveredBy	object, when known	Submitted channel name or search term that led to the row.
discoveredBy.type	choice	channel for a channel name or searchTerm for a search term.
discoveredBy.value	string	The single submitted value that led to the row.
observedAt	date-time	Time when the public Twitch information was observed.

Example scheduled channel row

This complete row shows a channel with two upcoming broadcasts:

{
  "channel": {
    "id": "137512364",
    "login": "ow_esports",
    "displayName": "ow_esports",
    "url": "https://www.twitch.tv/ow_esports",
    "description": "The official home of Overwatch Esports on Twitch.",
    "followerCount": 2461085,
    "isPartner": true,
    "tags": []
  },
  "isLive": false,
  "schedules": [
    {
      "id": "eyJzZWdtZW50SUQiOiI0ZTE5MTEzYS1jNzVhLTQyNzItOTkwMS1kMWRmYzNhNzVhMWUiLCJpc29ZZWFyIjoyMDI2LCJpc29XZWVrIjozNH0=",
      "title": "[DROPS][REBROADCAST] OWWC 2026 Group Stage Day 3",
      "category": "Overwatch",
      "startTime": "2026-08-22T16:00:00Z",
      "url": "https://www.twitch.tv/ow_esports/schedule?segmentID=eyJzZWdtZW50SUQiOiI0ZTE5MTEzYS1jNzVhLTQyNzItOTkwMS1kMWRmYzNhNzVhMWUiLCJpc29ZZWFyIjoyMDI2LCJpc29XZWVrIjozNH0%3D"
    },
    {
      "id": "eyJzZWdtZW50SUQiOiJjMGM5YWU4Zi1jNTllLTQ2YjEtOTc5NS1lNmE5MDk0YzdjZjUiLCJpc29ZZWFyIjoyMDI2LCJpc29XZWVrIjozNH0=",
      "title": "[DROPS] Overwatch World Cup 2026 | Group Stage Day 4",
      "category": "Overwatch",
      "startTime": "2026-08-23T01:30:00Z",
      "url": "https://www.twitch.tv/ow_esports/schedule?segmentID=eyJzZWdtZW50SUQiOiJjMGM5YWU4Zi1jNTllLTQ2YjEtOTc5NS1lNmE5MDk0YzdjZjUiLCJpc29ZZWFyIjoyMDI2LCJpc29XZWVrIjozNH0%3D"
    }
  ],
  "scheduleStatus": "available",
  "discoveredBy": {
    "type": "channel",
    "value": "ow_esports"
  },
  "observedAt": "2026-08-22T15:42:30.206Z"
}

Example live channel row

This complete row shows live status and current broadcast data:

{
  "channel": {
    "id": "69031635",
    "login": "speedrun",
    "displayName": "Speedrun",
    "url": "https://www.twitch.tv/speedrun",
    "description": "Home of Speedrun Summits & 24/7 World Records!",
    "followerCount": 141289,
    "isPartner": true,
    "language": "EN",
    "tags": []
  },
  "isLive": true,
  "schedules": [],
  "scheduleStatus": "noUpcomingBroadcasts",
  "discoveredBy": {
    "type": "searchTerm",
    "value": "speedrunning"
  },
  "observedAt": "2026-08-22T15:42:26.044Z",
  "currentStream": {
    "title": "World Record Speedruns 24/7 | 120 Star in 1:36:48 by @Karinpune",
    "id": "317945673688",
    "category": "Super Mario 64",
    "startedAt": "2026-08-22T04:14:23Z",
    "viewerCount": 44
  }
}

Example no-upcoming row

This complete row shows a valid channel result with no upcoming broadcasts in the selected window:

{
  "channel": {
    "id": "141981764",
    "login": "twitchdev",
    "displayName": "TwitchDev",
    "url": "https://www.twitch.tv/twitchdev",
    "description": "Supporting third-party developers building Twitch integrations from chatbots to game integrations.",
    "followerCount": 33591,
    "isPartner": true,
    "tags": []
  },
  "isLive": false,
  "schedules": [],
  "scheduleStatus": "noUpcomingBroadcasts",
  "discoveredBy": {
    "type": "channel",
    "value": "twitchdev"
  },
  "observedAt": "2026-08-22T15:41:11.975Z"
}

💳 Pricing

Charged event

The twitch-scheduled-broadcast event costs $0.005 for each public upcoming broadcast saved to the dataset. Channel details and live status are returned with a channel row and are not separate charged events. If no upcoming broadcasts are found for the selected window, schedules is empty and no broadcast is saved.

🔌 Integrations

Open the dataset from the results link in Apify Console, or fetch its items with the Apify API. Export the saved rows for your own planner, report, or data workflow.

❓ FAQ

What does no upcoming broadcasts mean?

It means Twitch returned no public broadcasts in the selected schedule window for that channel. The row can still include channel details and live status.

Does the Actor send alerts when a channel goes live?

No. It reports live status at the time of collection. Run it again when you need a fresh observation.

Can I find channels with a search term?

Yes. Set target to search and add one or more searchTerms. When a channel is saved, discoveredBy can show the search term that led to that row.

Can I choose how far ahead to look?

Yes. Set scheduleWindowDays to the number of days ahead you want to include. The value must be 1 or more.

Do I need a Twitch login or API key?

No. The Actor collects the public Twitch information exposed for the selected channels and search terms without a customer-provided login or API key.

Does it collect past broadcasts, clips, or chat?

No. It collects public channel details, live status, and upcoming schedules. It does not reconstruct past schedules or collect VODs, clips, or chat.

📝 Changelog

0.0: Initial release

🆘 Support

For issues, questions, or feature requests, file a ticket and I'll fix or implement it in less than 24h 🫡

🔗 Related Actors

• Twitch Scraper - Use it for broader public Twitch profile, live stream, game, clip, and VOD data.
• Twitch Chat Scraper - Collect public chat messages from live channels or VODs when chat context is the next part of your review.
• Twitch Channel Scraper - Use it for wider channel details that include live streams, videos, clips, and upcoming schedules.
• Twitch Search & Streams Scraper - Search Twitch channels and live streams when you need broader stream discovery.
• Twitch Live Streams Scraper - Collect live Twitch streams by game category, language, or a global view.

Made with ❤️ by Maxime Dupré