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

ChampTypeObligatoireDescription
external_referencestringOuiL'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.
formatstringOuiToujours shorts sur YouTube.
captionstringNonDevient la description de la vidéo. 5000 octets max, sans < ni >.
mediaarrayOuiExactement 1 vidéo, sans alt_text.
youtube.titlestringOuiTitre de la vidéo, 100 caractères max, sans < ni >.
youtube.privacy_statusstringOuiVisibilité : public, unlisted ou private.
youtube.category_idstringNonCatégorie de la vidéo. Vient de GET /posts/youtube/categories.
youtube.tagsarrayNonTags de la vidéo, sans <, > ni virgule. Ensemble, 500 caractères max.
youtube.made_for_kidsbooleanNonDéclare la vidéo comme conçue pour les enfants.
youtube.notify_subscribersbooleanNonNotifie 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.

Voir aussi

Voir tout ce que vous pouvez faire avec Posts

Voyez Connect appliqué à votre produit.

Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.