Error 153 al insertar un video de YouTube: por qué pasa y cómo arreglarlo

El error 153 aparece cuando el reproductor de YouTube no sabe qué sitio lo insertó porque falta el header Referer. El arreglo para sitios web, WebViews y apps.

Insertás un video de YouTube, el reproductor carga y, en lugar del video, aparece un recuadro negro con el error 153 («Video player configuration error», o su traducción), muchas veces con un link para mirarlo en YouTube. El video está bien y el código de inserción también. Lo que falta es un dato: quién lo está insertando.

La causa: el reproductor no sabe qué sitio lo insertó

Las condiciones para desarrolladores de YouTube son explícitas. Su página Required Minimum Functionality dice que todo lo que use el reproductor insertado, incluida la IFrame Player API, tiene que identificarse con el header HTTP Referer. Los navegadores lo mandan solos; la página pide no usar ajustes que lo supriman y recomienda la política strict-origin-when-cross-origin.

Cuando el reproductor carga sin Referer, o con uno que no identifica un sitio, se niega a reproducir y muestra el error 153. Quienes lo depuraron, como Simon Willison, llegaron justo a eso. La página de Google no menciona el número 153, pero el arreglo que describe es el que hace desaparecer el error.

Qué le saca el Referer a un sitio web

  • Un header Referrer-Policy en no-referrer o same-origin. Algunos frameworks y configuraciones de seguridad lo agregan por defecto; en el caso de Willison era el SecurityMiddleware de Django, que manda same-origin.
  • Una meta etiqueta en el head de la página: <meta name="referrer" content="no-referrer">.
  • Un atributo referrerpolicy en el propio iframe, que a veces agrega un plugin de inserción.
  • noreferrer en una ventana que abrís para alojar el reproductor, algo que la página de YouTube pide no usar.

El arreglo en un sitio web

Mandá la política que recomienda YouTube, como header:

Referrer-Policy: strict-origin-when-cross-origin

o como meta etiqueta, si no podés tocar los headers:

<meta name="referrer" content="strict-origin-when-cross-origin">

Después fijate que nada más específico la pise: sacá el atributo referrerpolicy del iframe, o ponele el mismo valor. Esa política les manda a otros sitios sólo tu origen (por ejemplo https://example.com), nunca la ruta completa, así que no perdés privacidad que importe. Willison también probó cambiar la inserción a youtube-nocookie.com y le sirvió sólo a veces; lo que lo resolvió fue corregir la política.

El arreglo dentro de una app (WebView, Electron, Tauri)

Las apps se lo cruzan más seguido, porque sus páginas no vienen de un sitio web. Una página cargada desde un archivo local o un esquema propio (file://, app://, tauri://localhost) no tiene un origen web para mandar, así que el reproductor no recibe un Referer que le sirva. La página de YouTube dice qué hacer en cada caso:

  • WebView móvil que carga HTML local: definí el parámetro baseUrl, que fija el Referer.
  • SFSafariViewController en iOS: no permite fijar el Referer, así que usá el parámetro origin del reproductor.
  • Apps de escritorio: agregá el Referer como header HTTP en el pedido, o configurá el WebView para que lo mande.

Una última opción, cuando no controlás los headers del WebView: alojá una página mínima en un dominio https tuyo que inserte el reproductor, y mostrá esa página dentro de tu app. Así el reproductor ve tu dominio como el que lo insertó.

Cómo nos pasó a nosotros

Hacemos Webstarted Toolbox, una app de barra de menú hecha con Tauri, y su widget Media reproduce videos de YouTube. Su interfaz corre en tauri://localhost, que no es un origen web válido, así que un iframe directo a youtube.com/embed fallaba con el error 153 siempre. Lo resolvimos con la última opción: el widget muestra una página chica que alojamos en nuestro propio dominio https, que manda un Referer correcto e inserta el reproductor. El video sigue viajando directo de Google a quien lo mira; por nuestro servidor pasa sólo esa página.

Si sólo querés ver el video

El error es del sitio o la app que insertó el video, no tuyo. El link para verlo en YouTube lo reproduce en youtube.com. Una excepción para revisar: una extensión o un ajuste de privacidad del navegador que saca el Referer de todos los pedidos elimina ese mismo header, y puede provocar el error 153 en sitios bien configurados.

Fuentes