Se connecterCommencer l’essai gratuit
easyCoexistence API officielles

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.

video.upload

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.

5 pending

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.

SEND_TO_USER_INBOX

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.

6 a minute

Requêtes que chaque token d'accès utilisateur peut envoyer à l'endpoint d'upload de l'API Content Posting.

Ignored

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 postsThe creator, in the TikTok appThe app, through the API
Token scopevideo.upload, on both APIsvideo.publish on the Content Posting API
Content Posting API/v2/post/publish/inbox/video/init//v2/post/publish/video/init/
API for Businessupload_to_draft or is_draft set to trueThe same endpoints without them
Status once handed overSEND_TO_USER_INBOXPUBLISH_COMPLETE once live
Caption and settingsMostly finished by the creator in TikTokSent 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 :

Upload a video to the creator's inbox from a URL
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_share avec HTTP 403.
  • Requêtes : 6 par minute et par token d'accès utilisateur, puis rate_limit_exceeded avec HTTP 429.
  • Scope : un token sans video.upload reçoit scope_not_authorized avec HTTP 401.
  • Média : un PULL_FROM_URL depuis un domaine ou un préfixe non vérifié par l'application renvoie url_ownership_unverified avec 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 :

Send a video to the creator's drafts on the API for Business
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.
Faire cela avec EasyCoexistence

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