AccediInizia la prova gratuita
easyCoexistence API ufficiali

Come aggiungere la pubblicazione su TikTok al tuo SaaS

Un SaaS aggiunge la pubblicazione su TikTok collegando l'account TikTok di ogni cliente tramite un link ospitato, poi chiama POST /channels/{id}/posts di easyCoexistence con un unico video oppure da 1 a 35 immagini e una didascalia, subito oppure a un orario publish_at fino a 90 giorni prima. Il post viene inviato tramite l'API for Business di TikTok, che consente 15 post al giorno per account, e il tuo backend riceve una notifica quando è online.

15 a day

Post video che TikTok pubblica per account tramite la sua API for Business, al massimo sei al minuto.

1 GB

Il video più lungo che l'endpoint di pubblicazione di TikTok accetta, in MP4, MOV o WebM, da 3 a 600 secondi.

35 images

Numero massimo di immagini in un post foto TikTok; ciascuna in JPG, JPEG o WebP, fino a 20 MB.

90

Unità di codice UTF-16 che può contenere il titolo di un post foto TikTok.

90 days

Quanto in anticipo l'endpoint dei post di easyCoexistence può programmare un post TikTok.

Come si collega un cliente a TikTok?

Tramite una sessione di connessione con channel impostato su tiktok. La pagina ospitata mostra il tuo nome e il pulsante Continua con TikTok, che apre la schermata di consenso di TikTok nella stessa scheda; il cliente accede, concede l'autorizzazione e torna sul tuo redirect_url con un channel_id. Salvalo accanto al cliente, perché ogni chiamata di pubblicazione indica il canale.

Come si presenta una richiesta di post TikTok?

Una sola richiesta POST a /channels/{id}/posts con la didascalia in text e il file in media. Ometti publish_at per pubblicare subito, oppure imposta un orario ISO 8601 con il suo offset per pubblicare più tardi. Un post immediato riceve 201, oppure 422 con il motivo di TikTok se è fallito.

Schedule a TikTok video
curl -X POST https://easycoexistence.com/api/v1/channels/$CHANNEL_ID/posts \
  -H "Authorization: Bearer $EC_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: tt_video_5530" \
  -d '{
    "text": "Behind the scenes of our new store #opening",
    "media": [{ "url": "https://cdn.example.com/store-tour.mp4", "type": "video" }],
    "disable_comment": false,
    "publish_at": "2026-11-10T18:00:00-05:00"
  }'

Post video o post foto: cosa richiede ciascuno?

Un post TikTok è un solo video oppure un insieme di immagini, mai entrambi, e non contiene link. Il testo, fino a 2.200 caratteri qui, è la didascalia di entrambi, e le regole sui file di TikTok vengono verificate prima che il post sia messo in coda:

Video postPhoto post
MediaOne video, MP4, MOV or WebM1 to 35 images, JPEG or WebP
SizeUp to 1 GB, 3 to 600 seconds, at least 360 pxUp to 20 MB per image
TitleNone; the caption onlytitle, up to 90 characters
Commentsdisable_comment turns them offdisable_comment turns them off

Dove devono trovarsi i media?

Ovunque in HTTPS, oppure nello storage di easyCoexistence. TikTok scarica solo da prefissi URL verificati per l'app, quindi easyCoexistence serve ogni file dal proprio prefisso verificato e tu non devi verificare nulla. I media di un post programmato vengono copiati al momento della programmazione, con immagini fino a 30 MB e video fino a 1 GB, così un link che scade prima dell'orario del post non può comprometterlo. Per caricare invece un file, POST /media restituisce un media_id.

Come sai che un post è online?

Dallo stato del post e dagli eventi. Un post passa da scheduled a publishing, poi a processing mentre TikTok scarica e controlla il file; easyCoexistence chiede a TikTok il suo stato ogni 20 secondi, finché non segnala il post come completato. Il tuo URL di eventi riceve quindi post.published con il post e il suo canale, oppure post.failed con il motivo della rete. GET /posts/{id} mostra le stesse informazioni, con network_post_id e permalink una volta online.

Come funzionano modifiche, annullamenti e nuovi tentativi?

Sul post, finché TikTok non lo ha ancora ricevuto. PATCH /posts/{id} modifica publish_at, text o title di un post programmato; per cambiare i media, annullalo con DELETE /posts/{id} e creane uno nuovo. POST /posts/{id}/retry pubblica di nuovo un post fallito. Quando TikTok non dà conferma entro 2 ore, il post fallisce con may_be_published impostato su true, e il nuovo tentativo richiede confirm impostato su true.

Cosa succede ai commenti dopo il post?

Possono raggiungere il tuo prodotto. PUT /channels/{id}/webhook inoltra al tuo endpoint, firmati, gli eventi comment.update di TikTok, e il tuo backend risponde al commento tramite business/comment/reply/create/ di TikTok, con il token ottenuto dalla chiamata alle credenziali. Le risposte su TikTok sono pubbliche, poiché una connessione TikTok non prevede messaggi diretti.

Errori comuni

  • Inviare immagini PNG per un post foto. TikTok accetta solo JPEG o WebP, quindi il post viene rifiutato prima di essere messo in coda.
  • Mettere un titolo su un post video. title serve per i post foto, e un video porta il suo testo solo nella didascalia.
  • Riprovare un post con may_be_published true senza controllare. TikTok potrebbe averlo già pubblicato, quindi verifica l'account prima di riprovare con confirm.
  • Pianificare più di 15 post al giorno per un account. TikTok limita i post via API per account, quindi distribuisci il calendario di un cliente su più giorni.
Farlo con EasyCoexistence

easyCoexistence aggiunge la pubblicazione su TikTok al tuo SaaS: i tuoi clienti collegano i loro account TikTok tramite un link ospitato, e il tuo backend pubblica video e post foto subito o più tardi, riceve la notifica quando ciascuno è online e ottiene i relativi commenti. La stessa API copre WhatsApp, Instagram, Facebook, YouTube, LinkedIn e altri canali, con ogni connessione monitorata 24/7. Da US$ 9 a US$ 0.75 per connessione al mese, che scende man mano che aggiungi connessioni, con la prova gratuita di 3 giorni.

Domande frequenti

Il mio SaaS può pubblicare video TikTok come bozze?

No. L'endpoint dei post di easyCoexistence pubblica il video sull'account, subito oppure a publish_at. Usa la programmazione per trattenere un post finché il cliente non è pronto.

TikTok permette di programmare i post tramite la sua API?

Gli endpoint di pubblicazione di TikTok agiscono nel momento in cui vengono chiamati. easyCoexistence tiene il post nella sua coda e chiama TikTok a publish_at, fino a 90 giorni in anticipo.

Il mio SaaS può disattivare i commenti su un post TikTok?

Sì. Imposta disable_comment su true nel post. Quando le impostazioni dell'account disattivano già i commenti, TikTok accetta solo true.

Quanto costa easyCoexistence per account TikTok?

Ogni account TikTok che i tuoi clienti collegano costa da US$ 9 a US$ 0.75 al mese, in base alla fascia del totale delle tue connessioni, con i primi 3 giorni di prova gratuita.

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