# Collect upcoming YouTube stream times for a calendar

**Use case:** 

Collect stream listings from known YouTube channels with upcoming flags and scheduled start values when exposed. Select upcoming entries after export and use their links and available times to prepare an event calendar in your own tools.

## Input

```json
{
  "inputList": [
    "NASA"
  ],
  "pagesPerInput": 1
}
```

## Output

```json
{
  "input": {
    "label": "Input",
    "format": "string"
  },
  "status": {
    "label": "Status",
    "format": "string"
  },
  "id": {
    "label": "ID",
    "format": "string"
  },
  "url": {
    "label": "URL",
    "format": "string"
  },
  "type": {
    "label": "Type",
    "format": "string"
  },
  "title": {
    "label": "Title",
    "format": "string"
  },
  "description": {
    "label": "Description",
    "format": "string"
  },
  "thumbnail_url": {
    "label": "Thumbnail URL",
    "format": "string"
  },
  "thumbnails.url": {
    "label": "Thumbnails / URL",
    "format": "array"
  },
  "thumbnails.width": {
    "label": "Thumbnails / Width",
    "format": "array"
  },
  "thumbnails.height": {
    "label": "Thumbnails / Height",
    "format": "array"
  },
  "duration_seconds": {
    "label": "Duration Seconds",
    "format": "integer"
  },
  "duration_text": {
    "label": "Duration Text",
    "format": "string"
  },
  "views": {
    "label": "Views",
    "format": "integer"
  },
  "views_text": {
    "label": "Views Text",
    "format": "string"
  },
  "published_text": {
    "label": "Published Text",
    "format": "string"
  },
  "badges": {
    "label": "Badges",
    "format": "array"
  },
  "is_live": {
    "label": "Is Live",
    "format": "boolean"
  },
  "is_upcoming": {
    "label": "Is Upcoming",
    "format": "boolean"
  },
  "is_premiere": {
    "label": "Is Premiere",
    "format": "boolean"
  },
  "is_members_only": {
    "label": "Is Members Only",
    "format": "boolean"
  },
  "stream_status": {
    "label": "Stream Status",
    "format": "string"
  },
  "scheduled_start_time": {
    "label": "Scheduled Start Time",
    "format": "integer"
  },
  "accessibility_text": {
    "label": "Accessibility Text",
    "format": "string"
  },
  "author.id": {
    "label": "Author / ID",
    "format": "text"
  },
  "author.name": {
    "label": "Author / Name",
    "format": "text"
  },
  "author.handle": {
    "label": "Author / Handle",
    "format": "text"
  },
  "author.url": {
    "label": "Author / URL",
    "format": "link"
  },
  "author.avatar_url": {
    "label": "Author / Avatar URL",
    "format": "image"
  },
  "author.avatar_thumbnails.url": {
    "label": "Author / Avatar Thumbnails / URL",
    "format": "array"
  },
  "author.avatar_thumbnails.width": {
    "label": "Author / Avatar Thumbnails / Width",
    "format": "array"
  },
  "author.avatar_thumbnails.height": {
    "label": "Author / Avatar Thumbnails / Height",
    "format": "array"
  },
  "author.is_verified": {
    "label": "Author / Is Verified",
    "format": "boolean"
  },
  "source_channel.id": {
    "label": "Source Channel / ID",
    "format": "text"
  },
  "source_channel.handle": {
    "label": "Source Channel / Handle",
    "format": "text"
  },
  "source_channel.name": {
    "label": "Source Channel / Name",
    "format": "text"
  },
  "source_channel.url": {
    "label": "Source Channel / URL",
    "format": "link"
  },
  "source_channel.canonical_url": {
    "label": "Source Channel / Canonical URL",
    "format": "link"
  },
  "source_channel.vanity_url": {
    "label": "Source Channel / Vanity URL",
    "format": "link"
  },
  "source_channel.description": {
    "label": "Source Channel / Description",
    "format": "text"
  },
  "source_channel.avatar_url": {
    "label": "Source Channel / Avatar URL",
    "format": "image"
  },
  "source_channel.avatar_thumbnails.url": {
    "label": "Source Channel / Avatar Thumbnails / URL",
    "format": "array"
  },
  "source_channel.avatar_thumbnails.width": {
    "label": "Source Channel / Avatar Thumbnails / Width",
    "format": "array"
  },
  "source_channel.avatar_thumbnails.height": {
    "label": "Source Channel / Avatar Thumbnails / Height",
    "format": "array"
  },
  "source_channel.banner_url": {
    "label": "Source Channel / Banner URL",
    "format": "image"
  },
  "source_channel.banner_thumbnails.url": {
    "label": "Source Channel / Banner Thumbnails / URL",
    "format": "array"
  },
  "source_channel.banner_thumbnails.width": {
    "label": "Source Channel / Banner Thumbnails / Width",
    "format": "array"
  },
  "source_channel.banner_thumbnails.height": {
    "label": "Source Channel / Banner Thumbnails / Height",
    "format": "array"
  },
  "source_channel.subscribers": {
    "label": "Source Channel / Subscribers",
    "format": "number"
  },
  "source_channel.subscribers_text": {
    "label": "Source Channel / Subscribers Text",
    "format": "text"
  },
  "source_channel.videos_count": {
    "label": "Source Channel / Videos Count",
    "format": "number"
  },
  "source_channel.videos_count_text": {
    "label": "Source Channel / Videos Count Text",
    "format": "text"
  },
  "source_channel.views": {
    "label": "Source Channel / Views",
    "format": "number"
  },
  "source_channel.views_text": {
    "label": "Source Channel / Views Text",
    "format": "text"
  },
  "source_channel.country": {
    "label": "Source Channel / Country",
    "format": "text"
  },
  "source_channel.joined_date": {
    "label": "Source Channel / Joined Date",
    "format": "text"
  },
  "source_channel.keywords": {
    "label": "Source Channel / Keywords",
    "format": "array"
  },
  "source_channel.keywords_raw": {
    "label": "Source Channel / Keywords Raw",
    "format": "text"
  },
  "source_channel.external_links.title": {
    "label": "Source Channel / External Links / Title",
    "format": "array"
  },
  "source_channel.external_links.url": {
    "label": "Source Channel / External Links / URL",
    "format": "array"
  },
  "source_channel.external_links.display_url": {
    "label": "Source Channel / External Links / Display URL",
    "format": "array"
  },
  "source_channel.external_links.icon_url": {
    "label": "Source Channel / External Links / Icon URL",
    "format": "array"
  },
  "source_channel.rss_url": {
    "label": "Source Channel / Rss URL",
    "format": "link"
  },
  "source_channel.available_countries": {
    "label": "Source Channel / Available Countries",
    "format": "array"
  },
  "source_channel.is_verified": {
    "label": "Source Channel / Is Verified",
    "format": "boolean"
  },
  "source_channel.is_family_safe": {
    "label": "Source Channel / Is Family Safe",
    "format": "boolean"
  },
  "source_channel.is_subscriber_count_hidden": {
    "label": "Source Channel / Is Subscriber Count Hidden",
    "format": "boolean"
  },
  "position": {
    "label": "Position",
    "format": "integer"
  }
}
```

## About this Actor

This example demonstrates how to use [YouTube Channel Streams – Live, Upcoming & Past](https://apify.com/scrapingmonkey/youtube-channel-streams-scraper.md) with a specific input configuration. Visit the [Actor detail page](https://apify.com/scrapingmonkey/youtube-channel-streams-scraper.md) to learn more, explore other use cases, and run it yourself.


## 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.
This Task's input is already configured above — use it as-is rather than inventing a new one.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For full API examples (JavaScript, Python, CLI, MCP, OpenAPI), see this Task's Actor page: https://apify.com/scrapingmonkey/youtube-channel-streams-scraper.md

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).