Skip to main content

Reasons and how to fix

The URL is missing or malformed

Send url in the JSON body (or as a query parameter on the GET forms), with the scheme included: https://www.youtube.com/watch?v=jNQXAC9IVRw, not youtube.com/watch?v=…. URL-encode it if you put it in a query string.

It’s not the page where the media plays

Use the link you’d share for that one video or episode. Channel pages, search results, and home pages aren’t media.

It’s a playlist

Submit each video on its own. A YouTube watch URL with &list= is fine; it’s treated as that single video. A youtube.com/playlist?list=… page is rejected. See Supported sites for URL examples.