AccediInizia la prova gratuita
easyCoexistence API ufficiali

Post fotografici e carousel di TikTok tramite API: fino a 35 immagini

L'API for Business di TikTok pubblica un post fotografico di da 1 a 35 immagini, ciascuna un file JPG, JPEG o WebP di al massimo 20 MB e non più grande di 1080 x 1920 pixel in entrambi gli orientamenti, che TikTok scarica da un URL verificato. Il post accetta un titolo di fino a 90 caratteri, una didascalia, un livello di privacy e un'immagine di copertina.

easyCoexistence pubblica post fotografici di TikTok con publish_tiktok_post da Claude, ChatGPT o dal tuo codice: passa da 1 a 35 link di immagini, un titolo e una didascalia, poi segui il post con get_tiktok_publish_status.

35

Il numero massimo di immagini che un post fotografico può contenere tramite l'endpoint di pubblicazione foto di TikTok.

20 MB

Dimensione massima del file per ogni immagine di un post fotografico, che deve essere JPG, JPEG o WebP.

1080 x 1920

Risoluzione massima in pixel per un post fotografico, ovvero 1920 x 1080 per un'immagine orizzontale.

90

Unità di codice UTF-16 che può contenere il titolo di un post fotografico; la didascalia ne accetta fino a 4.000.

Cosa va nel post fotografico?

Una sola chiamata a POST /business/photo/publish/ trasporta le immagini e i dettagli del post:

  • photo_images: fino a 35 URL di immagini su un dominio o prefisso URL verificato.
  • photo_cover_index: l'immagine usata come copertina, contando da 0, che è il valore predefinito.
  • post_info.title: fino a 90 unità di codice UTF-16.
  • post_info.caption: fino a 4.000 unità di codice UTF-16, con #hashtag e al massimo 30 @menzioni.
  • post_info.privacy_level: chi può vedere il post, entro le opzioni consentite dalle impostazioni dell'account.
  • post_info.disable_comment: disattiva i commenti sul post.

Quali file immagine funzionano?

JPG, JPEG o WebP, ciascuno fino a 20 MB e non più grande di 1080 x 1920 pixel, oppure 1920 x 1080 per un'immagine orizzontale. TikTok verifica il formato solo dopo aver scaricato il file, quindi un formato non supportato fallisce più tardi con file_format_check_failed. publish_tiktok_post rifiuta i link che terminano in .png, .gif, .bmp, .heic, .avif o .svg prima di inviare qualsiasi cosa.

In cosa differiscono titolo e didascalia?

Sono campi separati con limiti separati. Il titolo contiene fino a 90 unità di codice UTF-16. La didascalia è la descrizione del post, fino a 4.000, e può contenere #hashtag e @menzioni dei follower reciproci dell'account, al massimo 30. Entrambi sono conteggiati in unità di codice UTF-16, quindi un'emoji può valerne due o più. publish_tiktok_post li accetta come title e caption.

Chi vede il post e si possono fare commenti?

privacy_level decide chi lo vede: PUBLIC_TO_EVERYONE, MUTUAL_FOLLOW_FRIENDS, FOLLOWER_OF_CREATOR o SELF_ONLY, entro le opzioni che GET /business/video/settings/ restituisce per l'account. TikTok elenca PUBLIC_TO_EVERYONE solo per gli account pubblici, ed è il livello impostato da publish_tiktok_post. I commenti sono attivi a meno che disable_comment non sia true, e un account che non accetta commenti da nessuno accetta solo true.

Cosa succede dopo la chiamata?

TikTok restituisce un share_id e scarica le immagini in background. get_tiktok_publish_status usa quel share_id e segnala PROCESSING_DOWNLOAD mentre TikTok recupera le immagini, PUBLISH_COMPLETE una volta che il post ha superato la moderazione, oppure FAILED con un motivo come photo_pull_failed. TikTok limita i post fotografici a sei al minuto e 15 al giorno per account tramite questo endpoint.

Errori comuni

  • Inviare immagini PNG. I post fotografici di TikTok accettano solo JPG, JPEG o WebP, quindi converti i file prima di pubblicarli.
  • Contare il titolo in caratteri come li vedi. TikTok conta le unità di codice UTF-16, quindi un titolo con emoji raggiunge 90 prima.
  • Usare immagini oltre 1080 x 1920 pixel. È la risoluzione massima di TikTok per i post fotografici, quindi ridimensiona prima le immagini più grandi.
  • Mettere la copertina in una posizione diversa dalla prima. publish_tiktok_post usa la prima immagine come copertina.
Farlo con EasyCoexistence

I post fotografici possono anche andare online a una data e un orario che imposti, dalla loro coda dedicata. Da US$ 9 a US$ 0.75 per connessione al mese, che scende man mano che aggiungi connessioni, con i primi 3 giorni di prova gratuita.

Domande frequenti

Quante foto può avere un post TikTok tramite API?

Fino a 35, ciascuna un file JPG, JPEG o WebP di al massimo 20 MB.

Un post fotografico TikTok può usare immagini PNG?

No. L'endpoint foto accetta JPG, JPEG e WebP, e TikTok fa fallire un PNG dopo averlo scaricato, con file_format_check_failed.

Quanto può essere lungo il titolo di un post fotografico?

Fino a 90 unità di codice UTF-16. La didascalia è un campo separato e ne accetta fino a 4.000.

Quale immagine diventa la copertina?

Quella indicata da photo_cover_index, contando da 0. publish_tiktok_post lo lascia a 0, quindi la prima immagine è la copertina.

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