Limites de légende Instagram : caractères, hashtags et tags @ dans l'API
L'API Instagram publie une légende de 2 200 caractères maximum avec une photo, un Reel ou un carrousel, avec 20 tags @ au maximum. En novembre 2026, le Centre d'aide Instagram autorise 5 hashtags par publication, alors que la référence API de Meta en indique encore 30 : restez à 5. Les comptes mentionnés reçoivent une notification à la publication, et une légende trop longue échoue avec le code 36004, sous-code 2207010.
easyCoexistence publie une photo, un carrousel ou un Reel avec sa légende via publish_instagram_post, depuis Claude, ChatGPT ou votre propre code, en définissant la légende une seule fois sur un carrousel, et list_social_posts relit la légende de chaque publication.
Nombre maximal de caractères qu'une légende peut contenir via l'API Instagram.
Nombre maximal de hashtags qu'autorise désormais le Centre d'aide Instagram sur une publication, en légende ou en commentaires.
Nombre maximal de hashtags par légende dans la référence API de Meta, qui donne encore l'ancien chiffre.
Nombre maximal de tags @ dans une légende ; au-delà, retour du code 100, sous-code 2207040.
Sous-code d'erreur, sous le code 36004, pour une légende plus longue que ce qu'Instagram autorise.
media_publish peut réussir avec config_issue CAPTION_NOT_ATTACHED : la publication est en ligne sans sa légende.
Quelles sont les limites des légendes ?
Trois, toutes sur le paramètre caption du conteneur média. Une légende peut inclure des hashtags, écrits #tag, et des noms d'utilisateur de comptes Instagram, écrits @nomdutilisateur, dans les limites suivantes :
- Longueur : jusqu'à 2 200 caractères.
- Hashtags : jusqu'à 5 par publication selon le Centre d'aide Instagram, en comptant ceux des commentaires ; la référence API de Meta en indique encore 30.
- Tags @ : jusqu'à 20, et chaque compte mentionné est notifié à la publication.
Quelles publications acceptent une légende ?
Les photos, Reels et carrousels. Sur un carrousel, la légende se place sur le conteneur du carrousel, car les images et vidéos qu'il contient n'en acceptent pas, et la référence de Meta ne décrit aucune légende pour les Stories. Un texte destiné à une Story doit donc figurer dans l'image ou la vidéo elle-même.
Que se passe-t-il quand une légende dépasse une limite ?
La requête échoue avec une erreur qui nomme le problème. Une légende trop longue renvoie le code 36004, sous-code 2207010, et la correction indiquée par Meta rappelle les limites : 2 200 caractères au maximum, 30 hashtags et 20 tags @. Plus de 20 tags @ peut aussi renvoyer le code 100, sous-code 2207040. Raccourcissez la légende, puis renvoyez la requête.
Quand les comptes mentionnés sont-ils notifiés ?
À la publication du conteneur, et non à sa création. Les comptes mentionnés dans une légende reçoivent alors une notification, si bien qu'un conteneur préparé à l'avance n'alerte personne tant qu'il n'est pas en ligne. La limite de Meta de 20 tags @ par légende s'applique à ces mentions.
Une publication peut-elle être en ligne sans sa légende ?
Oui. media_publish peut réussir avec le champ config_issue défini sur CAPTION_NOT_ATTACHED, ce qui signifie que le média a été publié sans sa légende. Meta parle de succès partiel : l'identifiant du média est valide, donc vérifiez la publication existante au lieu de la publier à nouveau.
Peut-on modifier une légende après la publication ?
La référence média de Meta documente une seule mise à jour pour un média publié : activer ou désactiver les commentaires avec POST /<IG_MEDIA_ID> et comment_enabled. Elle ne prévoit aucun moyen de modifier une légende. Vérifiez donc le texte, les hashtags et les tags @ avant la création du conteneur.
Erreurs courantes
- Ne vérifier que la longueur. Une légende de moins de 2 200 caractères enfreint quand même les limites avec plus de 5 hashtags, règle actuelle d'Instagram, ou plus de 20 tags @.
- Légender les éléments d'un carrousel. Seul le conteneur du carrousel accepte une légende.
- Rédiger une légende pour une Story. Le conteneur Story n'en accepte aucune : placez le texte dans l'image ou la vidéo.
- Republier après CAPTION_NOT_ATTACHED. La première publication est déjà en ligne, et une seconde publication crée un doublon.
De US$ 9 à US$ 0,75 par connexion et par mois, en baisse à mesure que vous ajoutez des connexions, avec un essai gratuit de 3 jours.
Questions fréquemment posées
Que signifie l'erreur 2207040 sur Instagram ?
La légende contient plus de 20 tags @, renvoyés sous le code 100. Retirez des tags jusqu'à en garder 20 ou moins, puis renvoyez la requête.
La limite de 5 hashtags d'Instagram inclut-elle les hashtags des commentaires ?
Oui. Le Centre d'aide Instagram autorise jusqu'à 5 hashtags par publication, en comptant ceux de la légende et ceux des commentaires.
Peut-on désactiver les commentaires d'une publication déjà en ligne via l'API ?
Oui. POST /<IG_MEDIA_ID> avec comment_enabled défini sur false désactive les commentaires, et true les réactive. C'est la seule mise à jour que la référence média de Meta documente pour un média publié.
Que signifie l'erreur 2207010 ?
La légende est plus longue que ce qu'Instagram autorise. Raccourcissez-la à 2 200 caractères ou moins, puis renvoyez la requête.
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