AccediInizia la prova gratuita
easyCoexistence API ufficiali

Guida alla TikTok API 2026: dalla tua app al primo post

Per passare da un'app per sviluppatori al primo post su TikTok nel 2026, registrati come azienda sulla API for Business di TikTok, crea un'app con il permesso TikTok Accounts, fai approvare l'app dal titolare dell'account, scambia il codice con un token di accesso valido 24 ore e chiama /business/video/publish/ con un URL video verificato. Segui lo share_id restituito finché non compare PUBLISH_COMPLETE, poi aggiungi commenti, webhook e insight.

easyCoexistence gestisce il lato sviluppatore per te: la propria app per la API for Business e il proprio percorso per i media verificati, token rinnovati e ogni account controllato circa ogni 6 ore, così Claude, ChatGPT o la tua piattaforma pubblica post, risponde ai commenti e legge gli insight su TikTok tramite un solo connettore MCP o la Partner API.

3 business days

Quando TikTok risponde a una registrazione di sviluppatore, che richiede un'email su dominio aziendale verificato e un sito web aziendale.

Mar 20, 2026

Data da cui le nuove app e le richieste di scope che includono TikTok Accounts richiedono prima il modulo Accounts API Access Application Form.

10 minutes

Durata dell'auth_code restituito dall'approvazione del titolare; funziona per un solo scambio su /tt_user/oauth2/token/.

share_id

Ciò che restituiscono entrambi gli endpoint di pubblicazione, da passare come publish_id a /business/publish/status/ per seguire il post.

Private

Modalità di visualizzazione che TikTok applica ai contenuti pubblicati tramite la Content Posting API da app non ancora sottoposte a revisione.

40/min

Chiamate per account autorizzato su ciascun endpoint della Accounts API, entro un budget dell'app di 600 al minuto al livello Basic.

Qual è il percorso da un'app per sviluppatori TikTok al primo post?

Cinque fasi sulla API for Business di TikTok, ciascuna con una propria revisione o verifica. La registrazione e la revisione dell'app avvengono una volta sola, l'autorizzazione una volta per ogni account che l'app gestisce, e le ultime due fasi si ripetono per ogni post. Le sezioni seguenti le illustrano in ordine, con l'endpoint, il campo e il limite su cui ciascuna si basa:

1RegisterA company developer profile, answered in three business days
2App reviewThe TikTok Accounts permission and the access form, then 2 to 3 business days
3AuthorizeThe owner approves, and a 10-minute code becomes a 24-hour token
4PublishA verified media URL in, a share_id out
5Follow upStatus, comments, webhooks and insights

Quale API di TikTok ti serve?

Quella adatta al tuo scopo. TikTok gestisce due portali per sviluppatori: business-api.tiktok.com per la API for Business e developers.tiktok.com per TikTok for Developers, sede delle API Content Posting, Display e Research. Per gestire post, commenti e insight di account che un'azienda possiede o serve, la API for Business è quella con gli endpoint dei commenti e i webhook dei commenti:

API for Business (Accounts API)Publishes videos and photo posts, moderates comments, reads insights and sends webhooks for authorized accounts
Content Posting APIApps creators use to post their own content, directly or as drafts; private until TikTok audits the app
Display APIAn authorized user's profile and recent public videos: /v2/user/info/, /v2/video/list/, /v2/video/query/
Research APIPublic video, comment and account data for vetted researchers working on a not-for-profit basis

Quali account TikTok può gestire l'app?

Account personali e account aziendali allo stesso modo. L'Accounts API di TikTok distingue tre livelli: il General TikTok Account con cui parte chiunque; un account con Advanced Access, collegato a un account TikTok for Business o a un Business Center non verificato; e il Verified Business Account. Gli endpoint di pubblicazione e dei commenti non indicano alcun livello di account, mentre alcuni campi di insight, la Mentions API e la Business Messaging API richiedono Advanced Access o un Verified Business Account.

Come ti registri e ottieni l'approvazione dell'app?

Come azienda, sul portale TikTok for Business Developers, in tre passaggi che TikTok verifica:

  • Registrazione sviluppatore: un'email su dominio aziendale verificato e un sito web aziendale pubblico su un dominio di proprietà dell'azienda; TikTok risponde in 3 giorni lavorativi e non accoglie singoli sviluppatori.
  • Modulo Accounts API Access Application Form: obbligatorio dal 20 marzo 2026 prima di una nuova app, o di un ampliamento di scope, che includa il permesso TikTok Accounts.
  • App per sviluppatori: usi previsti e chi può accedervi, un URL di reindirizzamento e il permesso TikTok Accounts, revisionati in da 2 a 3 giorni lavorativi, con fino a cinque app per sviluppatore.

Quali permessi e scope serve l'app?

Due livelli, concessi da persone diverse. L'app per sviluppatori detiene i permessi sotto TikTok Accounts, scelti in Scope of permission e revisionati da TikTok, e ciascuno apre degli endpoint. L'approvazione del titolare dell'account applica gli scope al token di accesso, e questi sbloccano campi e funzioni, come user.insights per le metriche giornaliere dell'account, video.list e video.insights per i dati dei post, video.upload per le bozze e comment.list per il webhook dei commenti. /tt_user/token_info/get/ elenca gli scope che un token porta.

Come autorizza un account l'app, e a cosa servono i token?

Il titolare apre l'URL di autorizzazione del titolare dell'account TikTok dell'app, trovato in My Apps, App Detail, Basic Information, e approva i permessi. TikTok reindirizza all'URL di reindirizzamento dell'app con un auth_code, e il server lo scambia su /tt_user/oauth2/token/ per un token di accesso valido 24 ore, un refresh token valido un anno e l'open_id dell'account. Il token viaggia nell'header Access-Token e l'open_id in business_id a ogni chiamata all'Accounts API, mentre /tt_user/oauth2/refresh_token/ rinnova il token.

Come si pubblica un video e un post fotografico?

Con una POST ciascuno, da URL che TikTok scarica da sé, su un dominio o prefisso URL verificato per l'app. /business/video/publish/ richiede business_id, video_url e post_info, che contiene la didascalia e le etichette di marca ed è obbligatorio anche se vuoto. /business/photo/publish/ accetta fino a 35 photo_images in JPG, JPEG o WebP e un post_info il cui privacy_level è obbligatorio. Entrambi rispondono con uno share_id, e TikTok pubblica fino a sei post al minuto e 15 al giorno per account tramite ciascun endpoint.

Come sai che il post è online?

Interroga /business/publish/status/ con business_id e lo share_id come publish_id, oppure iscrivi l'app ai webhook di pubblicazione. Lo stato passa da PROCESSING_DOWNLOAD a PUBLISH_COMPLETE, oppure si ferma su FAILED con un motivo come frame_rate_check_failed; SEND_TO_USER_INBOX indica una bozza. I post_ids arrivano quando il post è visibile pubblicamente, fino a tre minuti dopo PUBLISH_COMPLETE, e /business/video/list/ filtra su questi ID per leggere le metriche del post.

Come si leggono e si rispondono i commenti?

Sui post dell'account stesso, tramite video_id, che è l'item_id di /business/video/list/. GET /business/comment/list/ restituisce commenti pubblici e nascosti, fino a 30 per pagina, e POST /business/comment/reply/create/ pubblica una risposta pubblica di fino a 1.200 caratteri, limite che TikTok ha alzato da 150 il 7 agosto 2026. Altri endpoint nascondono un commento o lo rendono di nuovo visibile, ed eliminano i commenti che l'account stesso ha scritto.

Come funzionano i webhook sulla API for Business?

Per app, non per account. POST /business/webhook/update/ con app_id, secret, un event_type e un callback_url HTTPS iscrive l'app: VIDEO attiva i quattro eventi di pubblicazione dei post, e COMMENT attiva comment.update entro cinque minuti da una modifica. Ogni consegna è firmata nell'header Tiktok-Signature con un HMAC-SHA256 con chiave il secret dell'app, richiede subito una risposta HTTP 200 e, se non arriva, viene ritentata per un massimo di 72 ore.

Da dove arrivano gli insight?

Da due endpoint. GET /business/get/ restituisce il profilo e le metriche giornaliere dell'account, come followers_count, video_views, profile_views e likes, fino a 60 giorni indietro in UTC. GET /business/video/list/ restituisce i conteggi complessivi di ciascun post, da video_views e reach fino ad average_time_watched, fino a 20 post per pagina. La maggior parte dei conteggi arriva con 24 a 48 ore di ritardo, e ogni campo richiede il proprio scope sul token.

Quali limiti condizionano l'integrazione?

Quattro, ciascuno conteggiato a sé:

  • 40 chiamate al minuto per account autorizzato su ciascun endpoint dell'Accounts API.
  • 600 chiamate al minuto per le chiamate all'Accounts API di un'app sommate, al livello Basic, e 1.000 sopra.
  • Sei post al minuto e 15 al giorno per account su ciascun endpoint di pubblicazione.
  • Il codice 40100 dentro una risposta HTTP 200 quando TikTok limita una chiamata: attendi 5 minuti dopo un limite al minuto, o fino alle 00:00 UTC dopo uno giornaliero.

Qual è il percorso con easyCoexistence?

Più breve, perché easyCoexistence ha già curato il lato sviluppatore con la propria app per la API for Business e il proprio percorso per i media verificati. Un account personale o aziendale si collega accedendo su TikTok, e poi Claude, ChatGPT o la tua piattaforma lavora con esso tramite un solo connettore MCP o la Partner API, senza registrazione, revisione dell'app o server di token propri:

1Sign upAn easyCoexistence account, with the first 3 days free
2Connect TikTokNew connection, then TikTok, and the owner approves on TikTok's screen
3Add the connectorhttps://easycoexistence.com/api/mcp in Claude or ChatGPT, or a Partner API key
4Askpublish_tiktok_post, list_social_comments, get_social_insights and the other tools

Errori comuni

  • Inviare l'app prima del modulo di accesso. Dal 20 marzo 2026 TikTok richiede prima il modulo Accounts API Access Application Form per una nuova app o una richiesta di scope che includa TikTok Accounts.
  • Ospitare i media su un dominio che l'app non ha verificato. TikTok scarica da sé video_url e photo_images e rifiuta gli URL fuori da un dominio o prefisso URL verificato.
  • Progettare per un solo account. Token, business_id e il limite di 40 al minuto appartengono a ciascun account, mentre le impostazioni dei webhook e il budget di chiamate complessivo appartengono all'app, quindi modella entrambi i livelli fin dall'inizio.
  • Chiedere solo gli scope che la funzione di oggi richiede. Un token mantiene gli scope approvati dal titolare, quindi aggiungere commenti o insight dopo significa che ogni titolare deve autorizzare di nuovo l'app.
Farlo con EasyCoexistence

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

Domande frequenti

Mi serve un'app per sviluppatori TikTok separata per ogni account cliente?

No. Un'unica app per sviluppatori serve gli account che la autorizzano, ciascuno con il proprio token e il proprio business_id, e TikTok consente fino a cinque app per sviluppatore.

L'Accounts API è la stessa cosa della Marketing API di TikTok?

No. Entrambe stanno nella API for Business, ma la Marketing API gestisce le inserzioni con token degli inserzionisti che non scadono, mentre l'Accounts API usa token degli account TikTok che durano un giorno.

Quale versione dell'API TikTok dovrebbe usare il nuovo codice?

La v1.3, disponibile dal 15 agosto 2022 senza una data di fine. La v1.2 non riceve aggiornamenti dal 15 agosto 2023, e TikTok introduce modifiche incompatibili solo nelle nuove versioni.

Quanto costa easyCoexistence per account TikTok?

Da US$ 9 a US$ 0,75 per connessione al mese, secondo la fascia in cui cade il totale delle connessioni, con i primi 3 giorni di prova gratuita. Ogni account TikTok è una connessione.

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