Trabajando con la API de Datos de YouTube

Necesitas obtener los metadatos de los videos de YouTube, capturar los últimos comentarios y recomendar videos relacionados sin perder una semana lidiando con la autenticación o documentos dispersos. Al final de esta guía, podrás consultar videos similares para un ID de video dado, obtener comentarios y recuperar detalles del video utilizando la API de Datos de YouTube en Zyla API Hub, con solicitudes que puedes copiar y pegar y consejos amigables para producción.

Qué hace esta API y cuándo usarla

La API de Datos de YouTube en Zyla te brinda tres capacidades enfocadas para aplicaciones de medios:

• Videos Similares: Obtén una lista de videos relacionados pasando un ID de video de YouTube. Útil para carruseles de "Próximo" o recomendaciones de contenido.
• Comentarios de Video: Obtén los últimos comentarios de nivel superior con autor, me gusta y marcas de tiempo. Útil para colas de moderación, pipelines de sentimiento o paneles de comunidad.
• Detalles del Video: Recupera metadatos canónicos como título, descripción, fecha de publicación y métricas de participación. Útil para ingestión, indexación y UIs de vista previa.

Estos endpoints están dirigidos a flujos de trabajo comunes de entretenimiento y medios, como construir feeds de ver a continuación, poblar detalles de catálogo y analizar la retroalimentación de la audiencia.

Comenzando en Zyla API Hub

Abre la página de la API, suscríbete y llámala con una sola clave de API. Zyla API Hub proporciona una cuenta, una clave de API y un modelo de suscripción + cuota a través de APIs de medios (no es por llamada). Para tu primera API, verás una prueba de 7 días o 50 solicitudes; no hay Plan Gratuito. Consulta la página de la API para las opciones de acceso y precios actuales. Cuando estés listo, suscríbete y obtén tu clave aquí:

Comienza la prueba de 7 días en la API de Datos de YouTube

Todas las solicitudes utilizan el encabezado Authorization: Bearer YOUR_API_KEY contra las URL del hub de Zyla. No necesitas gestionar diferentes esquemas de autenticación por proveedor.

Endpoints que usarás

A continuación se presentan los tres endpoints disponibles en esta lista, incluidos sus métodos HTTP exactos, URLs y parámetros requeridos. Mantén las URLs y los nombres de los parámetros exactamente como se muestran.

1) Videos Similares

Recibe una lista de videos relacionados. Pasa un ID de video y obtén videos que son más similares a él.

• Método: GET
• URL: https://zylalabs.com/api/14/youtube-data-api/56/similar-videos
• Parámetros requeridos:
  • relatedToVideoId (string): 7ghhRHRP6t4
  • part (string): id,snippet
  • type (string): video
• Parámetros opcionales:
  • maxResults (string): 50

Ejemplo oficial de cURL:

curl -s -X GET "https://zylalabs.com/api/14/youtube-data-api/56/similar-videos?relatedToVideoId=7ghhRHRP6t4&part=id%2Csnippet&type=video&maxResults=50" \
-H "Authorization: Bearer YOUR_API_KEY"

Ejemplo de respuesta JSON oficial:

{"kind":"youtube#searchListResponse","nextPageToken":"CDIQAA","pageInfo":{"totalResults":108,"resultsPerPage":50},"items":[{"kind":"youtube#searchResult","id":{"kind":"youtube#video","videoId":"mj0XInqZMHY"},"snippet":{"publishedAt":"2019-06-27T14:44:32Z","channelId":"UC0C-w0YjGpqDXGB8IHb662A","title":"Ed Sheeran - Beautiful People (feat. Khalid) [Official Music Video]","description":"El video musical oficial de Ed Sheeran - Beautiful People (feat. @khalid)
Subtract, el nuevo álbum, disponible el 05.05.2023. Pre-orden: https://es.lnk.to/subtract

Tomado de No.6 Collaborations Project lanzado en 2019, que presentó los sencillos exitosos 'I Don't Care', 'Cross Me', 'Beautiful People', 'Blow', 'Best Part of Me', 'Antisocial', 'South of the Border' &'Take Me Back To London'.

Suscríbete al canal de Ed Sheeran para ver todos los mejores y más recientes videos musicales oficiales, detrás de cámaras y presentaciones en vivo. 
http://bit.ly/SubscribeToEdSheeran

Ve más videos oficiales de Ed Sheeran aquí:
https://www.youtube.com/watch?v=ryJgDL9jzKk&list=PLjp0AEEJ0-fGKG_3skl0e1FQlJfnx-TJz

Escucha más del No. 6 Collaborations Project aquí :
https://www.youtube.com/playlist?list=PLjp0AEEJ0-fHZDWhxhKo0wG08bMUcRy3l

Sigue a Ed Sheeran en:
Instagram: http://instagram.com/teddysphotos
TikTok: https://www.tiktok.com/@edsheeran
Facebook: http://www.facebook.com/EdSheeranMusic
Twitter: http://twitter.com/edsheeran
Discord: http://discord.gg/edsheeran
Sitio web oficial: http://edsheeran.com

Acerca de Ed Sheeran:
Ed Sheeran puede ser la estrella pop por excelencia de los 2010s: un cantante/compositor aclamado internacionalmente y ganador de múltiples premios que parece no reconocer límites entre estilos o épocas con elementos de folk, hip-hop, pop, dance, soul y rock entrelazados en su música.

Su increíble catálogo incluye los álbumes de estudio ‘+’ (plus), ‘x’ (multiply) y ‘÷’ (divide) que generaron sencillos exitosos como ‘The A team’ , ’Lego House’, ‘Sing', ‘Thinking Out Loud’, ‘Photograph’, ‘Shape Of You’, ‘Castle on The Hill’ y ‘Perfect’.

En 2019, Ed Sheeran lanzó el ‘No.6 Collaborations Project’ que abarcó varios géneros y presentó una amplia gama de artistas incluyendo ‘Justin Bieber’, ‘Camilla’ Cabello’, ‘Travis Scott’, ‘Eminem’, ‘Cardi B, ‘Paulo Londra’, ‘Bruno Mars’ y ‘Stormzy’ entre muchos otros, produciendo éxitos como ‘I Don’t Care’, ‘Beautiful People’, ‘South of The Border’ y ‘Take Me Back To London’.

#EdSheeran #Khalid #BeautifulPeople","thumbnails":{"…

Lo que usarás en la práctica:

• items[].id.videoId: el ID del video relacionado (string).
• items[].snippet.title: título para mostrar en tu UI.
• items[].snippet.publishedAt: marca de tiempo ISO 8601 (Z = UTC).
• nextPageToken: pasa este token en llamadas subsiguientes (como el token de página cuando sea soportado) para paginar a través de más resultados.

2) Comentarios de Video

Obtén una lista de los últimos comentarios sobre un video específico. Recibirás el texto del comentario, información del autor, me gusta y marcas de tiempo de creación/actualización.

• Método: GET
• URL: https://zylalabs.com/api/14/youtube-data-api/61/video-comments
• Parámetros requeridos:
  • part (string): snippet
  • videoId (string): 7ghhRHRP6t4
  • maxResults (string): 100

Campos típicos para leer de la respuesta:

• items[].snippet.topLevelComment.snippet.textDisplay o textOriginal: el cuerpo del comentario.
• items[].snippet.topLevelComment.snippet.authorDisplayName: nombre de visualización del comentarista.
• items[].snippet.topLevelComment.snippet.likeCount: conteo de me gusta como entero.
• items[].snippet.topLevelComment.snippet.publishedAt y updatedAt: tiempos UTC ISO 8601.
• nextPageToken: si se proporciona, continúa la paginación.

3) Detalles del Video

Obtén detalles de cualquier video: título, descripción, fecha de publicación y conteos de participación.

• Método: GET
• URL: https://zylalabs.com/api/14/youtube-data-api/62/video-details
• Parámetros requeridos:
  • id (string): 7ghhRHRP6t4

Campos típicos para leer de la respuesta:

• items[].snippet.title y items[].snippet.description para mostrar e indexar.
• items[].snippet.publishedAt para cronología y filtrado.
• Otros campos de estadísticas pueden estar presentes dependiendo del proveedor upstream; consulta la carga útil que recibas.

Ejemplo en Python: obtener y renderizar videos relacionados

Este fragmento de Python llama al endpoint de Videos Similares, extrae el videoId y el título para renderizar una lista de ver a continuación, y muestra cómo manejar la paginación a través de nextPageToken.

import requests

API_KEY = "YOUR_API_KEY"
url = "https://zylalabs.com/api/14/youtube-data-api/56/similar-videos"
params = {
"relatedToVideoId": "7ghhRHRP6t4",
"part": "id,snippet",
"type": "video",
"maxResults": "50",
}
headers = {"Authorization": f"Bearer {API_KEY}"}

resp = requests.get(url, params=params, headers=headers, timeout=20)
resp.raise_for_status()
data = resp.json()

# Extraer elementos para la UI
items = data.get("items", [])
related = []
for item in items:
vid = ((item or {}).get("id") or {}).get("videoId")
title = ((item or {}).get("snippet") or {}).get("title")
if vid and title:
related.append({"videoId": vid, "title": title})

print(f"Obtuve {len(related)} videos relacionados:")
for r in related[:5]:
print(f"- {r['videoId']}: {r['title']}")

# Manejar paginación si nextPageToken está presente (pásalo como un token de página cuando sea soportado)
next_token = data.get("nextPageToken")
if next_token:
print("Más páginas disponibles a través de nextPageToken:", next_token)

Casos de uso de medios en el mundo real que puedes implementar esta semana

• Ver a continuación y recomendaciones: Usa Videos Similares para sembrar un carrusel de "Porque viste X" en tu aplicación o UI de reproductor incrustado.
• Páginas de detalles de video: Población de metadatos principales con Detalles del Video; almacena en caché la respuesta JSON para minimizar las recuperaciones repetidas.
• Comunidad y moderación: Alimenta Comentarios de Video en una cola para moderación o un simple widget de "Comentarios recientes"; almacena authorDisplayName, textOriginal, likeCount y marcas de tiempo.
• Curaduría editorial: Construye herramientas internas donde los editores pegan un ID de video y obtienen instantáneamente contenido relacionado para construir colecciones.
• Notificaciones y alertas: Monitorea comentarios en videos de alta prioridad (sondea a intervalos razonables) y alerta a creadores o equipos de soporte.

Notas de implementación que ahorran tiempo

• Marcas de tiempo: los campos publishedAt y updatedAt son cadenas ISO 8601 con una Z final para UTC. Convierte una vez y normaliza en todos tus servicios.
• Paginación: Si nextPageToken está presente en la respuesta, captúralo y emite solicitudes de seguimiento para recuperar resultados adicionales. No asumas que todos los resultados caben en una página.
• maxResults: Mantenlo en 50 cuando necesites menos viajes; redúcelo para UIs ligeras donde la renderización inicial necesita ser rápida.
• Almacenamiento en caché: Almacena en caché los Detalles del Video para videos estables para reducir la latencia y el uso de cuota. Para comentarios, aplica ventanas de caché más cortas ya que los nuevos comentarios llegan con frecuencia.
• Manejo de errores: Trata las respuestas no 2xx como problemas transitorios o relacionados con permisos. Registra la URL de la solicitud y el estado; evita tormentas de reintentos.
• Seguridad: Usa el encabezado Authorization: Bearer YOUR_API_KEY del lado del servidor. Evita exponer tu clave de API en el código del lado del cliente.

Cómo llamarlo desde un agente de IA (MCP)

Si estás orquestando tareas con un cliente compatible con MCP (por ejemplo, Claude Code, Cursor, Windsurf), puedes enrutar llamadas a través del endpoint MCP de Zyla y reutilizar la misma clave. Consulta la documentación de MCP y configura tu cliente para apuntar a:

MCP

Pasa tu clave de API como lo indica la configuración de tu cliente MCP (apikey=YOUR_API_KEY en la URL del endpoint). Desde allí, tu agente puede invocar las herramientas de la API de Datos de YouTube expuestas por el hub sin codificar manualmente llamadas HTTP. Esto es útil para la curaduría de contenido por guion o extracciones de datos ad-hoc mientras prototipas.

Referencia: solicitudes y campos exactos

Videos Similares

GET https://zylalabs.com/api/14/youtube-data-api/56/similar-videos

• relatedToVideoId (requerido)
• part (requerido)
• type (requerido)
• maxResults (opcional)

Campos principales para leer:

• items[].id.videoId
• items[].snippet.title
• items[].snippet.publishedAt
• nextPageToken

Comentarios de Video

GET https://zylalabs.com/api/14/youtube-data-api/61/video-comments

• part (requerido)
• videoId (requerido)
• maxResults (requerido)

Campos principales para leer:

• items[].snippet.topLevelComment.snippet.textDisplay
• items[].snippet.topLevelComment.snippet.authorDisplayName
• items[].snippet.topLevelComment.snippet.likeCount
• items[].snippet.topLevelComment.snippet.publishedAt
• nextPageToken (si está presente)

Detalles del Video

GET https://zylalabs.com/api/14/youtube-data-api/62/video-details

• id (requerido)

Campos principales para leer:

• items[].snippet.title
• items[].snippet.description
• items[].snippet.publishedAt

Guía operativa para aplicaciones de medios

• Planificación de rendimiento: Zyla utiliza un modelo de suscripción + cuota, no es por llamada. Tu primera API incluye una prueba de 7 días o 50 solicitudes. Para volúmenes más altos, monitorea tu uso y consulta la página de la API para las opciones actuales.
• Frescura de datos: Los comentarios cambian rápidamente; los detalles del video menos. Ajusta tus TTLs de caché en consecuencia.
• Estrategia de indexación: Almacena identificadores estables (videoId) como tu clave externa y desnormaliza título/descripción para soportar búsqueda y renderizaciones rápidas.
• Resiliencia: Aplica retroceso en respuestas 429/5xx. Registra qué endpoint y parámetros se utilizaron para acelerar la depuración.
• Internacionalización: Los títulos y descripciones pueden contener Unicode y entidades HTML. Normaliza y escapa para tu marco de UI.

FAQ

Q: ¿Qué autenticación debo usar?
A: Usa el encabezado Authorization: Bearer YOUR_API_KEY en cada solicitud a las URLs del hub de Zyla.

Q: ¿Hay un plan gratuito?
A: No hay Plan Gratuito. Para tu primera API, verás una prueba de 7 días o 50 solicitudes. Consulta la página de la API para las opciones de acceso y precios actuales.

Q: ¿Cómo pagino resultados?
A: Lee nextPageToken de la respuesta. Cuando esté presente, llama al endpoint nuevamente e incluye ese token como el token de página donde sea soportado para obtener la siguiente página.

Q: ¿Qué marcas de tiempo y zona horaria debo esperar?
A: Las marcas de tiempo como publishedAt y updatedAt son cadenas ISO 8601 con un sufijo Z que indica UTC.

Q: ¿Puedo llamar a esto desde mi agente de codificación de IA?
A: Sí, a través del endpoint MCP de Zyla. Configura tu cliente compatible con MCP para usar la URL de MCP y tu clave de API para que el agente pueda llamar a las herramientas de la API de Datos de YouTube sin código HTTP manual.

¿Listo para implementar tu integración de medios? Suscríbete y obtén tu clave de API de la lista del mercado: Comienza la prueba de 7 días en la API de Datos de YouTube. Explora miles más de APIs de medios y entrega más rápido en Zyla API Hub.

Respuesta oficial de la API

{"kind":"youtube#searchListResponse","nextPageToken":"CDIQAA","pageInfo":{"totalResults":108,"resultsPerPage":50},"items":[{"kind":"youtube#searchResult","id":{"kind":"youtube#video","videoId":"mj0XInqZMHY"},"snippet":{"publishedAt":"2019-06-27T14:44:32Z","channelId":"UC0C-w0YjGpqDXGB8IHb662A","title":"Ed Sheeran - Beautiful People (feat. Khalid) [Official Music Video]","description":"El video musical oficial de Ed Sheeran - Beautiful People (feat. @khalid)
Subtract, el nuevo álbum, disponible el 05.05.2023. Pre-orden: https://es.lnk.to/subtract

Tomado de No.6 Collaborations Project lanzado en 2019, que presentó los sencillos exitosos 'I Don't Care', 'Cross Me', 'Beautiful People', 'Blow', 'Best Part of Me', 'Antisocial', 'South of the Border' &'Take Me Back To London'.

Suscríbete al canal de Ed Sheeran para ver todos los mejores y más recientes videos musicales oficiales, detrás de cámaras y presentaciones en vivo. 
http://bit.ly/SubscribeToEdSheeran

Ve más videos oficiales de Ed Sheeran aquí:
https://www.youtube.com/watch?v=ryJgDL9jzKk&list=PLjp0AEEJ0-fGKG_3skl0e1FQlJfnx-TJz

Escucha más del No. 6 Collaborations Project aquí :
https://www.youtube.com/playlist?list=PLjp0AEEJ0-fHZDWhxhKo0wG08bMUcRy3l

Sigue a Ed Sheeran en:
Instagram: http://instagram.com/teddysphotos
TikTok: https://www.tiktok.com/@edsheeran
Facebook: http://www.facebook.com/EdSheeranMusic
Twitter: http://twitter.com/edsheeran
Discord: http://discord.gg/edsheeran
Sitio web oficial: http://edsheeran.com

Acerca de Ed Sheeran:
Ed Sheeran puede ser la estrella pop por excelencia de los 2010s: un cantante/compositor aclamado internacionalmente y ganador de múltiples premios que parece no reconocer límites entre estilos o épocas con elementos de folk, hip-hop, pop, dance, soul y rock entrelazados en su música.

Su increíble catálogo incluye los álbumes de estudio ‘+’ (plus), ‘x’ (multiply) y ‘÷’ (divide) que generaron sencillos exitosos como ‘The A team’ , ’Lego House’, ‘Sing', ‘Thinking Out Loud’, ‘Photograph’, ‘Shape Of You’, ‘Castle on The Hill’ y ‘Perfect’.

En 2019, Ed Sheeran lanzó el ‘No.6 Collaborations Project’ que abarcó varios géneros y presentó una amplia gama de artistas incluyendo ‘Justin Bieber’, ‘Camilla’ Cabello’, ‘Travis Scott’, ‘Eminem’, ‘Cardi B, ‘Paulo Londra’, ‘Bruno Mars’ y ‘Stormzy’ entre muchos otros, produciendo éxitos como ‘I Don’t Care’, ‘Beautiful People’, ‘South of The Border’ y ‘Take Me Back To London’.

#EdSheeran #Khalid #BeautifulPeople","thumbnails":{"…

Respuesta oficial de la API

{"kind":"youtube#searchListResponse","nextPageToken":"CDIQAA","pageInfo":{"totalResults":108,"resultsPerPage":50},"items":[{"kind":"youtube#searchResult","id":{"kind":"youtube#video","videoId":"mj0XInqZMHY"},"snippet":{"publishedAt":"2019-06-27T14:44:32Z","channelId":"UC0C-w0YjGpqDXGB8IHb662A","title":"Ed Sheeran - Beautiful People (feat. Khalid) [Official Music Video]","description":"El video musical oficial de Ed Sheeran - Beautiful People (feat. @khalid)
Subtract, el nuevo álbum, disponible el 05.05.2023. Pre-orden: https://es.lnk.to/subtract

Tomado de No.6 Collaborations Project lanzado en 2019, que presentó los sencillos exitosos 'I Don't Care', 'Cross Me', 'Beautiful People', 'Blow', 'Best Part of Me', 'Antisocial', 'South of the Border' &'Take Me Back To London'.

Suscríbete al canal de Ed Sheeran para ver todos los mejores y más recientes videos musicales oficiales, detrás de cámaras y presentaciones en vivo. 
http://bit.ly/SubscribeToEdSheeran

Ve más videos oficiales de Ed Sheeran aquí:
https://www.youtube.com/watch?v=ryJgDL9jzKk&list=PLjp0AEEJ0-fGKG_3skl0e1FQlJfnx-TJz

Escucha más del No. 6 Collaborations Project aquí :
https://www.youtube.com/playlist?list=PLjp0AEEJ0-fHZDWhxhKo0wG08bMUcRy3l

Sigue a Ed Sheeran en:
Instagram: http://instagram.com/teddysphotos
TikTok: https://www.tiktok.com/@edsheeran
Facebook: http://www.facebook.com/EdSheeranMusic
Twitter: http://twitter.com/edsheeran
Discord: http://discord.gg/edsheeran
Sitio web oficial: http://edsheeran.com

Acerca de Ed Sheeran:
Ed Sheeran puede ser la estrella pop por excelencia de los 2010s: un cantante/compositor aclamado internacionalmente y ganador de múltiples premios que parece no reconocer límites entre estilos o épocas con elementos de folk, hip-hop, pop, dance, soul y rock entrelazados en su música.

Su increíble catálogo incluye los álbumes de estudio ‘+’ (plus), ‘x’ (multiply) y ‘÷’ (divide) que generaron sencillos exitosos como ‘The A team’ , ’Lego House’, ‘Sing', ‘Thinking Out Loud’, ‘Photograph’, ‘Shape Of You’, ‘Castle on The Hill’ y ‘Perfect’.

En 2019, Ed Sheeran lanzó el ‘No.6 Collaborations Project’ que abarcó varios géneros y presentó una amplia gama de artistas incluyendo ‘Justin Bieber’, ‘Camilla’ Cabello’, ‘Travis Scott’, ‘Eminem’, ‘Cardi B, ‘Paulo Londra’, ‘Bruno Mars’ y ‘Stormzy’ entre muchos otros, produciendo éxitos como ‘I Don’t Care’, ‘Beautiful People’, ‘South of The Border’ y ‘Take Me Back To London’.

#EdSheeran #Khalid #BeautifulPeople","thumbnails":{"…