Envoyer une vidéo dans les brouillons d'un créateur TikTok via l'API
Les API de TikTok envoient une vidéo dans les brouillons d'un créateur avec le flux d'upload : l'API Content Posting appelle /v2/post/publish/inbox/video/init/ sous le scope video.upload, et TikTok envoie au créateur une notification dans sa boîte de réception pour qu'il la modifie et la publie dans l'application. L'API for Business fait de même avec upload_to_draft sur /business/video/publish/, ou avec is_draft pour les publications photo.
easyCoexistence publie des vidéos et des publications photo TikTok avec publish_tiktok_post depuis Claude, ChatGPT ou votre propre plateforme, immédiatement ou à une date et une heure jusqu'à 90 jours à l'avance, chaque publication en attente restant visible sur l'écran des publications jusqu'à sa mise en ligne.
Scope que TikTok définit comme le partage de contenu sur le compte du créateur sous forme de brouillon à modifier et publier dans TikTok.
Nombre maximal de partages en attente que l'API Content Posting autorise sur toute période de 24 heures, limite fixée par TikTok pour réduire le spam.
Le statut /business/publish/status/ indique qu'un brouillon a été envoyé et que TikTok a notifié la boîte de réception du créateur.
Requêtes que chaque token d'accès utilisateur peut envoyer à l'endpoint d'upload de l'API Content Posting.
Ce qu'il advient des autres champs de post_info lorsque upload_to_draft vaut true sur /business/video/publish/.
En quoi un brouillon diffère-t-il d'une publication directe ?
Dans la personne qui appuie sur « Publier ». Une publication directe est en ligne dès que TikTok l'a traitée ; un brouillon arrive dans la boîte de réception TikTok du créateur et n'est publié que lorsque celui-ci l'ouvre, le modifie à sa guise et le publie. Cette différence traverse les deux API de publication de TikTok :
| Draft (upload) | Direct post | |
|---|---|---|
| Who posts | The creator, in the TikTok app | The app, through the API |
| Token scope | video.upload, on both APIs | video.publish on the Content Posting API |
| Content Posting API | /v2/post/publish/inbox/video/init/ | /v2/post/publish/video/init/ |
| API for Business | upload_to_draft or is_draft set to true | The same endpoints without them |
| Status once handed over | SEND_TO_USER_INBOX | PUBLISH_COMPLETE once live |
| Caption and settings | Mostly finished by the creator in TikTok | Sent in the call |
Comment l'API Content Posting envoie-t-elle un brouillon ?
Par une requête POST vers https://open.tiktokapis.com/v2/post/publish/inbox/video/init/, avec un token d'accès utilisateur disposant de video.upload et un objet source_info. PULL_FROM_URL demande à TikTok de récupérer la vidéo depuis un domaine ou un préfixe d'URL vérifié par l'application ; FILE_UPLOAD renvoie une upload_url, vers laquelle le fichier est envoyé par morceaux via des requêtes PUT. Le publish_id renvoyé va vers /v2/post/publish/status/fetch/, les photos utilisent /v2/post/publish/content/init/ avec post_mode défini sur MEDIA_UPLOAD, et TikTok demande aux applications d'indiquer aux utilisateurs d'ouvrir la notification de la boîte de réception pour poursuivre la modification dans TikTok :
curl -X POST 'https://open.tiktokapis.com/v2/post/publish/inbox/video/init/' \
-H 'Authorization: Bearer <USER_ACCESS_TOKEN>' \
-H 'Content-Type: application/json; charset=UTF-8' \
-d '{
"source_info": {
"source": "PULL_FROM_URL",
"video_url": "https://media.example.com/tiktok/draft.mp4"
}
}'
# data.publish_id: pass it to /v2/post/publish/status/fetch/Quelles limites s'appliquent aux brouillons de l'API Content Posting ?
TikTok les documente dans sa référence d'upload ; chacune est renvoyée par l'appel init lorsqu'elle s'applique :
- Brouillons en attente : au plus 5 partages en attente sur toute période de 24 heures ; au-delà,
spam_risk_too_many_pending_shareavec HTTP 403. - Requêtes : 6 par minute et par token d'accès utilisateur, puis
rate_limit_exceededavec HTTP 429. - Scope : un token sans video.upload reçoit
scope_not_authorizedavec HTTP 401. - Média : un
PULL_FROM_URLdepuis un domaine ou un préfixe non vérifié par l'application renvoieurl_ownership_unverifiedavec HTTP 403.
Comment l'API for Business envoie-t-elle un brouillon ?
Avec ses endpoints de publication et un champ supplémentaire dans post_info. Sur /business/video/publish/, upload_to_draft réglé sur true envoie la vidéo comme brouillon, et TikTok ignore les autres champs de post_info ; sur /business/photo/publish/, is_draft ne conserve que le titre et la légende. Les deux requièrent video.upload sur le token du compte, que /tt_user/token_info/get/ liste ; sans ce scope, le propriétaire autorise à nouveau l'application pour activer l'envoi de brouillons. Le média reste sur une URL vérifiée, le statut affiche SEND_TO_USER_INBOX, et le créateur retrouve le brouillon via la notification de sa boîte de réception :
curl -X POST 'https://business-api.tiktok.com/open_api/v1.3/business/video/publish/' \
-H 'Access-Token: <ACCESS_TOKEN>' \
-H 'Content-Type: application/json' \
-d '{
"business_id": "<OPEN_ID>",
"video_url": "https://media.example.com/tiktok/draft.mp4",
"post_info": {
"upload_to_draft": true,
"is_brand_organic": false,
"is_branded_content": false
}
}'Que fait le créateur du brouillon ?
Il le termine dans TikTok. La notification de la boîte de réception ouvre la vidéo ou les photos envoyées dans l'éditeur de TikTok, où le créateur les relit, les modifie et les publie. Sur l'API Content Posting, le statut passe de SEND_TO_USER_INBOX à PUBLISH_COMPLETE une fois que le créateur a publié à partir du brouillon, et TikTok précise qu'un même brouillon peut donner lieu à plus d'une publication.
easyCoexistence envoie-t-il des brouillons ?
Non : publish_tiktok_post publie. Il appelle /business/video/publish/ ou /business/photo/publish/ sans upload_to_draft ni is_draft, de sorte qu'une publication est en ligne dès que TikTok l'a traitée. Pour retenir une publication avant relecture, programmez-la avec scheduled_at, de 1 minute à 90 jours à l'avance : elle attend sous « À venir » sur l'écran des publications, update_scheduled_post modifie son horaire, sa légende ou le titre d'une publication photo, et cancel_scheduled_post l'arrête avant sa mise en ligne.
Erreurs courantes
- Demander video.publish pour envoyer des brouillons. Les brouillons requièrent video.upload, le scope que TikTok décrit comme le partage de contenu sous forme de brouillon.
- Définir une légende sur un brouillon vidéo via l'API for Business. Avec upload_to_draft à true, TikTok ignore le reste de post_info.
- Envoyer des brouillons plus vite que les créateurs ne publient. L'API Content Posting s'arrête à 5 partages en attente en 24 heures avec spam_risk_too_many_pending_share.
- Ne pas indiquer aux utilisateurs où trouver le brouillon. TikTok demande aux applications de leur dire d'ouvrir la notification de la boîte de réception pour finir la publication.
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
L'API TikTok peut-elle enregistrer une vidéo comme brouillon ?
Oui. Le flux d'upload la place dans la boîte de réception TikTok du créateur, qui la modifie et la publie ; le token doit disposer du scope video.upload.
Où apparaît un brouillon envoyé par l'API ?
Dans l'application TikTok, derrière une notification de boîte de réception qui ouvre la vidéo dans l'éditeur de TikTok pour que le créateur la termine.
Un brouillon TikTok peut-il conserver ma légende ?
Avec l'API for Business, un brouillon photo conserve son titre et sa légende, tandis qu'un brouillon vidéo ignore les autres champs de post_info.
Un brouillon TikTok peut-il donner plusieurs publications ?
Oui. TikTok précise qu'un même brouillon peut donner lieu à plusieurs publications, et sur l'API Content Posting le statut passe à PUBLISH_COMPLETE une fois que le créateur publie à partir de lui.
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