YouTube Channel Upload Watch — nur neue Videos

A youtube channel monitor that watches your channelIds and outputs only new uploads via YouTube Data API v3 (channels.list contentDetails.relatedPlaylists.uploads, then playlistItems.list). Not a full dump, not search.list, and it does not run without your own API key.

Category: Videos · Tags: youtube, channel, upload, monitor, data-api

Opportunity: OPP-08. generatedBy: Grok Bot BUILDER, version 0.1

Agentur: 15 Kanäle, nur neue Uploads

Paste up to 15 UC channel IDs. Each poll reads the uploads playlist (latest 50 items, not a catalog dump). Only videos that were not seen in a previous run are written to the dataset. First sight of a channel seeds a baseline in KV (no new_video charge) so you do not get a historical dump.

Brand-Monitor: Diff seit letztem Run

Seen video IDs persist in the default key-value store under SEEN_VIDEO_IDS. Schedule the Actor: each run diffs against the last poll and emits only new uploads as { channelId, videoId, title, url, publishedAt, views? }. Empty poll = start only (no new_video events).

Agent-Poll mit eigenem Key

Call from an agent on a schedule with your own youtubeApiKey. Set dryRun true to skip Actor.charge while still calling Data API v3. Without a key the Actor fails (see below). Concurrency is low (sequential channel polls).

API key in 2 minutes

This Actor cannot run without your own key.

1. Open Google Cloud
2. Enable YouTube Data API v3
3. Credentials -> API key
4. Paste the key as youtubeApiKey

If youtubeApiKey is missing or rejected, the Actor fails with that instruction. AUTH_NEEDED: a live YouTube poll is impossible in this environment without a real user key. Unit tests cover parsers, dedup, and billing only.

Input

Required:

• channelIds: string array of UC… IDs (or youtube.com/channel/UC… URLs). Max 15. Handles / search.list are not supported.
• youtubeApiKey: your YouTube Data API v3 key

Optional: maxNewVideos (default 50), costCapUsd (default 1.0), dryRun, seenStoreKey.

Output (dataset)

Only new videos (never a full dump):

• channelId, videoId, title, url, publishedAt, optional views

Run summary is stored as key-value OUTPUT. Dedup state: SEEN_VIDEO_IDS.

Pricing (PPE)

• Event start: $0.00005 once per completed poll (including empty)
• Event new_video: $0.01 per newly seen upload pushed
• Empty poll = start only. Do not charge new_video on empty or on baseline seed.
• dryRun true skips Actor.charge
• costCapUsd default 1.0 (hard max 5.0)

Limitations

• Own YouTube Data API v3 key required (AUTH_NEEDED without it)
• Latest 50 uploads per channel per poll — not a full dump
• No search.list, no handle lookup, no keyless run
• Private/deleted playlist items are skipped
• views is best-effort via videos.list statistics
• Respect YouTube API Terms and quota (key owner pays Google quota)

generatedBy: Grok Bot BUILDER, version 0.1