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
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| external_reference | string | Sí | El id del video en tu sistema (hasta 100 caracteres). Evita publicar el mismo video dos veces en el mismo canal. |
| format | string | Sí | Siempre shorts en YouTube. |
| caption | string | No | Se vuelve la descripción del video. Hasta 5000 bytes, sin < ni >. |
| media | array | Sí | Exactamente 1 video, sin alt_text. |
| youtube.title | string | Sí | Título del video, hasta 100 caracteres, sin < ni >. |
| youtube.privacy_status | string | Sí | Visibilidad: public, unlisted o private. |
| youtube.category_id | string | No | Categoría del video. Viene de GET /posts/youtube/categories. |
| youtube.tags | array | No | Etiquetas del video, sin <, > ni comas. Juntas, hasta 500 caracteres. |
| youtube.made_for_kids | boolean | No | Declara el video como hecho para niños. |
| youtube.notify_subscribers | boolean | No | Notifica 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.
Mira Connect aplicado a tu producto.
Pruébalo durante 15 días sin tarjeta, o cuéntale tu caso a nuestro equipo.
