Vídeo y subtítulos · Descargador de miniaturas y visor de metadatos de YouTube
Cómo oEmbed devuelve el título público, el canal y el código de inserción de un vídeo
· Cómo funciona
youtube incorporado metadatos
Existe una forma estándar y sin claves de solicitar a un sitio de vídeos el título público, el autor y el HTML incrustado de un enlace. Esta publicación explica oEmbed, cómo se ven una solicitud y una respuesta y cómo una herramienta puede mostrar metadatos sin raspar la página.
Título y canal sin cargar la página: la pregunta para la que oEmbed fue diseñado
Un blogger puede conocer el título y el canal actual de un video público sin cargar la página de visualización. ToolAcre solicita al punto final oEmbed de YouTube un registro estructurado JSON solo después de que el visitante presiona explícitamente Buscar. Esa secuencia también evita que una búsqueda fallida de metadatos se confunda con una URL con formato incorrecto, ya que las dos etapas tienen evidencia diferente.
El enlace se analiza primero en el navegador. Esa verificación previa valida y extrae la identificación sin acceso a la red, manteniendo la entrada con formato incorrecto alejada tanto del host de miniaturas como del punto final de metadatos. El punto final proporciona una representación pública limitada, no una fuente de datos de propósito general ni un mecanismo de autorización.
Qué es oEmbed: un pequeño estándar en el que un sitio publica un punto final que responde "describe esta URL" con JSON
oEmbed es una convención de solicitud y respuesta para describir una URL pública. Aquí, YouTube proporciona un punto final que acepta la URL del vídeo y devuelve JSON campos destinados a la inserción y la atribución. La consulta exacta es útil en un seguimiento de red porque muestra qué recurso canónico se solicitó sin exponer las credenciales de la cuenta.
ToolAcre trata ese punto final como un techo en lugar de una puerta de entrada al scraping. No inspecciona el HTML de la página de visualización, los servicios internos de youtubei, las firmas ni nada que una solicitud pública cerrada no pueda alcanzar. Un campo puede estar presente en JSON sin formato y aún así omitirse intencionalmente del contrato de aplicación, por lo que la normalización es una decisión del producto. Eso evita que las notas posteriores dependan de adiciones accidentales ascendentes.
La solicitud: la URL del vídeo y un parámetro de formato, nada más, enviada a youtube.com
La solicitud va a https://www.youtube.com/oembed con la URL configurada en un valor canónico https://www.youtube.com/watch?v=ID y el formato establecido en json. No se agrega ninguna clave API, cookie de inicio de sesión ni token de cuenta. En consecuencia, un resultado vacío es una observación de límites, no una prueba de que el identificador no sea válido o de que se deban volver a intentar los datos protegidos.
El navegador envía un GET anónimo con las credenciales omitidas, sin referencia, sin almacenamiento en caché y con redireccionamientos seguidos. Google lo recibe junto con su encabezado Origin directamente; ToolAcre no opera ningún servidor ni proxy en esa ruta. Esto mantiene las exportaciones estables cuando las cargas útiles ascendentes contienen campos adicionales que la herramienta no promete preservar.
La respuesta normalizada expone campos de metadatos, no HTML incorporado
El esquema prometido mostraba HTML incrustado, pero normalizeOembed deja deliberadamente ese campo fuera. El objeto normalizado contiene título, canal, URL del canal, URL en miniatura y dimensiones, ancho y alto del reproductor, proveedor y la identificación del video. Clasificar las fallas por separado ayuda al usuario a decidir si desea volver a intentarlo, inspeccionar la respuesta o elegir otra fuente permitida.
Se defienden todos los valores: el texto faltante tiene un respaldo simple, las dimensiones deben ser positivas y los enlaces deben ser HTTPS. Esto hace que el JSON exportado sea predecible sin implicar que se representen todas las propiedades oEmbed sin procesar. La solicitud se puede inspeccionar en DevTools, pero el registro del navegador no implica almacenamiento por parte de ToolAcre ni procesamiento solo local.
Por qué no se necesita ninguna clave ni inicio de sesión: los datos ya son públicos en la página; oEmbed simplemente lo estructura
No se requiere ninguna clave porque se trata de metadatos públicos cerrados, pero público no significa universal. Los videos privados, eliminados y con restricción de edad no proporcionan el registro, mientras que un propietario que deshabilita la inserción puede generar una respuesta de autorización. Por lo tanto, un editor que revise una solicitud fallida debe verificar la disponibilidad de inserción y la visibilidad del video en lugar de asumir que la identificación de once caracteres se analizó incorrectamente.
El límite de ausencia es explícito: no se sintetizan vistas, me gusta, descripción, etiquetas, duración, fecha de publicación ni subtítulos. Un punto final sin clave no otorga acceso más allá de lo que YouTube elige publicar. Si una hoja de cálculo editorial necesita esos campos omitidos, su autor debe utilizar otra fuente permitida y etiquetar esa fuente en lugar de presentar espacios en blanco como datos oIncrustar.
Ejemplo resuelto: mapeo oEmbed JSON en el registro normalizado de ToolAcre
Para una carga útil exitosa, el título se asigna al título, el nombre del autor al canal, la URL del autor a la URL del canal, los campos de miniatura a una descripción de imagen anidada y el ancho y alto a las dimensiones del reproductor. nombre_proveedor se convierte en proveedor. Esta asignación proporciona a las exportaciones nombres de aplicaciones estables, aunque la convención ascendente utiliza terminología de autor para un canal de YouTube.
HTML sin formato puede estar presente en sentido ascendente, pero el resultado de ToolAcre y las exportaciones no lo exponen. La aplicación crea por separado su propio iframe receptivo con privacidad mejorada a partir del ID validado, evitando la confianza accidental en el marcado del punto final. Los consumidores reciben datos que pueden citar o serializar, mientras que el marcado de inserción ejecutable permanece fuera del contrato de metadatos normalizado.
Lo que esto no cubre: recuentos de vistas, descripciones, comentarios, subtítulos y cualquier cosa detrás de un inicio de sesión.
Un intento de metadatos puede fallar antes de una respuesta debido al modo fuera de línea, bloqueadores o servidores proxy; puede fallar a través de un estado HTTP; o puede devolver un estado de éxito con JSON no válido. Cada ruta recibe un mensaje diferente. Un error de transporte sugiere verificar el entorno del navegador, mientras que JSON no válido identifica una respuesta que llegó pero que no pudo satisfacer el formato prometido por el punto final.
El sondeo de miniaturas es independiente y puede ver 404, otro error, un marcador de posición 200 o datos no decodificables. Ninguna sucursal descarga videos ni elude las restricciones de contenido privado, eliminado o restringido por edad. Mantener las ramas independientes permite al editor conservar un cartel verificado incluso si la atribución del título no está disponible temporalmente, sin inventar los metadatos faltantes.
Metadatos públicos estructurados sin mostrar el HTML incrustado del punto final
El resultado son metadatos públicos estructurados, no una copia de HTML oEmbed arbitrario. ToolAcre puede exportar los hechos normalizados como JSON, Markdown, CSV o texto y puede crear enlaces conocidos a partir del identificador validado. La elección de la exportación cambia la presentación, no el alcance: cada formato refleja el mismo título, canal, imagen, reproductor, proveedor y registro de identificación.
Después de Fetch, el tráfico consta de solicitudes de imágenes directas de i.ytimg.com y una solicitud canónica de oEmbed. Las solicitudes omiten las credenciales y la referencia, utilizan redirecciones sin almacenamiento y seguidas, y permanecen visibles para su verificación en el panel de Red del navegador. Ese rastro prueba que el navegador contactó directamente a Google; no muestra que ToolAcre almacene una búsqueda, ni hace que la operación sea local.