Limites de débit de l'API TikTok : requêtes par compte, par application et par endpoint
L'API for Business de TikTok limite les appels à trois niveaux à la fois : 40 par minute et par compte autorisé sur chaque endpoint de l'Accounts API, un budget global par application développeur de 600 par minute en Basic et 1 000 au-delà, et des limites par endpoint et par application de 10 par seconde, 600 par minute et 864 000 par jour en Basic, portées à 50 par seconde en Ultimate.
easyCoexistence publie des publications, lit les statistiques et répond aux commentaires sur TikTok pour Claude, ChatGPT ou votre propre code, via l'API for Business de TikTok.
Requêtes par minute et par compte autorisé TikTok sur chaque endpoint de l'Accounts API, un chiffre unique quel que soit le niveau de l'application.
Budget pour l'ensemble des endpoints de l'Accounts API réunis, par application développeur, en Advanced, Premium et Ultimate ; Basic reçoit 600.
Limite par endpoint en Ultimate, le niveau le plus élevé, à côté de 3 000 requêtes par minute et 4 320 000 par jour.
Statut renvoyé par TikTok avec ses codes de retour, y compris les codes 4xxxx comme 40100 ; seul le code 0 signifie un succès.
Limite de débit pour chaque endpoint de la Discovery API, par application développeur.
Moment de la réinitialisation des limites quotidiennes ; après une limite par minute, TikTok demande une pause de 5 minutes à la place.
Quelles limites s'appliquent à un appel à l'API TikTok ?
Jusqu'à trois compteurs se déclenchent à chaque appel de l'Accounts API, et certains produits et actions tiennent leurs propres décomptes. TikTok garde les compteurs des endpoints indépendants, si bien qu'un endpoint peut être bridé alors que les autres endpoints de l'application répondent encore :
Que permettent les quatre niveaux d'application ?
Toutes les applications développeur démarrent en Basic, et TikTok les fait monter d'un niveau à la fois sur demande, dans Mes applications, Détail de l'application, Autorisation, avec un motif. Chaque niveau fixe ce qu'un seul endpoint peut consommer de l'application, à côté du budget global pour les appels à l'Accounts API :
Un niveau supérieur augmente-t-il le budget de l'Accounts API ?
Une seule fois. Le passage de Basic à Advanced fait passer le budget global de l'Accounts API de 600 à 1 000 requêtes par minute, qui reste à 1 000 jusqu'à Premium et Ultimate, tandis que les limites par endpoint, par seconde et par jour continuent de monter. La limite de 40 par minute et par compte et endpoint ne change pas du tout avec le niveau : un compte très sollicité est donc bridé à 40 appels par minute sur un endpoint, quel que soit le niveau de l'application.
Comment les limites s'additionnent-elles sur plusieurs comptes ?
La limite par compte se multiplie avec chaque compte ; le budget de l'application, lui, ne se multiplie pas. Dix comptes peuvent chacun faire 40 appels par minute vers /business/comment/list/, soit 400 au total, mais vingt faisant la même chose en demanderaient 800, au-delà des 600 dont dispose une application Basic pour l'ensemble de ses appels à l'Accounts API, avant même de compter les autres endpoints. Au-dessus de Basic, ce budget partagé plafonne à 1 000 par minute.
Que se passe-t-il quand un appel dépasse une limite ?
TikTok bride cet endpoint. Son guide des limites de débit désigne le code 40100 pour un appel bridé, qui arrive dans le corps d'une réponse HTTP 200 ; l'endpoint reste fermé pendant 5 minutes après une limite par minute, ou jusqu'à la réinitialisation des compteurs quotidiens à 00:00 UTC après une limite quotidienne, tandis que les autres endpoints de l'application continuent de répondre. La détection du code dans le programme et les nouvelles tentatives correctes font l'objet de la page consacrée à l'erreur 40100.
Les plafonds de publication sont-ils des limites de débit ?
Non, ils comptent des publications et non des appels, et ils ont une page à part. TikTok autorise un compte à publier six publications par minute et 15 par jour via /business/video/publish/, et de même via /business/photo/publish/. Une publication au-delà de ce nombre échoue avec spam_risk_too_many_posts dans son statut de publication, alors qu'une limite de requêtes refuse l'appel lui-même.
Quelles habitudes consomment le plus vite les limites ?
L'interrogation répétée. Vérifier un statut de publication ou une liste de commentaires à intervalles réguliers consomme les 40 appels par minute du compte sur cet endpoint, qu'il se soit passé quelque chose ou non. Les webhooks de TikTok existent pour l'éviter : les événements de publication signalent chaque étape d'une publication, et comment.update signale un nouveau commentaire dans les cinq minutes. La lecture par pages, de 20 publications ou 30 commentaires par appel, et la récupération des mentions une fois par jour maintiennent le reste à un niveau bas.
Comment easyCoexistence gère-t-il un appel TikTok bridé ?
Il transmet la réponse de TikTok au lieu de la masquer. Un appel d'outil bridé par TikTok, comme list_social_comments, reply_to_comment ou get_tiktok_publish_status, revient à l'IA sous forme d'erreur qui nomme le code 40100 avec le message de TikTok, et n'est pas relancé de lui-même. Les publications suivent un autre chemin : publish_tiktok_post confie chacune à la file d'attente d'easyCoexistence, tout de suite ou à une heure fixée :
- La file d'attente patiente, puis réessaie après 5 minutes, 30 minutes et 2 heures lorsqu'une réponse revient en HTTP 429.
- TikTok envoie 40100 dans une réponse HTTP 200 : une publication TikTok bridée échoue donc avec le message de TikTok et attend sous « Action requise » qu'on clique sur « Réessayer ».
- Un 40100 lors d'une vérification de statut de la file fait aussi échouer la publication, alors que TikTok peut déjà l'avoir publiée : vérifiez les dernières publications du compte avant de réessayer.
- Une publication qui échoue en arrière-plan envoie un e-mail au propriétaire, au plus une fois par canal toutes les 3 heures.
Quels appels TikTok easyCoexistence fait-il pour un compte ?
Peu, et ils comptent dans les limites du compte comme vos propres appels :
- /business/get/ environ toutes les 6 heures, pour vérifier que le compte répond encore.
- Un appel de publication par publication, puis /business/publish/status/ environ toutes les 20 secondes jusqu'à ce que TikTok termine ou fasse échouer la publication, pendant 2 heures au plus.
- Avec des règles de commentaires ou des automatisations actives, un appel /business/comment/list/ par nouveau commentaire de premier niveau pour lire son auteur, et un appel pour chaque réponse publiée.
- Des appels d'outils seulement lorsque l'IA ou votre code les demande, avec 20 publications ou 30 commentaires par lecture.
Erreurs courantes
- Détecter le bridage à partir du statut HTTP. TikTok répond 40100 avec HTTP 200, donc un contrôle sur res.ok ou sur 429 le manque ; lisez le code dans le corps de la réponse.
- Relever le niveau de l'application pour corriger un seul compte très sollicité. Les 40 appels par minute par compte et endpoint restent identiques aux quatre niveaux, donc répartissez les appels de ce compte dans le temps.
- Récupérer les données Mentions plusieurs fois par jour. TikTok les rafraîchit une fois, entre minuit et 7 h UTC, et recommande un appel par endpoint, par compte et par jour.
Il renvoie le code et le message de TikTok lorsqu'un appel est bridé, et suit chaque publication jusqu'à ce que TikTok la termine ou la fasse échouer. 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
Quelle est la limite de débit de l'API TikTok par compte ?
40 requêtes par minute sur chaque endpoint de l'Accounts API pour chaque compte TikTok autorisé, dans le budget global de l'application développeur : 600 par minute en Basic, 1 000 au-delà.
Les limites de débit TikTok sont-elles comptées par endpoint ?
Oui. Le guide de TikTok indique que les limites propres à chaque endpoint sont indépendantes, donc atteindre la limite d'un endpoint n'empêche pas les appels vers un autre.
Comment augmenter ma limite de débit de l'API TikTok ?
Faites la demande dans Mes applications, Détail de l'application, Autorisation, en indiquant un motif. Les niveaux montent d'un cran à la fois, de Basic à Advanced, puis Premium, puis Ultimate.
Les appels passant par easyCoexistence comptent-ils dans les limites de TikTok ?
Oui. Ils s'exécutent au nom du compte connecté avec son token, donc ils comptent dans ses 40 appels par minute et par endpoint, comme tout autre appel pour ce compte.
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