API TikTok Content Posting : guide pour développeurs
Comment fonctionne l'API TikTok de publication : audit de l'app, Direct Post ou boîte de réception, creator_info, confidentialité, rate limits, mode privé.
L'API TikTok Content Posting permet à votre app de publier des vidéos et des posts photo sur le compte TikTok d'un créateur. Écrire le code est la partie facile. Ce qui ralentit la plupart des équipes, c'est que tant que TikTok n'a pas audité votre app, tout ce qu'elle publie est privé, et que l'audit contrôle votre interface autant que vos appels API.
Ce guide couvre ce qu'il vous faut avant le premier appel, les deux flux de publication, la requête creator_info incontournable, les niveaux de confidentialité, les rate limits et ce qui change avec Bulkit. Chaque détail sur TikTok renvoie vers TikTok for Developers.
Essayez bulkit
Une seule API pour tous les réseaux sociaux
Publiez, programmez et mesurez vos posts sur X, Instagram, TikTok, YouTube, LinkedIn et plus, sans écrire une intégration distincte pour chaque réseau.
Le produit Content Posting API ajouté à cette app, avec le réglage Direct Post activé si vous voulez publier directement.
L'approbation du scope video.publish, ainsi que le consentement de chaque créateur à ce scope lors de l'OAuth. L'upload vers la boîte de réception utilise un autre scope, video.upload.
Le token d'accès et l'open ID du créateur.
Les médias : un fichier vidéo que vous uploadez, ou une URL sur un domaine ou un préfixe d'URL que vous avez vérifié auprès de TikTok. Les photos ne peuvent être envoyées que sous forme d'URL sur un domaine ou un préfixe vérifié.
Pour l'étape OAuth elle-même, l'app a aussi besoin de Login Kit, et la création de l'app demande les URL de vos conditions d'utilisation et de votre politique de confidentialité.
Direct Post ou upload vers la boîte de réception : quel flux choisir ?
L'API offre deux points d'entrée, qui n'aboutissent pas au même endroit.
Direct Post
Upload vers la boîte de réception
Scope
video.publish
video.upload
Endpoint d'initialisation
/v2/post/publish/video/init/
/v2/post/publish/inbox/video/init/
Ce qui se passe
La vidéo est publiée avec la légende et les réglages que vous envoyez
La vidéo arrive en brouillon ; le créateur reçoit une notification dans sa boîte de réception et termine le post dans TikTok
Qui contrôle la légende et la confidentialité
Votre app, via les choix du créateur dans votre interface
Le créateur, dans TikTok
Limite supplémentaire
Plafond quotidien de posts par créateur
Au maximum 5 partages en attente par 24 heures
La référence de l'upload vers la boîte de réception précise que les utilisateurs « doivent cliquer sur les notifications de leur boîte de réception pour poursuivre l'édition dans TikTok et finaliser le post ». Utilisez ce flux quand une personne relit de toute façon chaque post dans TikTok, par exemple un outil de montage qui transmet un montage terminé. Utilisez Direct Post pour la programmation, l'automatisation et tout ce qui doit être mis en ligne sans que quelqu'un ouvre l'application.
Comment fonctionne un Direct Post, étape par étape ?
Quatre appels, tous sur https://open.tiktokapis.com :
1. Interroger les infos du créateur.POST /v2/post/publish/creator_info/query/ (voir la section suivante).
2. Initialiser le post.POST /v2/post/publish/video/init/ avec post_info et source_info, d'après la référence Direct Post :
bash
curl --location 'https://open.tiktokapis.com/v2/post/publish/video/init/' \ --header 'Authorization: Bearer act.example12345Example12345Example' \ --header 'Content-Type: application/json; charset=UTF-8' \ --data-raw '{ "post_info": { "title": "this will be a funny #cat video on your @tiktok #fyp", "privacy_level": "MUTUAL_FOLLOW_FRIENDS", "disable_duet": false, "disable_comment": true, "disable_stitch": false, "video_cover_timestamp_ms": 1000 }, "source_info": { "source": "FILE_UPLOAD", "video_size": 50000123, "chunk_size": 10000000, "total_chunk_count": 5 } }'
privacy_level est obligatoire et doit faire partie des valeurs renvoyées par creator_info.
title est la légende, jusqu'à 2 200 runes UTF-16.
brand_content_toggle, brand_organic_toggle et is_aigc sont les mentions de contenu commercial et de contenu généré par IA.
source vaut FILE_UPLOAD (vous envoyez les octets) ou PULL_FROM_URL (TikTok télécharge depuis video_url).
La réponse vous donne un publish_id et, pour FILE_UPLOAD, une upload_url valable une heure.
3. Uploader le fichier. Envoyez les octets en PUT vers upload_url, dans l'ordre, un chunk par requête, avec Content-Type, Content-Length et Content-Range: bytes {FIRST}-{LAST}/{TOTAL}. Le guide de transfert des médias fixe les règles :
Les chunks font de 5 Mo à 64 Mo. Le dernier peut aller jusqu'à 128 Mo pour absorber le reste.
Les fichiers de moins de 5 Mo sont envoyés en un seul chunk. Les fichiers de plus de 64 Mo doivent être découpés.
De 1 à 1 000 chunks, et total_chunk_count correspond à la taille divisée par la taille de chunk, arrondie à l'inférieur.
Vidéo : MP4 (recommandé), WebM ou MOV ; H.264 (recommandé), H.265, VP8 ou VP9 ; 23 à 60 FPS ; 360 à 4 096 px de côté ; jusqu'à 4 Go.
Avec PULL_FROM_URL, il n'y a rien à uploader, mais l'URL doit être en HTTPS, ne doit pas rediriger et doit rester accessible pendant le téléchargement, qui expire une heure après son démarrage.
4. Vérifier le statut.POST /v2/post/publish/status/fetch/ avec le publish_id. D'après la référence du statut, vous verrez PROCESSING_UPLOAD ou PROCESSING_DOWNLOAD, puis PUBLISH_COMPLETE ou FAILED (les uploads vers la boîte de réception passent aussi par SEND_TO_USER_INBOX). publicaly_available_post_id (orthographe de TikTok) n'est renseigné qu'une fois le post public et validé par la modération. Un post privé publié par une app non auditée n'en aura pas.
Les posts photo suivent le même schéma via POST /v2/post/publish/content/init/, avec post_mode et media_type dans le corps de la requête et des URL de photos sur un domaine ou un préfixe vérifié.
Que renvoie creator_info, et pourquoi est-ce obligatoire ?
POST /v2/post/publish/creator_info/query/ renvoie l'état actuel du compte sur lequel vous vous apprêtez à publier. D'après la référence creator_info :
Le compte qui recevra le post. L'URL de l'avatar expire au bout de 2 heures
privacy_level_options
Les niveaux de confidentialité que ce créateur peut utiliser en ce moment
comment_disabled, duet_disabled, stitch_disabled
Les interactions que le créateur a désactivées (Duet et Stitch sont aussi désactivés pour les comptes privés)
max_video_post_duration_sec
La durée maximale de vidéo que ce créateur peut publier
La réponse indique aussi quand un créateur ne peut pas publier du tout : spam_risk_too_many_posts (il a atteint le plafond quotidien), spam_risk_user_banned_from_posting, ou reached_active_user_cap (votre app a épuisé son quota quotidien d'utilisateurs actifs qui publient).
Vous ne pouvez pas mettre cette réponse en cache. Les options de confidentialité et la limite de durée changent quand le créateur modifie les réglages de son compte, et les content sharing guidelines de TikTok construisent votre écran de publication à partir de ces données.
Quels niveaux de confidentialité un post publié via l'API TikTok peut-il utiliser ?
Les valeurs dépendent du caractère public ou privé du compte du créateur :
Si vous envoyez une valeur absente de privacy_level_options, ou si vous l'omettez, l'initialisation échoue avec privacy_level_option_mismatch. Un contenu de marque ne peut pas être rendu privé.
Que peut faire une app non auditée ?
Pas grand-chose en public. Le guide de démarrage de TikTok est sans détour : « Tout contenu publié par des clients non audités sera limité au mode de visibilité privé. » La référence Direct Post précise l'erreur que vous rencontrerez : unaudited_client_can_only_post_to_private_accounts, « Les clients non audités ne peuvent publier que sur un compte privé. La tentative de publication sera bloquée lors de l'appel à /publish/video/init/. »
Pour lever cette restriction, votre app doit passer l'audit de TikTok, qui vérifie le respect de ses conditions et des content sharing guidelines. Ces recommandations sont des exigences d'interface, et une app qui les ignore est refusée :
Affichez le pseudo du créateur sur l'écran de publication, pour que l'utilisateur sache sur quel compte il publie.
Le niveau de confidentialité est choisi manuellement dans une liste déroulante, sans valeur par défaut.
Commentaires, Duet et Stitch sont décochés au départ. Si le créateur en a désactivé un dans TikTok, grisez-le.
L'option de contenu commercial est désactivée par défaut. Quand elle est activée, l'utilisateur doit choisir « Your brand » et/ou « Branded content » avant que le bouton de publication ne s'active.
Affichez la déclaration de consentement (avec un lien vers la Music Usage Confirmation de TikTok, plus la Branded Content Policy pour les posts commerciaux) avant le bouton de publication.
Affichez un aperçu, laissez les utilisateurs modifier toute légende ou tout hashtag prérempli, et n'ajoutez ni filigrane ni logo.
Prévenez les utilisateurs que le post peut mettre quelques minutes à apparaître sur leur profil.
N'envoyez le contenu qu'après l'accord explicite de l'utilisateur pour l'upload.
Relisez cette liste si vous prévoyez une publication entièrement automatisée, sans intervention humaine. Les recommandations partent du principe qu'une personne choisit le niveau de confidentialité de chaque post.
Quelles sont les rate limits de l'API TikTok Content Posting ?
Toutes s'entendent par token d'accès utilisateur, d'après les pages de référence de TikTok :
Endpoint
Limite
creator_info/query
20 requêtes par minute
video/init (Direct Post)
6 requêtes par minute
inbox/video/init
6 requêtes par minute
status/fetch
30 requêtes par minute
Un dépassement renvoie une erreur HTTP 429 rate_limit_exceeded. À cela s'ajoutent :
Un plafond quotidien de posts par créateur.spam_risk_too_many_posts signifie que « le plafond quotidien de posts via l'API est atteint pour l'utilisateur actuel ». TikTok ne publie pas ce chiffre.
Un plafond quotidien d'utilisateurs actifs par app.reached_active_user_cap signifie que votre client a atteint son quota quotidien d'utilisateurs actifs qui publient. Ce chiffre n'est pas publié non plus.
Les partages en attente dans la boîte de réception. Au maximum 5 sur 24 heures, au-delà spam_risk_too_many_pending_share.
Comme les plafonds quotidiens ne sont pas publiés, traitez ces deux erreurs comme un « réessayez demain » et affichez un message clair à l'utilisateur. Relancer en boucle ne servira à rien.
Comment publier ou programmer une vidéo TikTok avec Bulkit ?
La règle du privé uniquement de TikTok s'applique à l'app, pas à celui qui envoie la requête. L'app TikTok de Bulkit a déjà passé l'audit : les comptes connectés par son intermédiaire peuvent publier en public dès le premier jour, sans app développeur à créer. Vous pouvez toujours utiliser votre propre app TikTok avec Login Kit et la Content Posting API (Direct Post activé), vous ajoutez les scopes user.info.basic, video.publish et video.list, puis vous collez son client key et son secret dans Bulkit. Dans ce cas, les règles habituelles s'appliquent : avant la validation, seuls les comptes ajoutés comme utilisateurs de test dans l'onglet Sandbox de l'app peuvent se connecter, et leurs posts sont privés. Après approbation, TikTok procède à l'audit, et une fois celui-ci réussi, les posts peuvent être publics. Le guide de l'app TikTok détaille chaque étape, y compris la vérification du préfixe d'URL de Bulkit pour les posts photo.
Ce que vous n'avez pas à écrire : les appels creator_info, les uploads par chunks, le suivi du statut et les contrôles du niveau de confidentialité. D'après la page de la plateforme TikTok :
Deux types de posts via channels[].postType : video (par défaut, exactement un MP4 ou MOV) et photo (de 1 à 35 images, la première servant de couverture).
Légendes jusqu'à 2 200 caractères pour les vidéos, 4 000 pour les descriptions de posts photo. Les posts photo acceptent un title facultatif de 90 caractères.
privacy_level est obligatoire. Lisez les valeurs autorisées pour ce compte avec GET /channels/{id}/capabilities. C'est creator_info, servi par Bulkit.
Les autres options : allow_comment, allow_duet, allow_stitch, video_cover_timestamp_ms, disclose_content, brand_organic_toggle, brand_content_toggle, is_aigc et auto_add_music (photo uniquement). Les valeurs vrai/faux sont envoyées sous forme de chaînes "true" et "false".
Avec le SDK Node, vérifiez les choix de confidentialité du compte, uploadez la vidéo, puis publiez :
ts
import { openAsBlob } from "node:fs";import { Bulkit } from "bulkit";const bulkit = new Bulkit(); // lit BULKIT_API_KEY// creator_info, via Bulkit : quels niveaux de confidentialité ce compte peut-il utiliser ?const caps = await bulkit.channels.capabilities("CHANNEL_TIKTOK");const video = await bulkit.media.uploadMultipart(await openAsBlob("launch.mp4"), { fileName: "launch.mp4", mimeType: "video/mp4",});const post = await bulkit.posts.create({ intent: "now", channels: [ { channelId: "CHANNEL_TIKTOK", options: { privacy_level: "PUBLIC_TO_EVERYONE", allow_comment: "true", allow_duet: "false", allow_stitch: "false", }, blocks: [{ content: "Behind the scenes 🎬", mediaIds: [video.id] }], }, ],});
Dans caps.options, l'entrée privacy_level liste dans choices les valeurs autorisées pour ce compte. Sur l'app auditée de Bulkit, cette liste suffit. Si vous utilisez votre propre app, une app non auditée reste limitée aux posts privés. La documentation de Bulkit le formule ainsi : tant que TikTok n'a pas approuvé votre app, elle « n'autorise que les posts SELF_ONLY (privés), quoi que vous envoyiez ».
Deux limites de TikTok s'appliquent telles quelles : les apps ne peuvent pas supprimer de posts TikTok, et TikTok ne donne pas aux apps l'accès aux commentaires. Les statistiques (vues, likes, commentaires, partages) sont renvoyées pour les posts publiés. La publication est asynchrone : intent: "now" renvoie donc publishing. Consultez posts.retrieve(post.id) ou un webhook pour connaître le résultat.
API TikTok native ou Bulkit ?
L'audit et les exigences d'interface sont les mêmes dans les deux cas. Si TikTok est votre seul réseau et que vous construisez de toute façon l'écran de publication, l'API native se résume à quatre endpoints et un upload par chunks. C'est gérable.
Publiez, programmez et mesurez vos posts sur X, Instagram, TikTok, YouTube, LinkedIn et plus, sans écrire une intégration distincte pour chaque réseau.