Publications en carrousel Instagram via l'API
L'API d'Instagram publie un carrousel comme une seule publication de jusqu'à 20 photos et vidéos, selon le guide de publication de Meta, bien que sa référence d'erreurs indique encore 10. Chaque élément reçoit son propre conteneur, avec is_carousel_item défini sur true, puis un conteneur CAROUSEL les liste comme enfants et porte la légende. Publier ce conteneur met en ligne l'ensemble, qui compte pour une des 100 publications via l'API autorisées sur 24 heures.
easyCoexistence publie des carrousels de 2 à 10 photos et vidéos avec publish_instagram_post, depuis Claude, ChatGPT ou votre propre code : un appel avec les éléments et la légende publie la publication, et elle se termine d'elle-même pendant qu'une vidéo est encore en traitement.
Photos et vidéos qu'un carrousel peut contenir selon le guide de publication de Meta et le paramètre children.
Sous-code, sous le code 100, dont le message indique encore qu'un carrousel doit compter de 2 à 10 éléments.
Ce qu'un carrousel compte dans la limite de 100 publications via l'API sur 24 heures.
Recadrage par défaut des images du carrousel, qui suivent toutes le ratio d'aspect de la première image.
Statistiques que Meta renvoie pour chaque photo et vidéo d'un carrousel.
Comment un carrousel est-il publié ?
En trois étapes, toutes via POST /<IG_ID>/media et un seul appel de publication.
- Éléments : créez un conteneur pour chaque photo (
image_url) ou vidéo (media_typeVIDEO etvideo_url), avecis_carousel_itemdéfini sur true et sans légende. - Carrousel : créez un conteneur avec
media_typeCAROUSEL, children défini sur les identifiants des conteneurs d'éléments séparés par des virgules, et la légende. - Publication : envoyez POST /<
IG_ID>/media_publishaveccreation_iddéfini sur l'identifiant du conteneur du carrousel.
Combien d'éléments un carrousel peut-il contenir ?
Jusqu'à 20. Le guide de publication de Meta et le paramètre children de POST /<IG_ID>/media fixent tous deux la limite à 20 images, vidéos ou un mélange des deux. La référence d'erreurs reprend encore l'ancienne formulation : le message du code 100, sous-code 2207028, indique qu'un carrousel doit comporter au moins 2 et au plus 10 éléments. Le nombre que toutes les parties de la documentation de Meta acceptent est donc 2 à 10. Les éléments peuvent être des photos ou des vidéos, mais pas des Reels : un élément de carrousel est toujours un conteneur d'image ou de vidéo.
Comment les images du carrousel sont-elles recadrées ?
Au premier. Chaque image du carrousel est recadrée au ratio d'aspect de la première, et le format par défaut est un carré 1:1. Chaque image doit tout de même respecter les règles habituelles : JPEG, 8 Mo maximum, ratio compris entre 4:5 et 1.91:1. Placez en premier l'image dont vous voulez la forme, ou rendez-les toutes de la même forme avant la publication.
Quels réglages vont sur le carrousel et lesquels sur chaque élément ?
La plupart des réglages au niveau de la publication se trouvent sur le conteneur du carrousel, et non sur les éléments.
- Légende : uniquement sur le conteneur du carrousel ; les éléments n'en acceptent pas.
- Lieu : uniquement sur le conteneur du carrousel.
- Mention générée par IA :
is_ai_generatedse place sur le conteneur du carrousel, et le définir sur un élément renvoie une erreur. - Texte alternatif : pris en charge sur les éléments image, jusqu'à 1 000 caractères chacun.
Comment lit-on un carrousel ?
Comme un seul objet média de type CAROUSEL_ALBUM. GET /<IG_MEDIA_ID>/children liste les photos et vidéos qu'il contient, bien que certains champs, comme permalink, ne fonctionnent pas sur les enfants. Les compteurs de commentaires et de mentions J'aime du carrousel excluent ses enfants, et Meta ne renvoie aucune statistique pour les éléments individuels, seulement pour la publication du carrousel.
Comment un carrousel compte-t-il dans les limites ?
Comme une seule publication. Un compte peut publier 100 publications via l'API sur une fenêtre glissante de 24 heures, et un carrousel en utilise une, quel que soit son nombre d'éléments. Chaque élément reste toutefois un conteneur, et un compte peut créer 400 conteneurs sur 24 heures glissantes : une série de carrousels de dix éléments atteint donc ce plafond avant la limite de publication.
Erreurs courantes
- Mettre la légende sur un élément : les légendes ne sont pas prises en charge sur les éléments de carrousel. Définissez-la une seule fois sur le conteneur du carrousel.
- Ajouter un Reel comme élément : les éléments de carrousel sont des conteneurs d'image ou de vidéo, et un Reel ne peut pas figurer dans un carrousel.
- Mélanger des photos en portrait et en paysage sans vérifier la première : chaque image prend le ratio d'aspect de la première image.
- Attendre des statistiques par diapositive : Meta n'en renvoie aucune pour les médias d'un carrousel, seulement pour la publication.
Les carrousels peuvent aussi être programmés depuis sa propre file d'attente. US$ 9 à US$ 0,75 par connexion et par mois, dégressif à mesure que vous ajoutez des connexions, avec 3 jours d'essai gratuit.
Questions fréquemment posées
Un carrousel Instagram peut-il être programmé via l'API ?
Oui, via une file d'attente, puisque Meta publie un carrousel au moment où son conteneur est publié. publish_instagram_post d'easyCoexistence accepte scheduled_at, de 1 minute à 90 jours à l'avance, pour les carrousels de 2 à 10 éléments.
Un carrousel peut-il être étiqueté comme généré par IA ?
Oui, avec is_ai_generated sur le conteneur du carrousel. Le définir sur un élément renvoie une erreur.
Un carrousel peut-il inclure un Reel ?
Non. Un Reel se publie toujours seul, et les éléments de carrousel sont de simples conteneurs d'image ou de vidéo.
Pourquoi mon carrousel échoue-t-il avec 2207028 ?
Le message de Meta pour ce code indique qu'un carrousel doit comporter au moins 2 et au plus 10 éléments. Un nombre entre 2 et 10 respecte à la fois ce message et la limite de 20 du guide de publication : ajustez donc les éléments, puis recréez le conteneur du carrousel.
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