Se connecterCommencer l’essai gratuit
easyCoexistence API officielles

Publier des Reels Instagram via l'API

L'API d'Instagram publie un Reel à partir d'un fichier MOV ou MP4 situé à une URL publique : il faut créer un conteneur avec media_type REELS, attendre que Meta traite la vidéo, puis la publier. Un Reel dure de 3 secondes à 15 minutes et pèse jusqu'à 300 Mo, et Meta recommande un cadrage 9:16 pour éviter le recadrage ou les zones vides.

easyCoexistence publie des Reels avec publish_instagram_post depuis Claude, ChatGPT ou votre propre code : vous lui donnez l'URL de la vidéo et la légende, et pendant que la vidéo est encore en traitement, il termine la publication de lui-même.

15 min

Le plus long Reel publié par l'API ; le plus court dure 3 secondes.

300 MB

Taille maximale d'un fichier Reel, en MOV ou MP4 avec vidéo H.264 ou HEVC et audio AAC.

1 min

Fréquence à laquelle Meta suggère de vérifier le statut d'un conteneur en cours de traitement, pendant 5 minutes au maximum.

24 hours

Durée pendant laquelle un conteneur de Reel peut attendre sans être publié avant d'expirer.

Comment un Reel est-il publié ?

En trois étapes. D'abord, POST /<IG_ID>/media avec media_type défini sur REELS, video_url pointant vers le fichier et, si vous le souhaitez, une légende ; Meta récupère la vidéo et renvoie un identifiant de conteneur. Ensuite, attendez qu'Instagram traite la vidéo en vérifiant le status_code du conteneur. Enfin, POST /<IG_ID>/media_publish avec creation_id égal à l'identifiant du conteneur ; la réponse contient l'identifiant du nouveau média.

Meta documente son envoi reprenable, qui peut transférer un fichier depuis un ordinateur, uniquement pour les configurations bâties sur Facebook Login for Business, Unified Login compris. Avec Instagram Login, la vidéo provient toujours d'une URL publique.

Quelles sont les exigences vidéo ?

La spécification de Meta pour les Reels, qu'un fichier doit respecter avant qu'Instagram ne le traite :

  • Conteneur : MOV ou MP4 (MPEG-4 Part 14), sans listes d'édition, avec l'atome moov au début du fichier.
  • Vidéo : H.264 ou HEVC, balayage progressif, GOP fermé, sous-échantillonnage de chrominance 4:2:0, de 23 à 60 images par seconde, jusqu'à 1 920 pixels de large et 25 Mbps.
  • Audio : AAC, jusqu'à 48 kHz, mono ou stéréo, à 128 kbps.
  • Ratio d'image : de 0,01:1 à 10:1, avec 9:16 recommandé.
  • Durée et taille : de 3 secondes à 15 minutes, jusqu'à 300 Mo.

Que se passe-t-il pendant le traitement de la vidéo ?

Le status_code du conteneur reste IN_PROGRESS tant qu'Instagram n'a pas fini de traiter la vidéo, puis passe à FINISHED ; ce n'est qu'alors qu'il peut être publié. Une publication plus tôt échoue avec le code 9007, sous-code 2207027, ce qui signifie qu'il faut attendre et non corriger. Meta suggère de vérifier le statut une fois par minute, pendant 5 minutes au maximum.

ERROR signifie que le conteneur n'a pas pu terminer son traitement, et EXPIRED qu'il est resté non publié pendant 24 heures ; dans les deux cas, il faut un nouveau conteneur. PUBLISHED signifie que le Reel est déjà en ligne.

Quelles options de Reel propose l'API ?

Outre la vidéo et la légende, le conteneur de Reel de Meta accepte ces paramètres :

  • share_to_feed : true fait apparaître le Reel dans le fil d'actualité en plus de l'onglet Reels, false le limite à l'onglet Reels. Aucune de ces valeurs ne garantit une place dans l'onglet Reels.
  • cover_url : un JPEG de 8 Mo au maximum, utilisé comme couverture dans l'onglet Reels, recadré au centre en 9:16, et en carré lorsqu'il est partagé au fil d'actualité.
  • thumb_offset : l'image, en millisecondes, utilisée comme vignette lorsqu'il n'y a pas de couverture ; 0 correspond à la première image.
  • audio_name : un nom pour l'audio du Reel, qui ne peut être défini qu'une seule fois.
  • trial_params : publie un Reel d'essai, partagé uniquement avec les personnes qui ne suivent pas le compte, jusqu'à ce qu'il soit promu.

Que s'applique-t-il d'autre à un Reel ?

Quelques règles s'appliquent à un Reel dès la création de son conteneur.

  • Un Reel ne peut pas être un élément de carrousel ; il est toujours publié seul.
  • Les paramètres de confidentialité du compte s'appliquent à la publication : avec « Autoriser le remix » activé, le nouveau Reel autorise aussi le remix.
  • Le marquage musical n'est disponible que pour l'audio original.
  • Relu plus tard, un Reel renvoie media_type VIDEO, comme toute autre vidéo.
  • Il compte pour une publication sur la limite de 100 publications via l'API par compte en 24 heures.

Quelles statistiques un Reel remonte-t-il ?

Via l'endpoint de statistiques média, un Reel remonte la portée, les vues, les j'aime, les commentaires, les enregistrements, les partages, total_interactions et les republications, ainsi que trois métriques propres : ig_reels_avg_watch_time, ig_reels_video_view_total_time et reels_skip_rate, la part des vues passées dans les 3 premières secondes. Les j'aime, commentaires et vues ne comptent que l'activité organique, et les données sous-jacentes peuvent accuser un retard allant jusqu'à 48 heures.

Erreurs courantes

  • Publier dès la création du conteneur. Attendez que status_code affiche FINISHED, sinon l'appel échoue avec le sous-code 2207027.
  • Envoyer un fichier WebM ou AVI. Les Reels doivent être en MOV ou MP4, sinon Meta les refuse avec le code 352, sous-code 2207026.
  • Croire que share_to_feed place le Reel dans l'onglet Reels. Il ajoute seulement le fil d'actualité ; Instagram décide de ce que montre l'onglet Reels.
  • Laisser un conteneur non publié pendant la nuit. Il expire 24 heures après sa création, et la publication exige alors un nouveau conteneur.
Faire cela avec EasyCoexistence

Les Reels peuvent aussi être planifiés depuis sa propre file d'attente. De US$ 9 à US$ 0,75 par connexion et par mois, dégressif à mesure que vous ajoutez des connexions, avec un essai gratuit de 3 jours.

Questions fréquemment posées

Quelle est la durée maximale d'un Reel via l'API ?

De 3 secondes à 15 minutes, sous forme de fichier MOV ou MP4 d'au plus 300 Mo.

Puis-je envoyer un Reel depuis mon ordinateur ?

Pas avec Instagram Login. L'API récupère la vidéo depuis une URL publique ; placez donc d'abord le fichier à un endroit qui lui donne un lien public.

Un Reel publié via l'API apparaît-il aussi dans le fil d'actualité ?

Il le peut. Le paramètre share_to_feed décide si le Reel peut apparaître dans le fil d'actualité en plus de l'onglet Reels.

Pourquoi la publication d'un Reel échoue-t-elle avec 9007 ?

Instagram traite encore la vidéo. Vérifiez le status_code du conteneur et publiez lorsqu'il affiche FINISHED ; rien dans la requête n'est à corriger.

Poursuivre la lecture

Connectez votre premier canal en deux minutes.

Aucune validation de plateforme à attendre. Connectez WhatsApp, Instagram, TikTok ou un autre canal, puis demandez à votre IA de publier, de répondre ou de faire un rapport, et regardez-la travailler.

  • 3 jours gratuits
  • Résiliable à tout moment
  • API officielles uniquement
  • Supervisé 24/7

Vérifié le