Skip to main content

​
Coverage

A Watch on Youtube polls either a search or a channel’s uploads — provide query or channel (handle or id), not both. Both at once returns 400. Interval: 60–86400 seconds. Cap: 20 active Watches per Account. Each tick costs 5 credits — see Credits. Optional gl selects the content region (default US). hl is fixed to en and is not a public parameter.

​
What an event carries

The first tick establishes a silent baseline and emits nothing. Later ticks emit video.created with the full video object. webhook_url is optional — without it the Watch still records every match, readable through GET /v1/youtube/watches/{id}/events. See Webhooks.
The event feed is cursor-paginated: pass the opaque nextCursor back unchanged on the next request.

​
Limits

Comments, captions and transcripts are not Watch criteria — a Watch tracks what is published, on a search or a channel. A video that is deleted or made private after capture keeps its recorded event.