API de YouTube: conectar tu canal y subir videos

28 de octubre de 2026 · Equipo Zoosial

La API de YouTube de Zoosial conecta un canal con el inicio de sesión de Google y sube videos por subida resumable con la misma llamada POST /posts que usas para Facebook o Instagram. Hoy sirve para subir video; los videos nacen como privados y YouTube tiene acceso limitado mientras Google termina de verificar la aplicación. El resumen de analíticas (GET /analytics/:accountId/summary) también responde para cuentas de YouTube.

Qué puedes hacer

• Conectar un canal: GET /connect/google?profileId=…&product=youtube.
• Subir un video: POST /posts, con la URL del video en mediaUrls. Puede salir al momento o programado con scheduledFor.
• Preparar el archivo: POST /upload (bytes crudos, sin el tope de 5 MB de las imágenes por JSON), POST /upload/url (Zoosial descarga el video desde una URL https pública, máximo 512 MB) o POST /upload/sign (enlace firmado de 30 minutos).
• Revisar el historial: GET /posts, y cancelar una publicación programada con DELETE /posts/:id.
• Enterarte del resultado por webhook: post.scheduled, post.published y post.failed.

Cómo conectar la cuenta

El mismo endpoint de Google sirve para varios productos, pero uno por conexión. Para YouTube llama a GET /connect/google?profileId=prof_…&product=youtube; sin product asume youtube. Recibirás { authUrl }: ábrela en el navegador de quien administra el canal. Al autorizar, Google pide solo el permiso de YouTube y el callback conecta la cuenta y regresa al Dashboard de Zoosial.

Según el contrato, el callback de YouTube todavía aterriza en el dashboard. Solo Meta y Google Calendar soportan hoy el flujo white-label, así que no ofrezcas la conexión de YouTube a tus usuarios como si no pasaran por Zoosial.

Ejemplo

Subir un video a un canal conectado (los identificadores son ilustrativos):

curl -X POST https://zoosial.com/posts \
  -H "Authorization: Bearer $SC_API_KEY" -H "Content-Type: application/json" \
  -d '{"platforms":[{"accountId":"acc_yt_1"}],"content":"Nuestro nuevo video","mediaUrls":["https://cdn.../video.mp4"],"publishNow":true}'

Por MCP

No hay una herramienta MCP exclusiva de YouTube. El agente usa las genéricas: list_accounts, accounts_health, create_post (publica ya o programa en las cuentas conectadas), list_posts y delete_post. Para llevar un archivo local al servidor existe upload_media, que acepta una URL pública, base64 para imágenes chicas o un enlace firmado de 30 minutos. Ver Servidor MCP.

Reglas y límites

• Acceso limitado. YouTube tiene acceso limitado mientras Google termina de verificar la aplicación.
• Los videos se suben como privados (privacyStatus: private) y no quedan públicos solos. Cámbialo desde YouTube Studio; la documentación dice que el endpoint para hacerlo por API se puede pedir.
• El video va en mediaUrls con la URL del archivo.
• Métricas: GET /analytics/:accountId/summary devuelve un resumen de analíticas también para cuentas de YouTube. Los endpoints insights y post-insights son de Meta.
• Una cuenta de YouTube por perfil; para otro canal, crea otro perfil.
• Google Business Profile y Google Calendar son otros productos, con su propia conexión.

Precio

Publicar, la API, los webhooks y el MCP vienen en el plan gratis: $0, un perfil con hasta 3 cuentas, sin tarjeta y sin vencimiento. El plan de pago cobra por perfil: $95 MXN al mes más IVA, con el primer perfil sin cobro y tramos más baratos al crecer. Hay 14 días de prueba con todas las redes. Ver precios y Publicar y programar.

Compáralo

Para ver cómo se compara Zoosial con otras APIs, entra a la comparativa y lee cómo elegir una API para conectar redes sociales.

Preguntas frecuentes

← Todas las integraciones