Posts
Publier des Shorts YouTube via l'API
Un POST /posts avec la connexion youtube et le format shorts envoie la vidéo sur la chaîne que le client a connectée. Votre produit n'implémente pas l'OAuth de YouTube et ne stocke aucun token : il envoie l'URL de la vidéo et Connect publie en arrière-plan, sur le même endpoint que les autres réseaux.
L'appel
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
}
}Ce que vous pouvez faire
- Publier une vidéo courte sur la chaîne, avec titre et description.
- Choisir la visibilité : public, unlisted ou private.
- Lister les catégories attribuables avec GET /posts/youtube/categories et utiliser l'id dans youtube.category_id.
- Définir les tags, le marquage contenu pour enfants (made_for_kids) et la notification aux abonnés.
- Choisir la chaîne par la connexion (customer_integration) ou par source_name.
Règles et limites
- Le format est toujours shorts, avec exactement 1 vidéo et sans alt_text.
- youtube.title (100 caractères max) et youtube.privacy_status sont obligatoires. Titre et description n'acceptent ni < ni >.
- La description (caption) va jusqu'à 5000 octets. Les tags n'acceptent ni <, > ni virgule, et totalisent 500 caractères max.
- YouTube décide si c'est un Short d'après la vidéo elle-même : verticale et de 3 minutes maximum.
- POST /posts répond 202 et la publication se fait ensuite. Suivez-la avec GET /posts/{uuid}.
- Les vidéos de plus de 8 Mo peuvent être envoyées d'abord en parties via le module média, qui renvoie l'URL à utiliser dans media.url.
Champs principaux
| Champ | Type | Obligatoire | Description |
|---|---|---|---|
| external_reference | string | Oui | L'id de la vidéo dans votre système (100 caractères max). Évite de publier deux fois la même vidéo sur la même chaîne. |
| format | string | Oui | Toujours shorts sur YouTube. |
| caption | string | Non | Devient la description de la vidéo. 5000 octets max, sans < ni >. |
| media | array | Oui | Exactement 1 vidéo, sans alt_text. |
| youtube.title | string | Oui | Titre de la vidéo, 100 caractères max, sans < ni >. |
| youtube.privacy_status | string | Oui | Visibilité : public, unlisted ou private. |
| youtube.category_id | string | Non | Catégorie de la vidéo. Vient de GET /posts/youtube/categories. |
| youtube.tags | array | Non | Tags de la vidéo, sans <, > ni virgule. Ensemble, 500 caractères max. |
| youtube.made_for_kids | boolean | Non | Déclare la vidéo comme conçue pour les enfants. |
| youtube.notify_subscribers | boolean | Non | Notifie les abonnés de la chaîne. |
Pour qui
Plateforme de créateurs
Le créateur enregistre une fois et le produit publie le Short sur la chaîne connectée, avec titre, tags et visibilité définis.
Réemploi de vidéo courte
Un outil de réseaux sociaux envoie la même vidéo verticale vers Reels et YouTube Shorts, dans des appels séparés.
Agent IA vidéo
Un agent génère la vidéo et les métadonnées, choisit la catégorie dans GET /posts/youtube/categories et publie en private pour relecture.
Fonctionne avec
YouTube
Questions fréquentes
Comment YouTube sait-il que c'est un Short ?
D'après la vidéo elle-même : verticale et de 3 minutes maximum. Vous envoyez format shorts et YouTube décide.
Comment trouver le category_id ?
Appelez GET /posts/youtube/categories avec la connexion ou source_name. region_code (BR par défaut) et hl règlent le pays et la langue des titres.
Puis-je publier d'abord en privé ?
Oui. youtube.privacy_status accepte public, unlisted ou private.
Voyez Connect appliqué à votre produit.
Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.
