Publier sur TikTok via l’API n’a rien à voir avec un simple appel HTTP suivi d’un upload de vidéo. TikTok impose un vrai parcours développeur : création d’application, revue par TikTok, autorisation OAuth 2.0 et enfin publication en deux temps (initialisation puis envoi du fichier). Ce guide détaille chaque étape de la tiktok api officielle, avec des exemples de requêtes génériques pour comprendre la logique, avant d’évoquer une alternative sans code pour ceux qui n’ont pas envie de maintenir cette intégration.
Ce qu’est réellement la TikTok API pour la publication
TikTok expose une Content Posting API dans le cadre de sa plateforme « TikTok for Developers ». Elle permet à une application tierce de publier des vidéos (et, selon les scopes accordés, des photos) sur un compte TikTok, à condition que ce compte ait explicitement autorisé l’application via OAuth. Ce n’est pas une API ouverte à tout le monde sans validation : chaque application doit être créée, décrite, et souvent passer par une revue avant de pouvoir publier du contenu en production plutôt qu’en mode brouillon limité.
Concrètement, le flux se découpe toujours de la même façon : authentification de l’utilisateur, initialisation d’une publication, envoi du fichier vidéo, puis vérification du statut de traitement. C’est ce flux que nous détaillons ci-dessous.
Étape 1 : créer un compte développeur et une application
Tout commence sur le portail TikTok for Developers. Il faut créer un compte développeur, puis déclarer une application avec ses informations (nom, description, catégorie d’usage, politique de confidentialité et conditions d’utilisation accessibles publiquement, ce qui est généralement exigé). C’est à ce moment que l’on choisit les produits que l’on souhaite activer, dont le « Content Posting API » (parfois associé au « Login Kit » selon la documentation en vigueur).
Chaque application reçoit un identifiant client et une clé secrète, à conserver côté serveur uniquement. Ce sont ces identifiants qui serviront pour l’échange OAuth.
Étape 2 : la revue d’application (audit)
C’est souvent l’étape la plus sous-estimée par les développeurs qui découvrent la tiktok api. Avant de pouvoir publier des vidéos sur des comptes qui ne sont pas les vôtres (ou en production, hors des comptes de test que vous avez déclarés), TikTok exige une revue de l’application : vous décrivez précisément l’usage prévu, parfois avec une démonstration vidéo du parcours utilisateur, et TikTok valide (ou non) l’accès aux scopes demandés.
Tant que l’application n’a pas passé cette revue, elle reste généralement limitée aux comptes ajoutés manuellement comme testeurs, ou aux publications en mode brouillon plutôt qu’en publication directe. Il faut donc anticiper ce délai dans un planning de développement : ce n’est pas une activation instantanée.
Étape 3 : l’authentification OAuth 2.0
Une fois l’application créée, la connexion d’un compte TikTok utilisateur suit le protocole OAuth 2.0 standard : redirection de l’utilisateur vers une page d’autorisation TikTok, consentement explicite sur les permissions demandées, puis retour vers votre application avec un code d’autorisation à échanger contre un jeton d’accès (access token) et un jeton de rafraîchissement (refresh token).
Les scopes concernés pour la publication tournent typiquement autour de video.upload (envoyer une vidéo, généralement en brouillon) et video.publish (publier directement sur le profil, sous réserve des autorisations accordées par l’utilisateur et validées par TikTok). Le détail exact des noms de scopes et leurs conditions d’octroi évoluent selon les versions de la documentation officielle, il convient donc de toujours vérifier la référence à jour au moment de l’implémentation plutôt que de se fier à un exemple figé.
La requête d’échange du code contre un jeton est un appel de type POST vers le point d’entrée OAuth de TikTok (le chemin /v2/oauth/token/ sur le domaine open.tiktokapis.com), envoyé au format formulaire (application/x-www-form-urlencoded). Dans l’esprit d’un flux OAuth 2.0 classique, les paramètres attendus sont les suivants :
- l’identifiant client et la clé secrète de votre application (gardés uniquement côté serveur) ;
- le code d’autorisation reçu après le consentement de l’utilisateur ;
- le type d’octroi, avec la valeur
authorization_code; - l’URL de redirection (callback) déclarée pour votre application.
La réponse renvoie un jeton d’accès et un jeton de rafraîchissement.
Le format exact des paramètres et de la réponse doit être vérifié dans la documentation officielle au moment de l’implémentation : ce qui compte ici, c’est de comprendre la mécanique (échange d’un code contre un access token et un refresh token), pas de copier une requête comme s’il s’agissait d’une spécification figée.
Étape 4 : initialiser puis envoyer la vidéo
Une fois le jeton d’accès obtenu, la publication d’une vidéo via la tiktok api suit un schéma en deux temps, courant sur ce type d’API média :
- Initialisation : un appel décrit l’intention de publication (paramètres de confidentialité, mention du caractère sponsorisé le cas échéant, légende) et indique comment le fichier vidéo va être transmis (envoi direct du binaire ou upload depuis une URL selon les méthodes proposées). La réponse fournit un identifiant de publication à utiliser pour la suite.
- Upload du fichier : la vidéo elle-même est transmise, généralement en flux binaire, en respectant les contraintes de format annoncées par TikTok (encodage, durée, poids).
La requête d’initialisation contient en général deux blocs d’information : un bloc décrivant le post (le titre ou la légende, et le niveau de confidentialité, par exemple une visibilité publique) et un bloc décrivant la source de la vidéo (le mode d’envoi choisi, la taille du fichier et son découpage éventuel en morceaux). Les noms de champs réels doivent être vérifiés dans la documentation à jour ; l’essentiel est de retenir la logique : on annonce d’abord la publication, puis on transmet le fichier.
Après l’envoi, l’API renvoie un statut de traitement qu’il faut interroger (souvent en sondage périodique) pour savoir si la vidéo est en cours de traitement, publiée, ou rejetée. C’est un point de vigilance fréquent : une intégration mal faite considère la publication comme terminée dès l’upload, alors que le traitement côté TikTok peut prendre du temps et échouer ensuite.
Direct post ou brouillon : une distinction à ne pas rater
Selon les permissions accordées par le compte TikTok et le niveau de revue passé par l’application, une publication via l’API peut aboutir soit à une publication directe sur le profil (direct post), soit à un dépôt en brouillon dans l’application TikTok, que l’utilisateur doit ensuite valider manuellement depuis son téléphone. Beaucoup d’intégrations tierces démarrent en mode brouillon, le temps que l’application obtienne les autorisations nécessaires pour la publication directe. C’est un détail à clarifier tôt dans un projet, car il change complètement l’expérience côté utilisateur final.
Les pièges les plus courants
- Sous-estimer le délai de revue. Le processus d’audit de l’application n’est pas instantané, et les usages permis pendant qu’il est en cours sont limités.
- Confondre upload et publication. Un fichier reçu par TikTok n’est pas encore publié : il faut suivre le statut jusqu’à confirmation.
- Ignorer le rafraîchissement du jeton. Les jetons d’accès OAuth ont une durée de vie limitée, il faut gérer le jeton de rafraîchissement pour éviter que l’intégration ne se coupe silencieusement après quelques semaines.
- Négliger les contraintes de format vidéo. TikTok attend un contenu vidéo (jamais une simple image), et le format vertical reste le standard attendu sur la plateforme.
Une alternative si vous ne voulez pas maintenir cette intégration
Tout ce qui précède, compte développeur, revue d’application, gestion OAuth, rafraîchissement de jeton, suivi du statut de publication, représente un travail d’intégration réel à maintenir dans la durée (TikTok fait évoluer sa documentation et ses exigences de revue). Si l’objectif est simplement de programmer des vidéos sur TikTok sans porter cette charge technique, GMB Club encapsule cette complexité.
GMB Club est une plateforme de présence locale organisée autour de trois piliers : la fiche Google Business, les réseaux sociaux et le site web, avec un agent IA et une gestion multi-établissements. Sur le pilier réseaux sociaux, TikTok fait partie des plateformes prises en charge aux côtés de Facebook, Instagram, Google Business, LinkedIn, Pinterest et YouTube. La connexion se fait en autorisant l’application via le consentement TikTok for Business depuis l’interface, sans configuration technique de votre côté : GMB Club publie ensuite via l’API officielle de TikTok pour votre compte.
Le composer fonctionne en trois étapes (contenu, média, planification) : vous rédigez le texte, vous ajoutez votre vidéo au format 9:16 (TikTok exige une vidéo, pas une image seule), vous fixez une date et une heure, et le post est programmé. Un même contenu peut être diffusé sur plusieurs réseaux en même temps, avec un ton adapté à chacun. À noter : la génération automatique de contenu par l’IA de GMB Club ne couvre pas TikTok, YouTube ni Snapchat, puisque ces réseaux exigent des vidéos que l’IA ne produit pas ; pour TikTok, c’est donc votre propre vidéo que vous programmez via le composer.
Pour les équipes techniques qui préfèrent piloter cela par code, l’API GMB Club permet de créer et planifier des posts sur les réseaux, dont TikTok, depuis Zapier, Make ou vos propres scripts, avec un champ de planification dédié par plateforme. C’est une manière d’automatiser la publication TikTok sans avoir à gérer soi-même le compte développeur TikTok, la revue d’application et le cycle de vie des jetons OAuth.
Un essai gratuit de 7 jours donne accès à l’ensemble des fonctionnalités sans carte bancaire, avec bascule automatique vers un compte gratuit à l’issue (aucun débit). Le compte gratuit permet de programmer une publication par semaine sur les réseaux sociaux, TikTok inclus. Les détails de tarifs sont disponibles sur gmb-club.com/tarifs, et l’inscription se fait sur app.gmb-club.com.
FAQ
Faut-il obligatoirement passer par un compte développeur TikTok for Developers pour publier via l’API ?
Oui. Toute publication automatisée sur TikTok via son API officielle nécessite une application déclarée sur le portail TikTok for Developers, avec les identifiants OAuth associés et, dans la plupart des cas, une revue d’application avant un usage en production.
Peut-on publier une image seule sur TikTok via l’API ?
Le format natif et attendu de TikTok reste la vidéo. Selon les scopes et produits activés, certaines options de publication photo existent côté TikTok, mais l’usage principal de la Content Posting API pour du contenu type reste la vidéo, idéalement au format vertical 9:16.
Combien de temps prend la revue d’application TikTok ?
Le délai n’est pas garanti et dépend du volume traité par TikTok ainsi que de la complétude du dossier soumis (description d’usage, éléments démonstratifs). Il faut prévoir ce délai en amont d’un lancement plutôt que de le découvrir en fin de projet.
GMB Club publie-t-il directement mes vidéos sans que je fasse quoi que ce soit ?
Non : GMB Club ne génère pas la vidéo à votre place pour TikTok. Vous fournissez votre vidéo (au format 9:16, idéalement de moins de 60 secondes) dans le composer, vous la programmez, et GMB Club se charge de la publication via l’API officielle de TikTok au moment prévu.
