Comment vérifier le statut d'une publication TikTok via l'API
TikTok publie les publications API de façon asynchrone : l'appel de publication renvoie un share_id, et GET /business/publish/status/ avec cet identifiant en publish_id indique où en est la publication. Le statut vaut PROCESSING_DOWNLOAD pendant que TikTok récupère le fichier, PUBLISH_COMPLETE une fois la publication validée puis publiée, ou FAILED avec une raison comme frame_rate_check_failed.
easyCoexistence publie sur TikTok avec publish_tiktok_post et suit chaque publication avec get_tiktok_publish_status, depuis Claude, ChatGPT ou votre propre code, afin que votre IA voie le statut de TikTok et toute raison d'échec telle qu'elle est.
Délai de disponibilité des post_ids après PUBLISH_COMPLETE : TikTok recommande de réessayer au bout de trois minutes s'ils manquent.
Estimation générale de TikTok pour le téléchargement d'un fichier de 1 Go ; la durée réelle dépend de la taille et du réseau.
Attente habituelle maximale, une fois l'envoi terminé, avant qu'une publication devienne publique ; la modération manuelle peut prendre plus de temps.
Délai de téléchargement au-delà duquel TikTok fait échouer une publication avec video_pull_failed ou photo_pull_failed.
Pourquoi faut-il suivre une publication TikTok ?
Parce que TikTok la traite en arrière-plan. L'appel de publication lance une tâche et renvoie aussitôt un share_id ; TikTok télécharge ensuite le fichier depuis son URL, vérifie le format, lance la modération et rend la publication publique. Une publication peut encore échouer alors que l'appel lui-même a réussi.
Quels sont les statuts ?
GET /business/publish/status/ prend le business_id du compte et le share_id en publish_id, et renvoie l'un de quatre statuts :
PROCESSING_DOWNLOAD: TikTok télécharge le contenu depuis son URL.PUBLISH_COMPLETE: la publication a été validée par la modération et publiée ;post_idsla liste dès qu'elle est visible publiquement.- FAILED : la publication s'est arrêtée, et reason indique pourquoi.
SEND_TO_USER_INBOX: un brouillon a été envoyé et TikTok a notifié la boîte de réception du créateur ; cela ne concerne que les brouillons.
Combien de temps prend la publication ?
TikTok ne donne pas de délai fixe. Le téléchargement dépend de la taille du fichier et du réseau ; l'estimation générale de TikTok est de 30 minutes pour un fichier de 1 Go, avec une heure comme limite. Ensuite, une publication devient normalement publique en 2 minutes, ou plus tard si une modération manuelle est nécessaire, et ses post_ids peuvent mettre jusqu'à trois minutes de plus à apparaître dans le statut.
Que signifient les raisons d'échec ?
reason indique ce qui a arrêté la publication. Certaines imposent de modifier le fichier, d'autres permettent qu'une nouvelle tentative réussisse :
file_format_check_failed,duration_check_failed,frame_rate_check_failed,picture_size_check_failed: le fichier ne respecte pas une règle de format, et TikTok les marque comme ne pouvant pas être relancés.video_pull_failed,photo_pull_failed: TikTok n'a pas pu télécharger le fichier, ou pas dans l'heure ; réessayez une fois l'URL publiquement accessible.- internal : une partie du service TikTok était indisponible, et une nouvelle tentative convient.
spam_risk_too_many_posts,spam_risk,spam_risk_text: TikTok a arrêté la publication pour le volume, le comportement ou le contenu de la légende.auth_removed: le compte a retiré l'accès de l'application pendant le traitement, et TikTok demande de ne pas réessayer.spam_risk_user_banned_from_posting: le compte est banni et ne peut plus publier.
À quoi sert le post ID ?
À retrouver la publication ensuite. La documentation de TikTok transmet les post IDs à /business/video/list/ dans filters.video_ids pour lire les métriques des publications. Les appels de commentaires, de leur côté, prennent l'item_id d'une publication issu de la liste vidéo du compte comme video_id, ce que prennent aussi les outils de commentaires d'easyCoexistence comme post_id.
Comment easyCoexistence suit-il une publication ?
publish_tiktok_post renvoie le share_id de TikTok avec une mention indiquant que TikTok traite la publication, et get_tiktok_publish_status prend ce share_id et renvoie le statut de TikTok tel qu'il est, avec la raison lorsqu'il y en a une. Demandez à votre IA de revérifier au bout de quelques minutes plutôt qu'immédiatement.
Erreurs courantes
- Republier parce que rien n'apparaît encore. Le premier appel n'a fait que lancer la tâche : vérifiez son statut avant d'envoyer de nouveau la publication.
- Considérer PUBLISH_COMPLETE sans post_ids comme une erreur. Les identifiants peuvent mettre jusqu'à trois minutes de plus : revérifiez à ce moment-là.
- Relancer un échec de format avec le même fichier. file_format_check_failed et les autres échecs de vérification exigent un fichier corrigé.
- Mettre l'URL hors ligne pendant le téléchargement. TikTok fait échouer la publication avec video_pull_failed ou photo_pull_failed lorsqu'il ne peut pas récupérer le fichier.
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
Qu'est-ce qu'un share_id sur TikTok ?
L'identifiant d'une tâche de publication, renvoyé par les endpoints de publication de vidéo et de photo. Il est transmis à l'appel de statut comme publish_id.
Existe-t-il un webhook pour le statut de publication TikTok ?
Oui. Une application abonnée avec event_type VIDEO via /business/webhook/update/ reçoit les événements de publication de TikTok, comme post.publish.failed avec sa raison et son publish_id, à la place de vérifications de statut répétées.
Pourquoi une publication TikTok publiée n'a-t-elle pas encore de post ID ?
TikTok peut mettre jusqu'à trois minutes après PUBLISH_COMPLETE pour renvoyer les post_ids, et ne les renvoie que pour les publications visibles publiquement.
Une publication TikTok en échec peut-elle être relancée ?
Cela dépend de la raison. Les échecs de téléchargement et internes peuvent être relancés ; les échecs de format, de durée, de fréquence d'images et de taille d'image exigent un fichier corrigé.
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