Posts

Publicar Shorts en YouTube con la API

Un POST /posts con la conexión youtube y el format shorts envía el video al canal que el cliente conectó. Tu producto no implementa el OAuth de YouTube ni guarda tokens: envía la URL del video y Connect publica en segundo plano, en el mismo endpoint de las otras redes.

La llamada

POST /api/posts?customer_integration=<connection uuid>
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Idempotency-Key: <unique key>

{
  "external_reference": "video-88",
  "format": "shorts",
  "caption": "Behind the scenes of our latest shoot.",
  "media": [
    {
      "type": "video",
      "url": "https://cdn.example.com/short.mp4"
    }
  ],
  "youtube": {
    "title": "Behind the scenes",
    "privacy_status": "public",
    "category_id": "<category id>",
    "tags": [
      "bts",
      "making of"
    ],
    "made_for_kids": false,
    "notify_subscribers": true
  }
}

Qué puedes hacer

  • Publicar un video corto en el canal, con título y descripción.
  • Elegir la visibilidad: public, unlisted o private.
  • Listar las categorías asignables con GET /posts/youtube/categories y usar el id en youtube.category_id.
  • Definir etiquetas, la marca de contenido para niños (made_for_kids) y la notificación a los suscriptores.
  • Elegir el canal por la conexión (customer_integration) o por source_name.

Reglas y límites

  • El format es siempre shorts, con exactamente 1 video y sin alt_text.
  • youtube.title (hasta 100 caracteres) y youtube.privacy_status son obligatorios. Título y descripción no aceptan < ni >.
  • La descripción (caption) llega hasta 5000 bytes. Las etiquetas no aceptan <, > ni comas, y suman hasta 500 caracteres.
  • YouTube decide si es un Short por el propio video: vertical y de hasta 3 minutos.
  • POST /posts responde 202 y la publicación corre después. Síguela con GET /posts/{uuid}.
  • Los videos de más de 8 MB pueden subirse antes por partes con el módulo de medios, que devuelve la URL para usar en media.url.

Campos principales

CampoTipoObligatorioDescripción
external_referencestringSíEl id del video en tu sistema (hasta 100 caracteres). Evita publicar el mismo video dos veces en el mismo canal.
formatstringSíSiempre shorts en YouTube.
captionstringNoSe vuelve la descripción del video. Hasta 5000 bytes, sin < ni >.
mediaarraySíExactamente 1 video, sin alt_text.
youtube.titlestringSíTítulo del video, hasta 100 caracteres, sin < ni >.
youtube.privacy_statusstringSíVisibilidad: public, unlisted o private.
youtube.category_idstringNoCategoría del video. Viene de GET /posts/youtube/categories.
youtube.tagsarrayNoEtiquetas del video, sin <, > ni comas. Juntas, hasta 500 caracteres.
youtube.made_for_kidsbooleanNoDeclara el video como hecho para niños.
youtube.notify_subscribersbooleanNoNotifica a los suscriptores del canal.

Para quién

  • Plataforma para creadores

    El creador graba una vez y el producto publica el Short en el canal conectado, con título, etiquetas y visibilidad definidos.

  • Reutilización de video corto

    Una herramienta de redes sociales envía el mismo video vertical a Reels y a YouTube Shorts en llamadas separadas.

  • Agente de IA de video

    Un agente genera el video y los metadatos, elige la categoría en GET /posts/youtube/categories y publica como private para revisión.

Funciona con

  • YouTube

Preguntas frecuentes

¿Cómo sabe YouTube que es un Short?

Por el propio video: vertical y de hasta 3 minutos. Envías format shorts y YouTube decide.

¿Cómo encuentro el category_id?

Llama a GET /posts/youtube/categories con la conexión o source_name. region_code (por defecto BR) y hl ajustan el país y el idioma de los títulos.

¿Puedo publicar primero como privado?

Sí. youtube.privacy_status acepta public, unlisted o private.

Relacionadas

Ver todo lo que puedes hacer con Posts

Mira Connect aplicado a tu producto.

Pruébalo durante 15 días sin tarjeta, o cuéntale tu caso a nuestro equipo.