Necesitas lanzar una función de medios esta semana: dado un ID de video de YouTube, obtener videos similares para recomendaciones, cargar los últimos comentarios para moderación o widgets comunitarios, y extraer detalles ricos del video para tu interfaz de usuario. Al final de esta guía, usarás la API de datos de YouTube en Zyla API Hub para hacer exactamente eso con solicitudes que puedes copiar y pegar en tu backend o script hoy.
Lo que esta API te ofrece
La API de datos de YouTube en Zyla API Hub proporciona tres endpoints enfocados para aplicaciones de medios:
- Videos Similares: obtener una lista de videos relacionados con un ID de video dado para recomendaciones.
- Comentarios de Video: recuperar los últimos hilos de comentarios (autor, texto, me gusta, marcas de tiempo) para un video específico.
- Detalles del Video: obtener metadatos básicos para un video, incluyendo título, descripción, fecha de publicación y más.
Estos endpoints están listos para usar a través de la puerta de enlace unificada de Zyla y funcionan bien para carriles de recomendación, colas de moderación de comentarios, curaduría editorial y paneles de análisis.
Comenzando en Zyla API Hub
Abre la página de la API de datos de YouTube en Zyla y haz clic en Suscribirse o Comenzar Prueba Gratuita cuando esté disponible. Recibirás una única clave API que puedes usar en todas las llamadas. La autenticación es a través del encabezado HTTP Authorization: Bearer YOUR_API_KEY. Zyla funciona con un modelo de suscripción + cuota; consulta la página de la API para las opciones de acceso y precios actuales.
Puedes explorar más de 10,000 APIs públicas en zylalabs.com, agregar múltiples APIs de medios y entretenimiento a una cuenta, y llamarlas con una clave API. La API de datos de YouTube ofrece una prueba de 7 días desde la lista del mercado.
Endpoints que usarás
1) Videos Similares
Recibe una lista de videos más similares a uno dado.
- Método: GET
- URL: https://zylalabs.com/api/14/youtube-data-api/56/similar-videos
- Parámetros de consulta requeridos:
- relatedToVideoId (string): 7ghhRHRP6t4
- part (string): id,snippet
- type (string): video
- Parámetros de consulta 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"Respuesta de ejemplo 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)\nSubtract, el nuevo álbum, disponible el 05.05.2023. Pre-orden: https://es.lnk.to/subtract\n \nTomado 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'. \n \nSuscrí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. \nhttp://bit.ly/SubscribeToEdSheeran \n \nVer más videos oficiales de Ed Sheeran aquí: \nhttps://www.youtube.com/watch?v=ryJgDL9jzKk&list=PLjp0AEEJ0-fGKG_3skl0e1FQlJfnx-TJz \n\nEscucha más del No. 6 Collaborations Project aquí : \nhttps://www.youtube.com/playlist?list=PLjp0AEEJ0-fHZDWhxhKo0wG08bMUcRy3l\n \nSigue a Ed Sheeran en: \nInstagram: http://instagram.com/teddysphotos\nTikTok: https://www.tiktok.com/@edsheeran\nFacebook: http://www.facebook.com/EdSheeranMusic\nTwitter: http://twitter.com/edsheeran\nDiscord: http://discord.gg/edsheeran\nSitio web oficial: http://edsheeran.com \n\nSobre Ed Sheeran: \nEd 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. \n\nSu 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’. \n \nEn 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’. \n \n#EdSheeran #Khalid #BeautifulPeople","thumbnails":{"…Lo que usarás de esta carga útil:
- items[].id.videoId: el ID del video objetivo para vinculación o reproducción.
- items[].snippet.title: el encabezado clickeable para tu interfaz de usuario.
- items[].snippet.publishedAt: marca de tiempo ISO 8601 que puedes mostrar o clasificar.
- nextPageToken: úsalo para paginar si necesitas más de resultsPerPage.
- pageInfo.totalResults y pageInfo.resultsPerPage: para dimensionar la paginación y la interfaz de usuario.
2) Comentarios de Video
Obtén los últimos hilos de comentarios para un video dado. Útil para herramientas de moderación, secciones de prueba social y análisis de participación.
- Método: GET
- URL: https://zylalabs.com/api/14/youtube-data-api/61/video-comments
- Parámetros de consulta requeridos:
- part (string): snippet
- videoId (string): 7ghhRHRP6t4
- maxResults (string): 100
Ejemplo oficial de curl:
Respuesta de ejemplo:
{"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)\nSubtract, el nuevo álbum, disponible el 05.05.2023. Pre-orden: https://es.lnk.to/subtract\n \nTomado 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'. \n \nSuscrí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. \nhttp://bit.ly/SubscribeToEdSheeran \n \nVer más videos oficiales de Ed Sheeran aquí: \nhttps://www.youtube.com/watch?v=ryJgDL9jzKk&list=PLjp0AEEJ0-fGKG_3skl0e1FQlJfnx-TJz \n\nEscucha más del No. 6 Collaborations Project aquí : \nhttps://www.youtube.com/playlist?list=PLjp0AEEJ0-fHZDWhxhKo0wG08bMUcRy3l\n \nSigue a Ed Sheeran en: \nInstagram: http://instagram.com/teddysphotos\nTikTok: https://www.tiktok.com/@edsheeran\nFacebook: http://www.facebook.com/EdSheeranMusic\nTwitter: http://twitter.com/edsheeran\nDiscord: http://discord.gg/edsheeran\nSitio web oficial: http://edsheeran.com \n\nSobre Ed Sheeran: \nEd 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. \n\nSu 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’. \n \nEn 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’. \n \n#EdSheeran #Khalid #BeautifulPeople","thumbnails":{"…Campos que típicamente leerás:
- items[].snippet.topLevelComment.snippet.textOriginal y textDisplay: la cadena del comentario.
- items[].snippet.topLevelComment.snippet.authorDisplayName y authorProfileImageUrl: información del autor.
- items[].snippet.topLevelComment.snippet.likeCount: métrica de participación.
- items[].snippet.topLevelComment.snippet.publishedAt: marca de tiempo ISO para ordenar.
- nextPageToken y pageInfo para paginación.
3) Detalles del Video
Recupera metadatos para un video específico. Ideal para páginas de detalles, incrustaciones y paneles editoriales.
- Método: GET
- URL: https://zylalabs.com/api/14/youtube-data-api/62/video-details
- Parámetros de consulta requeridos:
- id (string): 7ghhRHRP6t4
Ejemplo oficial de curl:
Respuesta de ejemplo:
{"kind":"youtube#videoListResponse","items":[{"kind":"youtube#video","id":"7ghhRHRP6t4","snippet":{"publishedAt":"2020-07-24T04:00:10Z","channelId":"UCN1hnUccO4FD5WfM7ithXaw","title":"Maroon 5 - Nobody's Love (Official Music Video)","description":"“Nobody’s Love” ya está disponible: https://smarturl.it/NobodysLove \n\nPara más, visita: \nInstagram: https://www.instagram.com/maroon5 \nFacebook: https://www.facebook.com/maroon5 \nTwitter: https://twitter.com/maroon5 \nRegístrate para recibir actualizaciones: http://smarturl.it/Maroon5.News \n\n// \n\nLETRA \n\nPodrías hacer llorar a un hombre adulto\nSi alguna vez dijeras adiós\nNunca te dejaré ir oh-woah oh-I\nNunca te dejaré ir oh-woah oh-I\nPodrías hacer llorar a un hombre adulto\nSi alguna vez dejaras mi lado\nNunca te dejaré ir oh-woah oh-I\nNunca te dejaré ir oh-woah oh-I\n\nEres la única mano en mi bolsillo trasero\nSi alguna vez te fueras, me volvería psicótico\nCielo, escúchame llorar llorar oh oh\nCariño, eres la llave de mi corazón\nSi alguna vez te fueras, nunca la desbloquearía\nSolitario como una isla, isla oh oh\n\nSi mi amor no es tu amor, nunca será el amor de nadie\nNunca necesitaré el amor de nadie, solo el tuyo, solo el tuyo\nSi mi amor no es tu amor, nunca será el amor de nadie\nNunca necesitaré nob…De esta respuesta, generalmente renderizarás:
- items[0].snippet.title y description: los metadatos principales para la página.
- items[0].snippet.publishedAt: mostrar en hora local después de convertir de UTC ISO 8601.
- items[0].id: el ID de video canónico para pasar a otros endpoints.
Ejemplo de extremo a extremo: construir un carrusel de “Videos Relacionados”
El siguiente fragmento de Python llama al endpoint de Videos Similares, lista el ID de cada video relacionado, el título y la marca de tiempo de publicación, y muestra cómo manejar la paginación a través de nextPageToken si está presente. Reemplaza YOUR_API_KEY con tu valor de Zyla.
import os
import requests
API_KEY = os.getenv("ZYLALABS_API_KEY", "YOUR_API_KEY")
BASE_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}",
}
def fetch_similar_videos():
r = requests.get(BASE_URL, params=params, headers=headers, timeout=20)
r.raise_for_status()
data = r.json()
for item in data.get("items", []):
vid = item.get("id", {}).get("videoId")
snip = item.get("snippet", {})
title = snip.get("title")
published = snip.get("publishedAt")
print(f"{vid}\t{published}\t{title}")
# Si necesitas páginas adicionales, verifica nextPageToken en data
if "nextPageToken" in data:
print("Next page token:", data["nextPageToken"])
if __name__ == "__main__":
fetch_similar_videos()Notas que ahorran tiempo:
- Las marcas de tiempo como publishedAt y comment publishedAt son ISO 8601 en UTC. Convierte del lado del cliente para las visualizaciones locales.
- Usa nextPageToken para paginar. Almacena en caché las respuestas por ID de video para evitar golpes repetidos cuando los usuarios se desplazan o vuelven a visitar.
- El encabezado de Autorización debe estar presente en cada solicitud a los endpoints de Zyla.
Casos de uso prácticos de medios que puedes lanzar
- Recomendaciones de página de visualización: llama a Videos Similares con el ID del video actual y renderiza un carrusel horizontal de items[].
- Moderación de comentarios: obtiene Comentarios de Video; muestra textOriginal, authorDisplayName, likeCount y publishedAt en tu interfaz de revisión.
- Curaduría editorial: hidrata tarjetas con Detalles del Video (título, publishedAt) y usa Videos Similares para llenar “Más como esto.”
- Incrustaciones de boletines o blogs: prefetch detalles y algunas selecciones similares para reducir cambios de diseño y llamadas en el momento del envío.
- Enriquecimiento de análisis: almacena nextPageToken y pageInfo para entender la cobertura vs. totalResults para estrategias de muestreo.
Llama a la API desde agentes de IA a través de MCP
Puedes invocar estos mismos endpoints de Zyla desde herramientas de desarrollador compatibles con MCP (Claude Code, Cursor, Windsurf y otros). Apunta tu agente o cliente a la puerta de enlace MCP y pasa tu clave API de Zyla.
- Endpoint MCP: https://mcp.zylalabs.com/mcp
- Autenticación: incluye tu clave API; consulta a tu cliente MCP sobre cómo establecer encabezados o parámetros de consulta.
- Flujo típico: define una herramienta que emita un GET a los URLs de Videos Similares, Comentarios de Video o Detalles del Video mostrados arriba, con los mismos parámetros de consulta y encabezado de Autorización.
Lee más sobre el Protocolo de Contexto del Modelo aquí: MCP.
Orientación operativa
- Autenticación: siempre envía Authorization: Bearer YOUR_API_KEY. Una cuenta y una clave funcionan en todas tus APIs suscritas en Zyla.
- Método HTTP: todos los endpoints cubiertos aquí son GET. No envíes un cuerpo; usa los parámetros de consulta exactamente como se especifica.
- Paginación: verifica nextPageToken cuando esté presente; pageInfo.resultsPerPage indica cuántos elementos recibiste.
- Almacenamiento en caché: almacena en caché por videoId para detalles y comentarios, y por relatedToVideoId para resultados similares. Invalida según lo requiera tu producto.
- Manejo de errores: trata los errores no 2xx como errores recuperables o de cara al usuario según tu SLA. Preserva los parámetros de solicitud en los registros para una rápida reproducción.
- Tipos de datos: las fechas son cadenas ISO 8601; los IDs son cadenas; los conteos como likeCount son numéricos en la respuesta.
Dónde obtener tu clave y próximos pasos
Crea tu cuenta en Zyla API Hub, abre la lista de la API de datos de YouTube y comienza la prueba para obtener tu clave. Las llamadas se facturan en un modelo de suscripción + cuota; consulta la lista para tus límites actuales. Usa los fragmentos de curl y Python anteriores como tus primeras solicitudes.
Comienza la prueba de 7 días en la API de datos de YouTube
FAQ
¿Cómo me autentico?
Incluye el encabezado Authorization: Bearer YOUR_API_KEY en cada solicitud a los endpoints de Zyla mostrados arriba.
¿Puedo paginar resultados de Videos Similares y Comentarios de Video?
Sí. Cuando nextPageToken está presente en la respuesta, pásalo de acuerdo con el esquema de paginación del endpoint. Usa pageInfo.totalResults y resultsPerPage para dar forma a tu interfaz de usuario.
¿Qué marcas de tiempo debo esperar?
Campos como publishedAt y updatedAt son cadenas ISO 8601 UTC. Convierte a las zonas horarias locales de tus usuarios en el cliente.
¿Hay un plan gratuito?
Consulta la página de la API para las opciones de acceso y precios actuales. La lista ofrece una prueba de 7 días que puedes comenzar desde la página del artículo del mercado.
¿Estos endpoints aceptan cuerpos de solicitud?
No. Los endpoints documentados aquí son solo GET y usan parámetros de consulta exactamente como se muestran en los ejemplos.
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)\nSubtract, el nuevo álbum, disponible el 05.05.2023. Pre-orden: https://es.lnk.to/subtract\n \nTomado 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'. \n \nSuscrí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. \nhttp://bit.ly/SubscribeToEdSheeran \n \nVer más videos oficiales de Ed Sheeran aquí: \nhttps://www.youtube.com/watch?v=ryJgDL9jzKk&list=PLjp0AEEJ0-fGKG_3skl0e1FQlJfnx-TJz \n\nEscucha más del No. 6 Collaborations Project aquí : \nhttps://www.youtube.com/playlist?list=PLjp0AEEJ0-fHZDWhxhKo0wG08bMUcRy3l\n \nSigue a Ed Sheeran en: \nInstagram: http://instagram.com/teddysphotos\nTikTok: https://www.tiktok.com/@edsheeran\nFacebook: http://www.facebook.com/EdSheeranMusic\nTwitter: http://twitter.com/edsheeran\nDiscord: http://discord.gg/edsheeran\nSitio web oficial: http://edsheeran.com \n\nSobre Ed Sheeran: \nEd 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. \n\nSu 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’. \n \nEn 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’. \n \n#EdSheeran #Khalid #BeautifulPeople","thumbnails":{"…
