AccediInizia la prova gratuita
easyCoexistence API ufficiali

Inviare un video alle bozze di un creator su TikTok tramite API

Le API di TikTok inviano un video alle bozze di un creator con il flusso di caricamento: la Content Posting API carica il video con /v2/post/publish/inbox/video/init/ sotto lo scope video.upload, e TikTok invia al creator una notifica nell'inbox per modificarlo e pubblicarlo nell'app. L'API per le aziende fa lo stesso con upload_to_draft su /business/video/publish/, oppure con is_draft nei post con foto.

easyCoexistence pubblica video e post con foto su TikTok con publish_tiktok_post da Claude, ChatGPT o dalla tua piattaforma, subito o a una data e un orario fino a 90 giorni in anticipo, con ogni post in coda nella schermata Post finché non va online.

video.upload

Lo scope che TikTok definisce come condivisione di contenuti sull'account del creator come bozza da modificare e pubblicare in TikTok.

5 pending

Il massimo di condivisioni in attesa che la Content Posting API consente in un periodo di 24 ore, un limite che TikTok imposta per ridurre lo spam.

SEND_TO_USER_INBOX

Lo stato /business/publish/status/ segnala quando una bozza è caricata e TikTok ha avvisato l'inbox del creator.

6 a minute

Richieste che ogni token di accesso utente può inviare all'endpoint di caricamento della Content Posting API.

Ignored

Cosa succede agli altri campi di post_info quando upload_to_draft è true su /business/video/publish/.

In cosa si differenzia una bozza da un post diretto?

In chi preme Pubblica. Un post diretto va online quando TikTok lo ha elaborato; una bozza arriva nell'inbox TikTok del creator e viene pubblicata solo quando il creator la apre, la modifica come preferisce e la pubblica. La differenza attraversa entrambe le API di pubblicazione di 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

Come carica una bozza la Content Posting API?

Con una POST a https://open.tiktokapis.com/v2/post/publish/inbox/video/init/, un token di accesso utente con video.upload e un oggetto source_info. PULL_FROM_URL fa recuperare il video a TikTok da un dominio o da un prefisso di URL che l'app ha verificato; FILE_UPLOAD restituisce un upload_url, al quale il file viene inviato a blocchi con richieste PUT. Il publish_id restituito va a /v2/post/publish/status/fetch/, le foto usano /v2/post/publish/content/init/ con post_mode impostato su MEDIA_UPLOAD, e TikTok chiede alle app di dire agli utenti di aprire la notifica nell'inbox per continuare la modifica in 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/

Quali limiti si applicano alle bozze della Content Posting API?

TikTok li documenta nel suo riferimento per il caricamento; ciascuno viene restituito dalla chiamata init quando si applica:

  • Bozze in attesa: al massimo 5 condivisioni in attesa in un periodo di 24 ore; oltre, spam_risk_too_many_pending_share con HTTP 403.
  • Richieste: 6 al minuto per token di accesso utente, poi rate_limit_exceeded con HTTP 429.
  • Scope: un token senza video.upload riceve scope_not_authorized con HTTP 401.
  • Media: PULL_FROM_URL da un dominio o prefisso non verificato dall'app restituisce url_ownership_unverified con HTTP 403.

Come carica una bozza l'API per le aziende?

Con i suoi endpoint di pubblicazione e un campo in più in post_info. Su /business/video/publish/, upload_to_draft impostato su true invia il video come bozza, e TikTok ignora gli altri campi di post_info; su /business/photo/publish/, is_draft mantiene solo il titolo e la didascalia. Entrambi richiedono video.upload sul token dell'account, che /tt_user/token_info/get/ elenca; se manca, il proprietario approva il caricamento delle bozze autorizzando di nuovo l'app. I media restano su un URL verificato, lo stato indica SEND_TO_USER_INBOX e il creator trova la bozza tramite la notifica nell'inbox:

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
    }
  }'

Cosa fa il creator con la bozza?

La completa in TikTok. La notifica nell'inbox apre il video o le foto caricate nell'editor di TikTok, dove il creator li rivede, li modifica e li pubblica. Con la Content Posting API, lo stato passa da SEND_TO_USER_INBOX a PUBLISH_COMPLETE quando il creator pubblica dalla bozza, e TikTok precisa che una bozza può generare più di un post.

easyCoexistence invia bozze?

No: publish_tiktok_post pubblica. Chiama /business/video/publish/ o /business/photo/publish/ senza upload_to_draft o is_draft, quindi il post va online quando TikTok lo ha elaborato. Per trattenere un post in attesa di revisione, pianificalo con scheduled_at, da 1 minuto a 90 giorni in anticipo: resta in In arrivo nella schermata Post, update_scheduled_post ne cambia l'orario, la didascalia o il titolo di un post con foto, e cancel_scheduled_post lo ferma prima della pubblicazione.

Errori comuni

  • Chiedere video.publish per inviare bozze. Le bozze richiedono video.upload, lo scope che TikTok descrive come condivisione di contenuti come bozza.
  • Impostare una didascalia su una bozza video tramite l'API per le aziende. Con upload_to_draft su true, TikTok ignora il resto di post_info.
  • Caricare bozze più in fretta di quanto i creator le pubblichino. La Content Posting API si ferma a 5 condivisioni in attesa in 24 ore con spam_risk_too_many_pending_share.
  • Non indicare agli utenti dove trovare l'inbox. TikTok chiede alle app di dire loro di aprire la notifica nell'inbox per completare il post.
Farlo con EasyCoexistence

Da US$ 9 a US$ 0,75 per connessione al mese, con prezzo che scende man mano che aggiungi connessioni, e i primi 3 giorni gratuiti.

Domande frequenti

L'API di TikTok può salvare un video come bozza?

Sì. Il flusso di caricamento lo mette nell'inbox TikTok del creator, dove il creator lo modifica e lo pubblica; il token deve avere lo scope video.upload.

Dove compare una bozza inviata tramite API?

Nell'app TikTok, dietro una notifica nell'inbox che apre il video nell'editor di TikTok perché il creator lo completi.

Una bozza TikTok può mantenere la mia didascalia?

Con l'API per le aziende, una bozza di foto mantiene titolo e didascalia, mentre una bozza video scarta gli altri campi di post_info.

Una bozza TikTok può diventare più di un post?

Sì. TikTok precisa che una bozza può generare più di un post, e con la Content Posting API lo stato passa a PUBLISH_COMPLETE quando il creator pubblica da essa.

Continua a leggere

Collega il tuo primo canale in due minuti.

Nessuna revisione delle piattaforme da aspettare. Collega WhatsApp, Instagram, TikTok o un altro canale, poi chiedi alla tua AI di pubblicare, rispondere o fare un report, e guardala al lavoro.

  • 3 giorni gratis
  • Disdici quando vuoi
  • Solo API ufficiali
  • Monitorato 24/7

Verificato il