YouTube-Embed-Checker
Einleitung
Der Toollect-YouTube-Embed-Checker beantwortet eine Frage, die sich stellt, sobald jemand Videos auf einer Website einbindet: Wird dieses Video hier, auf meiner Seite, tatsächlich abgespielt? Fügen Sie einen Link ein, und das Tool prüft das Video gegen zwei öffentliche, schlüsselfreie YouTube-Oberflächen – den oEmbed-Endpunkt und den eingebetteten Player – und sagt Ihnen dann, ob das Video einbettbar, abspielbar, nicht mehr vorhanden oder eingeschränkt ist. Kein Konto, kein API-Schlüssel und kein Upload.
Die Falle, die das Tool beseitigt, ist allgemein bekannt. Sie kopieren einen Embed-Code, fügen ihn in Ihre Seite ein und stellen später fest, dass das Video einen grauen Player, einen Platzhalter mit „Video nicht verfügbar" oder eine „Auf YouTube ansehen"-Aufforderung zeigt, weil der Eigentümer das Einbetten deaktiviert hat. Wenn das Embed erst einmal live ist, wird daraus eine Support-Anfrage. Vorher zu prüfen, macht aus derselben Aufgabe einen Zwei-Sekunden-Schritt.
Die Prüfung läuft vollständig in Ihrem Browser. Die URL wird lokal geparst, der Embed-Status wird über den öffentlichen oEmbed-Endpunkt von YouTube abgefragt, und ein Live-Embed lädt auf der Seite, pausiert im ersten Bild – niemals automatisch abgespielt, niemals für Sie stummgeschaltet. Nichts wird hochgeladen, gespeichert oder verfolgt. Das Ergebnis erscheint zusammen mit Titel, Kanal und Dauer des Videos, die das Embed selbst liefert – ohne separate Seite, ohne Scraper, ohne Drittanbieter-Dienst.
So funktioniert es
Das Tool zerlegt die Frage „kann dieses Video eingebettet und abgespielt werden" in drei unabhängige Prüfungen. Jede nutzt eine öffentliche, schlüsselfreie Oberfläche von YouTube, und alle drei laufen lokal in Ihrem Browser.
- Extraktion der Video-ID – die URL wird mit demselben Muster geparst, das auch YouTube verwendet; erkannt werden Watch-Links, youtu.be, Shorts, Embed- und Live-URLs sowie eine reine 11-stellige ID.
- Einbettungsprüfung – das Tool fragt den oEmbed-Endpunkt von YouTube für das Video an. Ein einbettbares Video liefert ein kleines JSON-Objekt; ein Video, dessen Eigentümer das Einbetten verbietet, liefert einen Fehler. Derselbe Endpunkt wird von Diensten genutzt, um Vorschaukarten automatisch zu erzeugen.
- Player-Check – das Tool lädt den eingebetteten Player, pausiert im ersten Bild, und hört auf seinen Status. Wenn das Video entfernt oder eingeschränkt ist, feuert der Player einen Fehlercode; wenn es sauber lädt, liefert der Player selbst Titel, Kanal und Dauer zurück, und ein Druck auf Wiedergabe bestätigt die Abspielung live im selben Frame.
Keiner dieser Schritte erfordert die offizielle YouTube Data API. Das Player-JavaScript lädt bei Bedarf, benötigt kein Kontingent und läuft vollständig in Ihrem Browser – Ihr eingefügter Link erreicht nie einen Server, der von dieser Website kontrolliert wird.
Die beiden öffentlichen Oberflächen im Überblick
Der oEmbed-Endpunkt ist eine öffentliche, schlüsselfreie API von YouTube. Eine einzelne Anfrage wie https://www.youtube.com/oembed?url=https://www.youtube.com/watch?v=dQw4w9WgXcQ&format=json liefert Titel, Kanalname und Vorschaubild-URL des Videos – oder eine klare Ablehnung, wenn das Video nicht eingebettet werden kann. Da es sich um eine leichtgewichtige Statusprüfung handelt, antwortet sie in einem einzigen Roundtrip.
Die Player-Oberfläche ist dieselbe, die Sie nutzen, wenn Sie ein iframe einfügen: YouTube lädt einen kleinen IFrame-Player auf die Seite, und die Statuscodes des Players erzählen den Rest der Geschichte. Ein Player, der sein erstes Bild ohne Fehlercode erreicht, ist der Beleg, dass das Embed das Video akzeptiert hat; ein Player, der einen Fehler auslöst, nennt den Grund – nicht gefunden, entfernt oder einbettungseingeschränkt. Die Vorschau bleibt in diesem ersten Bild pausiert, genau wie ein normales Embed: nichts läuft automatisch, und die Lautstärke ist die, die Sie eingestellt haben.
Anwendungsfälle
Über das Offensichtliche – „ist dieser Link sicher einzufügen" – hinaus passt das Tool in echte Arbeitsabläufe.
Web- und App-Entwicklung
Entwickler, die YouTube-Videos in Dashboards, Landingpages oder Apps einbetten, sehen oft einen Tag nach dem Launch kaputte Embeds. Eine Vorabprüfung beim Content-Import – Sitemap-Generierung, CMS-Import oder Video-Empfehlung – fängt nicht einbettbare und entfernte Videos ab, bevor sie die Nutzer erreichen. Dieselbe oEmbed-Prüfung ist zudem leicht als Einzeiler in einem Build-Skript wiederverwendbar.
Content-Erstellung und Marketing
Redakteure, die Werbeseiten, Newsletter oder Wissensdatenbank-Artikel zusammenstellen, möchten viele Videos verlinken, ohne jedes Embed zu überwachen. Eine schnelle Serie von Prüfungen – eine URL nach der anderen – markiert die Videos, die als kaputte Platzhalter gerendert würden, sodass die Liste sauber veröffentlicht wird.
Recherche und Archiv-Triage
Journalisten, Archivare und Forscher, die die Verfügbarkeit eines Videos über die Zeit verfolgen, können die Prüfung erneut ausführen und das Ergebnis archivieren. Das Muster „war einbettbar, jetzt Fehler 100" ist eine Frühwarnung, dass das Video gelöscht wurde – eine für sich genommen nützliche Tatsache.
Ergebnisse & Fehlercodes
Jedes Ergebnis, das das Tool zeigt, ist die Antwort des Players, übersetzt. Das Ergebnis, das Sie lesen, und der Fehlercode darunter stammen aus derselben Quelle, sodass beide Ebenen nie widersprechen.
Die Ergebnisse:
| Ergebnis | Bedeutung | Typische Ursache |
|---|---|---|
| Abspielbar | Das Embed wurde akzeptiert und hat sein erstes Bild erreicht | Ein gesundes, einbettbares Video |
| Nicht einbettbar | Der Eigentümer verbietet das Einbetten | Fehler 101 oder 150 vom Player |
| Video nicht gefunden | Der Player kann das Video nicht laden | Entfernt oder privat geschaltet, Fehler 100 |
| Video nicht verfügbar | Der Player hat die Anfrage abgelehnt | Ein veralteter oder falscher Link oder ein allgemeiner Player-Fehler |
| Zeitüberschreitung | Keine Antwort des Players innerhalb der Wartezeit | Ein blockiertes Skript oder ein Netzwerkproblem |
Die Fehlercodes:
| Code | Bedeutung | Was er Ihnen sagt |
|---|---|---|
| 100 | Video nicht gefunden | Das Video wurde entfernt oder privat geschaltet, oder die ID ist gültig, aber der Player kann es nicht laden |
| 101 | Einbetten nicht erlaubt | Der Eigentümer hat das Einbetten für dieses Video deaktiviert |
| 150 | Einbetten nicht erlaubt | Dieselbe Einschränkung, auf manchen Oberflächen als 150 gemeldet |
| 2 | Ungültige Anfrage | Das Video ist für den Player nicht verfügbar, meist ein veralteter oder falscher Videolink |
| 5 | Player-Erstellung fehlgeschlagen | Ein allgemeiner HTML5-Player-Fehler, manchmal ein Hinweis auf einen Wiedergabefehler außerhalb des Embeds |
Die Codes 101 und 150 führen zum selben Ergebnis, Nicht einbettbar – „der Eigentümer erlaubt das Einbetten nicht". Ein 100 bedeutet, dass das Video nicht mehr öffentlich verfügbar ist, und führt zu Video nicht gefunden. Die Codes 2 und 5 führen beide zu Video nicht verfügbar. Und ein Player, der über die Wartezeit hinaus schweigt, führt zu Zeitüberschreitung – das Ergebnis, das Sie sehen, wenn ein Skript oder eine Netzwerkregel den Player selbst blockiert. Das sind die Antworten, die Ihnen bei der Prüfung einer Embed-Galerie am häufigsten begegnen.
Was das Tool erkennen kann und was nicht
Ehrlichkeit über die Grenzen ist Teil dessen, was dieses Tool nützlich macht. Die Tabelle zeigt, was die Embed-Pipeline offenlegt – und worüber sie schweigt.
| Frage | Kann das Tool das erkennen? |
|---|---|
| Einbettbar (Eigentümer erlaubt das Einbetten) | Ja, über die oEmbed-Prüfung |
| Spielt nach dem Einbetten tatsächlich ab | Ja – drücken Sie in der Vorschau auf Wiedergabe, und das Tool bestätigt die Abspielung |
| Video entfernt oder privat geschaltet | Ja, Fehler 100 |
| Altersbeschränkte Videos | Meist – der Player wiederholt in manchen Regionen mit einem Zustimmungsschritt |
| Regionale (Länder-)Einschränkungen | Nur die Region, in der Sie sich befinden, und nur für die Player-API-Oberfläche |
| Länder, in denen das Video verfügbar ist | Nein |
| Aufrufzahlen, Likes, Kommentare | Nein |
| Tags, Lizenz, Upload-Datum | Nein |
| Verfügbarkeit von Untertiteln | Nein |
| Standard-Audio-/Videosprache | Nein |
Jede Frage, die das Kern-Ergebnis entscheidet – die Einbettungsprüfung, der Abspielbeleg, das Signal „entfernt oder privat" – wird ohne Schlüssel vollständig beantwortet. Die Anreicherungsebene – Aufrufzahlen, Regionslisten, Tags, Untertitel, Upload-Daten – ist eine andere Geschichte, die unter „Im Vergleich zur offiziellen API" behandelt wird.
Verwendung
Der Arbeitsablauf ist ein interaktives Zwei-Feld-Formular:
- Einen YouTube-Link einfügen – aus der Adressleiste, dem Teilen-Menü oder dem Embed-Bereich des Videos.
- Enter drücken oder auf die Schaltfläche Prüfen klicken.
- Das Ergebnis lesen – ein Badge beschreibt das Ergebnis als Abspielbar, Nicht einbettbar, Video nicht gefunden, Video nicht verfügbar oder Zeitüberschreitung.
- Die Details lesen – das Player-Panel listet Titel, Kanal, Dauer und ID des Videos unter dem Badge auf; die drei Prüfzeilen darunter erklären, wie jede Prüfung ausgegangen ist.
Das Einfügen allein löst die Prüfung nicht aus; sie läuft erst, wenn Sie Prüfen oder Enter drücken. Das hält das Tool vorhersehbar – das Bearbeiten des Feldes verwirft nie plötzlich ein Ergebnis, das Sie gerade ansehen. Wenn die Eingabe keine gültige YouTube-URL ist, erscheint ein Fehler und das Feld wird geleert.
Unterstützte Link-Formate
Die Eingabe akzeptiert dieselben Formate, die auch YouTube selbst verwendet – fügen Sie eines davon ein:
| Format | Beispiel |
|---|---|
| Standard-Watch-Link | youtube.com/watch?v=VIDEO_ID |
| Kurzlink | youtu.be/VIDEO_ID |
| Shorts | youtube.com/shorts/VIDEO_ID |
| Eingebettet | youtube.com/embed/VIDEO_ID |
| Live | youtube.com/live/VIDEO_ID |
| Älterer Video-Pfad | youtube.com/v/VIDEO_ID |
| Reine ID | VIDEO_ID (11 Zeichen) |
Zusätzliche Parameter wie Playlists und Zeitstempel werden automatisch ignoriert.
Schritt-für-Schritt-Anleitung
Führen Sie ein Video von der URL bis zum Ergebnis durch.
Schritt 1 – Einen Link holen. Öffnen Sie ein beliebiges YouTube-Video und kopieren Sie seine URL, zum Beispiel https://www.youtube.com/watch?v=dQw4w9WgXcQ.
Schritt 2 – Einfügen und prüfen. Klicken Sie in das Eingabefeld, fügen Sie ein (Strg+V oder Cmd+V) und drücken Sie Enter. Das Badge wechselt auf Wird geprüft….
Schritt 3 – Das Badge lesen. Innerhalb von etwa zwei Sekunden erscheint ein Ergebnis. Bei einem normalen einbettbaren Upload lautet es Abspielbar, gestützt durch die Prüfzeilen.
Schritt 4 – Mit einem eingeschränkten Video vergleichen. Fügen Sie nun einen Link zu einem Musikvideo ein, dessen Label das Einbetten untersagt – die meisten Major-Label-Musikclips sind gesperrt. Das Ergebnis lautet Nicht einbettbar und die Fehlerzeile zeigt 101. Genau dieser Fehler reproduziert sich als leere graue Box, wenn Sie den Embed-Code manuell einfügen.
Schritt 5 – Die Belege prüfen. Die Prüfzeilen stimmen mit dem Badge überein: Die Embed-Zeile zeigt Blockiert und die Wiedergabezeile zeigt keine Bestätigung, weil der Player fehlgeschlagen ist, bevor Sie auf Wiedergabe drücken konnten. Diese Kombination – Embed abgelehnt, keine Wiedergabe – ist genau das „kein Embed-Panel"-Signal, das Sie auf der YouTube-Seite eines solchen Videos sehen würden.
Das ist der vollständige Kreislauf: einfügen, prüfen, Badge lesen – und wenn das Ergebnis nicht zu einem echten Embed passt, erklären die Prüfzeilen, warum.
Profi-Tipps
- Eine reine Video-ID einfügen. Die Eingabe akzeptiert eine 11-stellige ID auch allein, ohne URL – praktisch, wenn Sie mit einer API-Antwort, einem Datenbank-Export oder einem Kurzlink arbeiten, der nur die ID preisgibt.
- Mit Enter erneut prüfen. Das Bearbeiten des Links im Feld verwirft nie das aktuelle Ergebnis; drücken Sie Enter, wenn die gewünschte URL im Feld steht.
- Die Embed-Schranke automatisieren. Wenn Sie Seiten aus Feeds erzeugen, können Sie denselben oEmbed-Probe per curl abfragen, den auch das Tool nutzt (
https://www.youtube.com/oembed?url=…&format=json), und einen Nicht-200-Status als „dieses Video ablehnen" in Ihrer Pipeline behandeln. - Regionsempfindliche Inhalte aus der Zielregion testen. Wenn Ihr Publikum in einem bestimmten Land sitzt, führen Sie die Prüfung aus diesem Netzwerk heraus aus; der Player spiegelt die Region wider, an die er ausgeliefert wird.
Fehler 100als Änderungssignal behandeln. Ein Video, das einwandfrei geprüft wurde und plötzlich 100 meldet, wurde höchstwahrscheinlich entfernt oder privat geschaltet. Wenn Sie ein Register eingebetteter Videos führen, prüfen Sie sie regelmäßig nach – der Statuswechsel lohnt zu wissen, bevor ein Besucher auf den grauen Player trifft.
Das Video selbst einbetten
Ein Abspielbar-Ergebnis ist das grüne Licht, genau das Embed zu verwenden, das das Tool geprüft hat:
<div style="aspect-ratio: 16 / 9;">
<iframe
src="https://www.youtube-nocookie.com/embed/VIDEO_ID"
width="100%"
height="100%"
frameborder="0"
allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture"
allowfullscreen
loading="lazy"
></iframe>
</div>
- Bevorzugen Sie die
nocookie-Domain.youtube-nocookie.comliefert denselben Player ohne die nicht notwendigen Cookies von YouTube – die datenschutzfreundliche Standardwahl für die meisten Websites. loading="lazy"ist bereits im Snippet enthalten. Es verschiebt das Embed, bis das Video ins Blickfeld scrollt; entfernen Sie es bei einem Hero-Element über dem Falz, dessen Ladezeit zählt.- Achten Sie auf Ihre Content-Security-Policy. Wenn Ihre Website eine CSP ausliefert, ergänzen Sie
frame-src https://www.youtube-nocookie.com(oderhttps://www.youtube.com, falls Sie die reguläre Domain behalten), sonst wird das Embed blockiert, bevor es lädt.
Alternativen
Wie finden Entwickler normalerweise heraus, dass ein Embed kaputt ist? Die Tabelle zeigt die Optionen.
| Methode | Was sie Ihnen sagt | Schlüssel nötig | Abspielbeleg |
|---|---|---|---|
| Embed einfügen, Seite neu laden | Der kaputte Platzhalter, im Nachhinein | Nein | Indirekt, sobald die Seite läuft |
| oEmbed-Einzeiler | Nur der Embed-Status, ohne Fehlercode | Nein | Nein |
| Offizielle Data API | Alles, mit kontingentbasierten Kosten und Server-Schlüssel | Ja | Nein |
| Dieses Tool | Ergebnis + Fehlercode + Live-Embed zum Abspielen | Keiner | Ja – Wiedergabe in der Vorschau drücken |
Die offizielle Data API ist am vollständigsten, erfordert aber einen Schlüssel, läuft serverseitig, um keine Offenlegung zu riskieren, und kostet pro Anfrage Kontingent. Eine einfache Embed-Prüfung mit reinem Code gibt Ihnen weder die Player-Meldungen noch den Abspielbeleg. Ein rohes iframe-Einfügen zeigt Ihnen erst nach dem Veröffentlichen, was dieses Tool sofort vor dem Ausliefern zeigt.
Im Vergleich zur offiziellen API
Die folgende Tabelle vergleicht die beiden ehrlichen Wege für dieselbe Frage: die offizielle YouTube Data API (ein Server, ein Schlüssel, ein Kontingent) gegenüber diesem Tool (nur der Browser, kein Schlüssel, kein Server). Der Vergleich ist der Grund, warum „kein Schlüssel" ein Merkmal und keine Einschränkung ist – der Kompromiss liegt genau bei den Spalten, die für Embeds zählen.
| Funktion | Offizielle Data API | Dieses Tool |
|---|---|---|
| Einbettbarkeitsstatus | über status.embeddable |
oEmbed + Player-Code |
| Abspielbeleg | Indirekt (nur Metadaten) | Direkt – Wiedergabe in der Vorschau drücken |
| Bedeutung der Fehlercodes | Rohcode, ohne Erklärung | In ein Ergebnis übersetzt |
| Regionen-/Länderliste | contentDetails.regionRestriction |
Nur die Region, in der Sie sind |
| Aufrufzahlen, Likes, Kommentare | statistics |
Nicht verfügbar |
| Tags | snippet.tags |
Nicht verfügbar |
| Lizenz | status.license |
Nicht verfügbar |
| Altersbeschränkung | contentDetails.contentRating |
Implizit über den Player, nicht exakt |
| Upload-Datum | snippet.publishedAt |
Nicht verfügbar |
| Benötigte Daten | API-Schlüssel + Server-Proxy | Keine – 100% im Browser |
Die beiden Oberflächen überschneiden sich exakt bei der Kennzahl, die ein Embed entscheidet: wird es in einer Seite abgespielt. Die offizielle API gewinnt bei allem, was für die Analyse zählt – Metadaten, Statistiken, Regionslisten. Das Tool gewinnt bei der endgültigen Antwort: ein Live-Embed, das im Browser lädt, im ersten Bild pausiert, in dem Sie auf Wiedergabe drücken und selbst zuschauen können.
Fehlerbehebung
| Problem | Ursache | Lösung |
|---|---|---|
| Die Antwort bleibt bei „Wird geprüft…" | Der Player- oder oEmbed-Aufruf wurde blockiert (Adblocker, lokales Netzwerk) | Erlauben Sie das Player-Skript für youtube.com oder wiederholen Sie die Prüfung |
| Das Embed bleibt im ersten Bild stehen | Das ist beabsichtigt – die Vorschau spielt nie automatisch ab und lädt den Stream nicht vor | Drücken Sie Wiedergabe; ein pausiertes Embed mit verfügbarem Ton-Symbol ist ein gesundes Embed |
| Ergebnis „Nicht einbettbar", aber die Videoseite spielt normal | Der Eigentümer verbietet Embeds; die Wiedergabe auf der Seite unterscheidet sich vom Einbetten | Bestätigen Sie es: Öffnen Sie im Videobereich Teilen ▸ Einbetten – dort erscheint die Ablehnung ebenfalls |
| Ergebnis „Video nicht gefunden" | Video entfernt, privat gelistet oder regional freigeschaltet | Vergewissern Sie sich zuerst, dass das Video in Ihrem eigenen Browser abspielt |
| Eingabe wird nicht akzeptiert | Die URL ist überhaupt kein YouTube-Format | Verwenden Sie einen Link von der Watch-Seite oder aus dem Teilen-Menü |
Datenschutz & Datenverarbeitung
Das Tool folgt demselben Datenschutzmodell wie die anderen Toollect-Tools: Alles läuft lokal.
- Nichts wird hochgeladen. Die URL wird in Ihrem Browser geparst. Keine Anfrage, die sie enthält, wird an einen Server gesendet, den Sie nicht kontrollieren.
- Kein Konto, kein Tracking. Es gibt kein Login, keine Analytik und keinen Verlauf der Videos, die Sie prüfen.
- Nur Player-Verkehr. Die einzigen Netzwerkanfragen sind die des Players selbst – dieselben Anfragen, die jede Website macht, wenn sie ein Video einbettet. Nichts wird gespeichert, gescreenshottet oder festgehalten.
- Kein Video wird vorab heruntergeladen. Die Vorschau pausiert im ersten Bild mit einem normalen Wiedergabe-Button; der Stream beginnt erst zu laden, wenn Sie auf Wiedergabe drücken – genau wie bei jedem Embed – und nichts wird gespeichert.
Wenn Ihnen der Datenschutz bei der Wahl der geprüften Videos wichtig ist: Diese Seite verhält sich genau wie eine normale Videoseite in Ihrem Browser – Ihr Link geht an nichts anderes als Ihren eigenen Player.
Technische Daten
Details:
- Einbettungsprüfung:
https://www.youtube.com/oembed?url={watch_url}&format=json– HTTP 200 = einbettbar, nicht-200 = eingeschränkt - Player: YouTube IFrame Player API, bei Bedarf geladen als
playsinline-Embed, pausiert im ersten Bild (kein erzwungenes Autoplay, keine erzwungene Stummschaltung) - Ergebnisquellen: oEmbed-Status, Player-Fehlercodes (2, 5, 100, 101, 150) und Live-Wiedergabeereignisse, wenn Sie auf Wiedergabe drücken
- Metadaten: Titel, Kanal, Dauer und Video-ID, vom Player selbst geliefert
- Verarbeitung: 100% clientseitiges JavaScript ohne API-Schlüssel, ohne Uploads, ohne Server
- Browserunterstützung: alle modernen Browser mit Promise- und ES5-Unterstützung (Chrome, Edge, Firefox, Safari)
Funktionen
- Sofortige Prüfung der Einbettbarkeit für jeden eingefügten YouTube-Link
- Live-Einbettungsvorschau, pausiert im ersten Bild – Abspielbestätigung, sobald Sie auf Wiedergabe drücken
- Ergebnisse auf Basis der Fehlercodes des YouTube-Players, mit verständlichen Erklärungen
- Titel, Kanal und Dauer werden angezeigt, ohne eine separate Seite zu öffnen
- 100% Verarbeitung im Browser ohne Datenübertragung, kein API-Schlüssel erforderlich
- Akzeptiert Watch-, Shorts-, Embed-, Live- und youtu.be-Links sowie reine Video-IDs