Scopes de la TikTok API for Business : ce que débloque chaque permission
L'API for Business de TikTok accorde l'accès en deux niveaux. L'application développeur détient des permissions sous TikTok Accounts, comme Video Publish et Manage Account Comment, qui ouvrent des endpoints. L'autorisation du titulaire du compte donne au token d'accès des scopes, comme user.insights et video.list, qui déterminent les champs renvoyés. /tt_user/token_info/get/ liste les scopes portés par un token.
easyCoexistence demande au titulaire du compte TikTok les permissions que son application détient en une seule connexion, afin que Claude, ChatGPT ou votre propre code puissent publier, gérer les commentaires et lire les statistiques via ses outils, et que get_social_credentials donne à votre propre code le même token pour les autres endpoints de l'API Accounts.
Scope ID de TikTok Accounts, la permission de premier niveau au-dessus des endpoints de profil, de post, de commentaire et de publication de l'API Accounts.
Scope derrière is_business_account et has_advanced_access dans les données de profil d'un compte.
Scope que le titulaire doit accorder, et garder actif, pour que l'application reçoive les événements webhook comment.update.
Scope nécessaire pour importer une publication en brouillon au lieu de la publier.
Nombre de jours ouvrés que peut prendre l'examen par TikTok d'une modification des permissions d'une application développeur.
Quels sont les deux niveaux de permissions TikTok ?
Les permissions de l'application et les scopes du token. Les permissions de l'application se choisissent dans My Apps, puis l'application, Scope of permission, et TikTok les examine ; elles existent en trois niveaux, et une permission de premier niveau couvre tous les endpoints en dessous. Les scopes du token sont ce que le titulaire du compte a approuvé lors de l'autorisation de l'application, renvoyés sous la forme scope, une chaîne séparée par des virgules, avec chaque token. Un appel exige la permission de l'application pour son endpoint, et certains champs de réponse exigent aussi un scope sur le token.
Quelle permission de l'application ouvre chaque endpoint ?
La référence de l'API de TikTok indique, pour chaque endpoint de l'API Accounts, la permission sous TikTok Accounts qui l'ouvre, ou aucune. Sa référence des scopes de permission et son guide webhook appellent les mêmes groupes Business User, Business Media, Business Comment et Business Content, donc attendez-vous aux deux jeux de noms :
Quels scopes de token débloquent quels champs ?
Les références de TikTok pour /business/get/ et /business/video/list/ donnent une permission requise pour chaque champ de réponse, et deux autres fonctionnalités nomment un scope qui leur est propre :
- user.info.basic :
display_nameetprofile_image. - user.info.username : username, qui exigeait user.info.basic jusqu'en juin 2023.
- user.info.profile :
profile_deep_link,bio_descriptionetis_verified. - user.info.stats :
following_count,followers_count,total_likesetvideos_count. - user.account.type :
is_business_accountethas_advanced_access. - user.insights : les métriques quotidiennes du compte et la répartition des abonnés par âge, genre, pays et ville.
- video.list : les champs de publication comme
item_id, caption,share_url, likes, comments, shares, reach etvideo_views. - video.insights : le temps de visionnage, le taux de visionnage complet, la rétention, les sources de trafic, la répartition des spectateurs et les clics générés par une publication.
- comment.list : le webhook comment.update, que TikTok décrit comme la lecture des commentaires et réponses du contenu de l'application.
- video.upload : importer une publication vidéo ou photo en brouillon, avec
upload_to_draftouis_draft.
Comment voir les scopes d'un token ?
Interrogez /tt_user/token_info/get/, qui prend l'app_id et le token d'accès et renvoie le scope du token ainsi que le creator_id du compte. Les exemples de chaînes de scope de TikTok incluent aussi video.publish et comment.list.manage, dont les noms correspondent aux endpoints de publication et de gestion des commentaires, bien que ses références ne rattachent aucun champ à l'un ou l'autre.
curl -X POST 'https://business-api.tiktok.com/open_api/v1.3/tt_user/token_info/get/' \
-H 'Content-Type: application/json' \
-d '{"app_id": "<APP_ID>", "access_token": "<ACCESS_TOKEN>"}'
{
"code": 0,
"message": "OK",
"request_id": "<REQUEST_ID>",
"data": {
"app_id": "<APP_ID>",
"creator_id": "<OPEN_ID>",
"scope": "video.publish,user.info.basic,video.list,user.insights,comment.list.manage,video.insights,comment.list"
}
}Que demande la connexion TikTok d'easyCoexistence ?
Les permissions que son application développeur détient, toutes affichées sur la page de consentement de TikTok. easyCoexistence envoie le titulaire du compte vers l'URL d'autorisation du titulaire de compte TikTok que génère le portail de TikTok pour son application, qui nomme déjà ces permissions, et n'ajoute qu'une valeur state qui lui est propre. Le titulaire approuve ce que TikTok affiche, et la chaîne de scope renvoyée par TikTok est stockée avec la connexion. Les endpoints qu'easyCoexistence appelle ensuite pour le compte :
- /business/get/ pour le profil, les métriques quotidiennes et la répartition des abonnés.
- /business/video/list/ pour les publications et leurs métriques.
- /business/video/publish/, /business/photo/publish/ et /business/publish/status/ pour la publication.
- /business/comment/list/, /business/comment/reply/create/, /business/comment/hide/ et /business/comment/delete/ pour les commentaires.
- /business/webhook/update/, au niveau de l'application, pour le webhook de commentaires.
Comment ajouter une permission plus tard ?
En deux étapes, une par niveau. Pour l'application, ouvrez My Apps, l'application, Scope of permission, modifiez-le, indiquez une raison correspondant aux nouveaux scopes et soumettez ; l'examen de TikTok peut prendre deux à trois jours ouvrés, et depuis le 20 mars 2026, une demande qui inclut TikTok Accounts exige d'abord le formulaire de demande d'accès à l'API Accounts. Pour le token, le titulaire autorise à nouveau l'application, car un token conserve les scopes approuvés au moment de son émission.
Que se passe-t-il quand une permission manque ?
Pour un appel, le code de retour de TikTok est 40001, pas de permission pour effectuer l'opération concernée, et sa solution renvoie à la référence des scopes de permission. Pour un champ, les références ne le rendent disponible qu'une fois le scope accordé par le titulaire, et leur solution consiste à faire réautoriser l'application par le titulaire avec ce scope. Vérifiez le scope du token avec /tt_user/token_info/get/ avant de demander.
Erreurs courantes
- Attendre que les comptes connectés gagnent seuls une nouvelle permission de l'application. Leurs tokens conservent les scopes approuvés à l'autorisation tant que chaque titulaire n'a pas réautorisé l'application.
- Demander is_business_account sans user.account.type. TikTok ne rend ce champ et has_advanced_access disponibles qu'aux tokens portant ce scope.
- Attendre comment.update sans comment.list. TikTok n'envoie les événements de commentaire que tant que l'autorisation du titulaire avec ce scope reste valide.
- Chercher dans le token les noms de permission de l'application. La chaîne de scope utilise des noms comme video.list, alors que des noms comme Get Account Media relèvent des paramètres de l'application.
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
Quels scopes utilise l'API for Business de TikTok ?
Des scopes de token comme user.info.basic, user.info.stats, user.insights, video.list, video.insights, comment.list et video.upload, accordés par le titulaire du compte en plus des permissions TikTok Accounts de l'application.
Quelles permissions le webhook de commentaires de TikTok exige-t-il ?
L'application a besoin de TikTok Accounts et de Business Comment, et le titulaire doit accorder comment.list. Les événements cessent si cette autorisation expire ou est révoquée.
Un nouveau scope TikTok s'applique-t-il aux tokens déjà émis ?
Non. Un token conserve les scopes approuvés au moment de son émission, donc le titulaire du compte réautorise l'application pour en ajouter un nouveau.
Combien de temps TikTok met-il à approuver une nouvelle permission ?
TikTok indique que l'examen d'une modification de permission peut prendre deux à trois jours ouvrés, et les demandes qui ajoutent TikTok Accounts exigent d'abord le formulaire de demande d'accès à l'API Accounts.
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