Limites de débit de l'API Instagram : appels sur 24 heures et débit des DM
L'API Instagram attribue à chaque application un budget d'appels pour chaque compte qu'elle gère : 4 800 appels multipliés par les impressions du compte sur 24 heures glissantes. La messagerie suit des limites distinctes par compte : 100 messages texte par seconde via la Send API, 10 pour l'audio ou la vidéo, et 750 réponses privées par heure. Au-delà de ce budget, les appels échouent avec l'erreur 80002, et l'en-tête X-Business-Use-Case-Usage indique la part consommée.
easyCoexistence peut transmettre à votre endpoint les commentaires, mentions et DM de chaque compte Instagram dès leur arrivée : un agent réagit aux événements au lieu d'interroger l'API.
Appels par impression qu'une application peut effectuer pour un compte sur 24 heures glissantes, messagerie exclue.
Réponses privées par compte aux commentaires sous les publications et les Reels ; les commentaires d'un Live autorisent 100 par seconde.
Appels à la Send API par compte pour le texte, les liens, les réactions et les stickers ; l'audio ou la vidéo en autorise 10.
Publications par compte via l'API sur une période glissante de 24 heures, contrôlées lors de la publication d'un conteneur.
Le code d'erreur reçu par une application qui atteint la limite de débit Business Use Case d'Instagram.
Comment Instagram compte-t-il les appels API ?
Par couple application et compte, sur 24 heures glissantes. Les endpoints d'Instagram relèvent des limites de débit Business Use Case de Meta, et le nombre d'appels d'une application pour un compte professionnel est plafonné à 4 800 fois les impressions de ce compte : le nombre de fois où l'un de ses contenus est apparu à l'écran de quelqu'un au cours des 24 dernières heures. La messagerie est comptée séparément, et Business Discovery et Hashtag Search suivent à la place les limites de débit de la plateforme Meta.
L'usage d'un compte affecte-t-il celui d'un autre ?
Pas avec cette formule. Meta tient le décompte pour chaque couple application et utilisateur de l'application, donc une application qui sert de nombreux comptes professionnels dispose d'un budget distinct pour chacun, calculé sur ses propres impressions. Un compte dont le contenu est vu plus souvent obtient davantage d'appels, et un compte nouveau ou peu actif en obtient moins.
Quelles sont les limites de la messagerie ?
Distinctes du décompte sur 24 heures, et définies par compte professionnel Instagram et par API :
- Send API : 100 appels par seconde pour le texte, les liens, les réactions et les stickers, et 10 par seconde pour l'audio ou la vidéo.
- Réponses privées : 750 appels par heure pour les commentaires sous les publications et les Reels, et 100 par seconde pour les commentaires d'un Live.
- Conversations API : 2 appels par seconde.
Où se situe le plafond de publication ?
À côté du budget d'appels, sous forme de décompte distinct des publications. Le guide de publication de Meta autorise 100 publications via l'API par compte sur une période glissante de 24 heures, vérifiées à chaque appel de POST /<IG_ID>/media_publish ; un appel au-delà échoue avec le code 9, sous-code 2207042. Ce qu'une publication peut contenir, le nombre de conteneurs et content_publishing_limit relèvent des limites de publication.
Comment Meta signale-t-il l'usage ?
Dans un en-tête de réponse. Les appels soumis aux limites Business Use Case renvoient X-Business-Use-Case-Usage, une chaîne JSON indexée par un ID. Pour Instagram, son type vaut instagram ; call_count, total_cputime et total_time sont des pourcentages de l'allocation utilisée, et les appels peuvent être limités dès que le temps CPU ou le temps total atteint 100. estimated_time_to_regain_access indique le nombre de minutes avant qu'une application limitée puisse de nouveau appeler.
x-business-use-case-usage: {
"<ID>": [
{
"type": "instagram",
"call_count": 28,
"total_cputime": 12,
"total_time": 15,
"estimated_time_to_regain_access": 0
}
]
}Que se passe-t-il à la limite ?
Les appels échouent jusqu'à ce que le décompte repasse sous le seuil. Pour la limite Business Use Case d'Instagram, le code d'erreur est 80002, et Meta prévient que les appels effectués pendant la limitation s'ajoutent quand même au décompte, ce qui repousse le moment où les appels repassent. La messagerie est comptée à part de ce budget, selon ses propres limites par seconde et par heure.
Comment rester sous les limites ?
Les conseils de Meta, appliqués à Instagram :
- Recevez commentaires, mentions et messages par webhooks plutôt que par interrogation ; Meta les recommande pour réduire le nombre d'appels nécessaires à une application.
- Répartissez les appels régulièrement plutôt que de les envoyer par rafales.
- Ne demandez que les champs dont vous avez besoin, et évitez les requêtes portant sur des données qui se chevauchent.
- Comptez les appels d'un lot un par un : Meta compte chaque requête qu'il contient comme un appel distinct.
- Arrêtez-vous en cas de limitation, et reprenez après
estimated_time_to_regain_access.
Erreurs courantes
- Relancer en boucle un appel limité. Meta compte les appels effectués pendant la limitation, ce qui retarde le moment où les appels repassent.
- Interroger en continu les nouveaux commentaires ou DM. Les webhooks les livrent dès leur arrivée et font baisser le nombre d'appels.
- Lire estimated_time_to_regain_access en secondes. Meta l'exprime en minutes ; un client qui attend ce nombre de secondes rappelle l'API alors qu'il est toujours limité.
- Ne surveiller que call_count. total_cputime et total_time comptent aussi dans la limitation : suivez donc les trois pourcentages de l'en-tête.
Quand Meta limite un appel, Claude, ChatGPT ou votre propre code reçoivent le code d'erreur et le message de Meta. Le service vérifie aussi chaque compte connecté toutes les 6 heures. 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
Combien d'appels API un compte Instagram peut-il effectuer par jour ?
4 800 par impression reçue par ses contenus au cours des 24 dernières heures, décompté par application et par compte : un compte vu plus souvent obtient donc davantage d'appels.
Que signifie l'erreur 80002 de l'API Instagram ?
La limite de débit Business Use Case d'Instagram : l'application a épuisé son budget d'appels pour ce compte. Arrêtez les appels et attendez le délai indiqué par l'en-tête d'usage.
Les DM comptent-ils dans la formule des 4 800 appels ?
Non. La messagerie en est exclue et dispose de ses propres limites par compte, comme 100 messages texte par seconde via la Send API.
Les réponses privées partagent-elles la limite des DM ?
Non. Meta leur accorde une limite propre : 750 par heure et par compte pour les commentaires sous les publications et les Reels, et 100 par seconde pour les commentaires d'un Live, distinctes des limites de la Send API pour les DM.
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