YouTube Embed Availability in a Music-Video Catalog
A catalog entry can look fine on paper and still fail when a listener presses play. This page publishes how much of our catalog YouTube itself reports as unavailable for embedding (deleted, private, embedding switched off, or blocked in every country), with the method and the date attached.
YouTube Data API status
0.8% (103 of 12,527) could not be embedded
On , of the 12,527 catalog videos checked, 103 were deleted, private, embedding switched off, or blocked in every country, according to the YouTube Data API. Videos an editor removed are left out; videos our own checks hid because they stopped playing are kept in.
Unavailable
- Deleted or removed (not returned by the API): 44
- Private: 0
- Embedding switched off: 2
- Blocked in every country: 57
Available
- Public and embeddable: 12,412
- Unlisted and embeddable: 12
Partial region restrictions, reported separately and not counted as unavailable: 2,359 videos are blocked in some countries and 1,992 are allowed only in listed countries. Most often blocked in: Russia (2,124), Belarus (1,735), North Korea (152), Iran (146), Syria (146).
Method
We took every video in the catalog except those an editor chose to remove, de-duplicated by YouTube id. Videos our own availability checks had already hidden because they stopped playing are kept in, so the figure is not lowered by our own clean-up. We asked the YouTube Data API for each video's status and content details (videos.list, part=status,contentDetails, 50 ids per request). Each id falls into exactly one bucket. Unavailable: not returned by the API (deleted or removed), private, embedding switched off by the uploader, or blocked in every country. Available: unlisted and embeddable, or public and embeddable. Unlisted videos play in an embed, so they count as available. The six counts are checked to sum to the number of ids queried, and the rate is the unavailable count divided by that number. Videos blocked in only some countries are reported separately and are not counted as unavailable, because they still play everywhere else. This is the status YouTube reports for each video. It does not load a player, so it does not see a block that only appears at playback.
An earlier figure on this page (23.8%, July 2026) came from a measurement error on our test network and was withdrawn on 15 November 2026.
Related
- Music video statistics · catalog composition (size, runtime, genres, formats).
- Why Videojam Does Not Host Video · why the embed is the rights framework.