Check If a YouTube Video Can Be Embedded
Open youtube.com/oembed?url= followed by the video's watch address: in Vi.ki's test on Nov 21, 2026 it answered 200 with the embed code when the video embeds, 401 Unauthorized when its owner turned embedding off, 403 Forbidden for a private video and 404 Not Found for no such video. An age-restricted video still answered 200, though it will not play on other sites.
To check whether a YouTube video can be embedded before you put it on a page, open https://www.youtube.com/oembed?url=https://www.youtube.com/watch?v=VIDEO_ID&format=json in a browser: 200 with a block of text that includes an <iframe> means it embeds, 401 Unauthorized means its owner turned embedding off, 403 Forbidden means the video is private, and 404 Not Found means there is no public video with that ID. For "Me at the zoo" the address is https://www.youtube.com/oembed?url=https://www.youtube.com/watch?v=jNQXAC9IVRw&format=json, which answered 200 with the video's title and embed code when Vi.ki opened it on Nov 21, 2026. One case slips through: an age-restricted video answers 200 too, yet will not play on another site, so it needs the second check below.
Next: get the embed code and turn embedding on or off for your own video, size the player for a vertical Short or what else the same oEmbed answer gives you.
What each answer means
Every row is a request Vi.ki made signed out on Nov 21, 2026. The videos are ones a Vi.ki viki had found blocked on its own pages.
| Video | oEmbed answer | What it means |
|---|---|---|
"Me at the zoo", jNQXAC9IVRw |
200, with title and iframe | Embeds |
A YouTube Short, 0HAETg7L15o |
200 | Embeds (sized vertical for a /shorts/ link: Embed a YouTube Short) |
Lofi Girl's live stream, 4t4AQ15yj1M |
200 | Embeds |
Neuralink's "Neuralink Launch Event", r-vbh3t7WVI |
401 Unauthorized | The owner switched embedding off |
RidleyFox's "Valheim Troll Slaying 101", Wwn5P8a46JM |
401 Unauthorized | The owner switched embedding off |
A private ArcheAge Chronicles trailer, E12uscaQvSA |
403 Forbidden | Private: only the owner and people they invite can watch it |
Rockstar Games' "Grand Theft Auto VI: An Extended Look", tJbzMqJGH4k |
200 | Looks fine, but is age-restricted |
Diablo's "Diablo V Teaser", GxCN_AKYtts |
200 | Looks fine, but is age-restricted |
AAAAAAAAAAA, an ID nobody uploaded |
404 Not Found | No such public video |
abc, not an ID |
400 Bad Request | Not a video address at all |
A 401 is the one to act on: the video plays on YouTube, but an embed of it shows, in K.M. Robinson's words below, a black screen saying the owner "has disabled the ability to play back on a website". Only the owner can change that (YouTube Embeds has the Studio steps), so pick another upload of the same thing or link to the video instead.
The age restriction check
YouTube Help says age-restricted videos "generally can't be watched on third-party websites" (Embed videos & playlists, read Nov 21, 2026), and oEmbed does not tell you which they are. The video's own watch page does. From a terminal:
curl -s -H "Accept-Language: en-US" "https://www.youtube.com/watch?v=tJbzMqJGH4k" | grep -o "Sign in to confirm your age\|\"playableInEmbed\":[a-z]*"
On Nov 21, 2026 that printed Sign in to confirm your age for both age-restricted trailers in the table; for "Me at the zoo" it printed "playableInEmbed":true, and for Neuralink's event "playableInEmbed":false, the same verdict as its 401. So the watch page alone settles all three cases, and the oEmbed address is the quick one you can open in a browser tab. Why a video is age-restricted, and what that changes, is on Age Restriction.
Turning it on for your own video
K.M. Robinson, a social media educator, showed the owner's side in an Apr 7, 2022 video: open the video in Studio, scroll far down past the thumbnail and captions to License and distribution, and tick Allow embedding; untick it and other sites get a black box. Help names the same setting, Allow embedding in YouTube Studio (Embed videos & playlists); the clicks in today's Studio are on YouTube Embeds. After saving, the oEmbed address above should turn from 401 to 200.
Other reasons an embed fails
A video can pass both checks and still not play in a frame. Help names one: a page that sends no HTTP Referer gets error 153. The other common one is a video blocked in the viewer's country, which a request from one country cannot see; Block a Video by Country explains how creators set it.
TutorialDeck's Oct 19, 2026 demonstration finds the error 153 cause in the frame's own code: the iframe's referrerpolicy was set to no-referrer, so the browser sent no Referer and YouTube, which needs it to recognize the embedding page, refused with "video player configuration error". Changing the value to strict-origin-when-cross-origin and running the page again brought the player back.
What we think
We think the oEmbed address will still answer 401 for a video with embedding switched off a year from now. Embed tools and website builders read that code to show a "this video can't be embedded" message before a page is published, so changing it would break them quietly.
Confidence: Likely. Check by: Nov 21, 2027.
How we will check: request the oEmbed address for r-vbh3t7WVI and jNQXAC9IVRw signed out and compare the status codes, after confirming on the first video's watch page that "playableInEmbed" is still false.
Sources
- Embed videos & playlists, YouTube Help, read Nov 21, 2026
- How To Fix YouTube Video Playback Disabled On Other Websites By The Video Owner (On-Screen Tutorial), K.M. Robinson, Apr 7, 2022 (video)
- Vi.ki's requests to youtube.com/oembed and to the watch pages of the ten videos and IDs in the table, signed out, Nov 21, 2026
- How to Fix YouTube Embed Error 153 by Restoring the HTTP Referrer, TutorialDeck, Oct 19, 2026 (video)
Moments
How To Fix YouTube Video Playback Disabled On Other Websites By The Video Owner (On-Screen Tutorial)
K.M. Robinson, social media educator and speaker
How to Fix YouTube Embed Error 153 by Restoring the HTTP Referrer
TutorialDeck
See also
-
YouTube EmbedsTo embed a YouTube video, click Share under it, then Embed, and paste the HTML code into your site; swap youtube.com for youtube-nocookie.com for privacy-enhanced mode, add ?start= to begin at a second, and creators can stop others embedding by unticking Allow embedding in YouTube Studio.
-
Embed a YouTube ShortA YouTube Short embeds like any video, at youtube.com/embed/ followed by its ID, but in a tall frame: width 315 and height 560 keep it 9:16. YouTube's own oEmbed answer for a /shorts/ address, read Nov 21, 2026, gave a vertical 113 by 200 frame, and the same video asked for by its watch address a horizontal one.
-
Video Title Without an API KeyThe address youtube.com/oembed?url= followed by a video's link and &format=json returns the video's title, channel name, channel address, thumbnail and embed code as JSON, with no API key and no sign-in. It does not return views, likes, the date or the length.
-
Age RestrictionAn age-restricted YouTube video can only be watched by viewers who are signed in and 18 or older, mostly not on other websites, and it may earn limited or no ads. Creators can restrict their own videos or appeal YouTube's restriction in YouTube Studio.
-
Block a Video by CountryAn ordinary YouTube channel cannot block its own video in chosen countries. The setting exists only in Studio Content Manager, the tool of networks and rights holders, and it is built for licensing, not for hiding from an audience.
-
Channel Membership Join LinkA YouTube channel's membership link is its address with /join added, such as youtube.com/@LofiGirl/join, which YouTube Help says links "directly to your membership window". It works after a handle or a channel ID; in Vi.ki's test on Nov 19, 2026 a channel without memberships answered the same address with its plain channel page.