Publier des Stories Instagram via l'API
L'API Instagram publie une Story à partir d'une seule image ou d'une seule vidéo, située à une URL publique : vous créez un conteneur avec media_type STORIES, puis vous le publiez. Les images sont des JPEG jusqu'à 8 Mo, les vidéos durent de 3 à 60 secondes et pèsent jusqu'à 100 Mo, Meta recommande un cadre 9:16, et la Story disparaît au bout de 24 heures, comme dans l'application.
easyCoexistence publie des Stories image et vidéo avec publish_instagram_post depuis Claude, ChatGPT ou votre propre code, et peut les programmer depuis sa propre file d'attente.
La plus longue vidéo de Story que l'API publie ; la plus courte fait 3 secondes, et le fichier peut atteindre 100 Mo.
La plus grande image de Story, qui doit être un JPEG.
Durée pendant laquelle une Story publiée reste visible avant d'expirer.
Les valeurs de métriques de Story aussi basses reviennent sous forme de code d'erreur 10, pas assez de spectateurs, au lieu d'un nombre.
Comment publier une Story ?
Avec les deux mêmes appels que pour toute publication. POST /<IG_ID>/media avec media_type défini sur STORIES et soit image_url, soit video_url, puis POST /<IG_ID>/media_publish avec l'ID du conteneur. Une Story vidéo est d'abord traitée : son status_code doit donc afficher FINISHED avant de pouvoir être publiée.
La référence de Meta décrit la légende des photos, vidéos et carrousels, pas celle des Stories : les mots destinés au spectateur doivent donc figurer dans l'image ou la vidéo elle-même.
Quelles sont les exigences des médias pour une Story ?
Meta recommande un cadre 9:16 pour les images comme pour les vidéos de Story, afin d'éviter le recadrage ou les espaces vides.
- Image : JPEG, jusqu'à 8 Mo, en sRGB ; les autres espaces colorimétriques sont convertis.
- Vidéo : MOV ou MP4 avec vidéo H.264 ou HEVC et audio AAC, de 23 à 60 images par seconde, jusqu'à 1920 pixels de large et 25 Mbps.
- Durée de la vidéo : de 3 à 60 secondes, pour un fichier pouvant atteindre 100 Mo.
- Format de la vidéo : tout rapport entre 0,1:1 et 10:1 est accepté.
Qu'une Story peut-elle contenir ?
L'image ou la vidéo elle-même, et des mentions d'autres comptes : depuis juillet 2025, le paramètre user_tags identifie des comptes publics dans les Stories image et vidéo, avec des coordonnées x et y facultatives. Meta ne prend pas en charge la publication de stickers via l'API : les liens, sondages et lieux restent donc dans l'application.
Que se passe-t-il après la publication d'une Story ?
Elle reste en ligne pendant 24 heures puis expire, comme dans l'application. Meta liste les Stories en ligne sur un edge stories distinct ; la liste des médias du compte, GET /<IG_ID>/media, ne les inclut pas. Une fois relue, une Story a un media_type IMAGE ou VIDEO, comme tout autre média : il faut donc distinguer les Stories selon l'endroit où on les a trouvées, et non selon leur type.
Comment arrivent les réponses et les mentions ?
En messages privés. Une réponse à une Story arrive sur le webhook messages sous forme de DM, avec l'ID et l'URL de la Story jointes, et ouvre la fenêtre habituelle de 24 heures pour répondre. Quand quelqu'un mentionne le compte dans sa propre Story, la mention arrive aussi comme message, avec une pièce jointe de type story_mention. L'API Mentions de Meta ne couvre pas les Stories.
Quelles métriques une Story remonte-t-elle ?
La portée, les vues, les partages, les réponses, les abonnements, les visites de profil, l'activité du profil, la navigation, les clics sur les liens, les republications et le total des interactions, lus via l'endpoint d'insights de média. Elles ne sont disponibles que 24 heures, et une valeur inférieure à 5 renvoie le code d'erreur 10, pas assez de spectateurs, au lieu d'un nombre. Les réponses des personnes en Europe et au Japon sont exclues du décompte, et une Story créée par un compte de ces régions affiche 0 réponse.
Erreurs courantes
- Prévoir un sticker de lien. L'API ne publie pas de stickers : un lien doit donc atteindre les gens autrement, par exemple par une réponse en DM.
- Lire les métriques d'une Story le lendemain. Elles ne sont disponibles que 24 heures : il faut donc les collecter pendant que la Story est en ligne.
- Chercher une Story publiée dans la liste des médias du compte. Les Stories en ligne figurent sur un edge stories séparé.
- Publier une vidéo en paysage comme Story. Meta recommande 9:16, et d'autres formats peuvent afficher de l'espace vide ou être recadrés.
Les réponses à une Story arrivent en DM ; elles peuvent être transmises à votre endpoint ou recevoir une réponse grâce à une automatisation. De 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
Peut-on ajouter un sticker de lien à une Story via l'API ?
Non. Meta ne prend pas en charge la publication de stickers via l'API, liens, sondages et lieux compris. Mentionner un autre compte sans sticker est en revanche pris en charge.
Où une Story publiée figure-t-elle dans l'API ?
Sur l'edge stories distinct du compte tant qu'elle est en ligne. GET /<IG_ID>/media n'inclut pas les Stories, et une Story est relue comme IMAGE ou VIDEO.
Une Story peut-elle avoir une légende via l'API ?
Non. La référence de Meta ne décrit pas de légende pour les Stories, et publish_instagram_post envoie une Story sans légende : les mots destinés au spectateur doivent donc figurer dans l'image ou la vidéo elle-même.
Combien de temps les insights d'une Story sont-ils disponibles ?
Pendant 24 heures. Meta ne rend les métriques d'une Story disponibles que pendant cette durée : il faut donc les lire pendant que la Story est en ligne.
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