Modifiche alle API di TikTok nel 2026: cosa ha smesso di funzionare e cosa fare
Quattro modifiche alle API di TikTok nel 2026 richiedono un intervento: TikTok for Developers documenta ora token di accesso di 2 ore e refresh token a rotazione di 180 giorni (2 novembre); is_business_account indica solo il Verified Business Account (16 ottobre); le nuove app della Accounts API richiedono il modulo di accesso di TikTok (20 marzo); e gli account sandbox dell'API for Business cessano il 1° dicembre. La maggior parte delle altre modifiche aggiunge campi, come il testo dei commenti nei webhook.
easyCoexistence mantiene aggiornata la connessione TikTok per Claude, ChatGPT o la tua piattaforma: token rinnovati in anticipo, has_advanced_access e is_business_account nei campi profilo predefiniti, eventi dei commenti inoltrati con il testo e il token dell'account da get_social_credentials per il resto dell'API for Business.
Le pagine dei token di TikTok for Developers sono state aggiornate: i token di accesso utente durano 2 ore, i refresh token 180 giorni e ruotano a ogni rinnovo.
Da allora, is_business_account su /business/get/ segnala solo i Verified Business Account, mentre has_advanced_access indica l'Advanced Access.
Limite di caratteri per un commento o una risposta tramite l'API dal 7 agosto 2026, salito da 150.
Quando TikTok ha aggiunto il testo del commento all'evento webhook comment.update.
Inizio della regola secondo cui una nuova app o un ampliamento dello scope con TikTok Accounts richiede l'Accounts API Access Application Form.
Data entro cui TikTok ritira gli account sandbox dell'API for Business, consigliando di usare account di test in produzione.
Quali modifiche alle API di TikTok del 2026 rompono qualcosa?
Le pagine What's New e di riferimento su business-api.tiktok.com, insieme al Changelog e alle pagine dei token su developers.tiktok.com, registrano queste modifiche del 2026 alle API che gestiscono gli account e i loro contenuti. Dalla più recente, con la data futura in cima; la maggior parte aggiunge campi, e alcune richiedono un intervento:
| What breaks | The fix | |
|---|---|---|
| Dec 1: sandbox accounts end | Tests against sandbox-ads.tiktok.com | A test account in production |
| Nov 2: shorter developer tokens | Daily refresh jobs and reused refresh tokens | Refresh within expires_in and save each new refresh_token |
| Oct 16: is_business_account | Checks that read it as Advanced Access | Read has_advanced_access as well |
| Sep 25: hashtag post counts | Nothing; the order follows post counts | Rank with the new post_count |
| Aug 7: 1,200-character comments | Nothing; 150 is no longer the cap | Lift your own 150 limit |
| Jul 24: location tags | Nothing | Optional location_id with location_name |
| Jun 18: text in comment.update | Nothing | Read text from the event |
| May 21: Research API fields | Nothing | favorites_count and display_name |
| May 15: is_ad on posts | Nothing | An optional field to request |
| Mar 20: access form | App or scope requests without it | Submit the form first |
| Feb 26: Research API coverage | Comparisons with earlier pulls | Pull the baseline again |
| Feb 13: images in comments | Code that expects text on each comment | Handle image_url |
| Jan 16: commercial music | Nothing | Optional music_sound_info |
Cosa termina il 1° dicembre 2026?
Gli account sandbox dell'API for Business. La pagina sandbox di TikTok dice che verranno ritirati entro il 1° dicembre 2026 e consiglia di creare un proprio account di test in produzione. Sono account pubblicitari con dati di report simulati su https://sandbox-ads.tiktok.com/open_api, quindi i test della Accounts API passano a un vero account TikTok riservato ai test, con l'URL del video di prova che TikTok fornisce per /business/video/publish/.
Cosa è cambiato per i token di TikTok for Developers il 2 novembre 2026?
Le pagine sui token ora assegnano ai token di accesso utente 2 ore dalla emissione e ai refresh token 180 giorni dalla prima emissione, e i refresh token ruotano: un rinnovo riuscito restituisce un nuovo refresh_token e invalida immediatamente quello inviato. Ciò che si rompe è un job che rinnova una volta al giorno o riutilizza un refresh token salvato. La correzione è rinnovare entro expires_in, salvare ogni nuovo refresh_token prima di usarlo e pianificare la riautorizzazione entro 180 giorni. La guida all'autenticazione dell'API for Business assegna ancora ai token degli account TikTok un giorno e un anno.
Cosa è cambiato in is_business_account il 16 ottobre 2026?
TikTok ha aggiunto has_advanced_access a /business/get/, come valore per fields e come campo di risposta, e ha ristretto is_business_account a indicare solo un Verified Business Account. Il codice che leggeva is_business_account come segno dell'Advanced Access ora riceve false per gli account che hanno l'Advanced Access senza verifica. La correzione è richiedere entrambi i campi, che necessitano dello scope user.account.type, e condizionare le funzionalità dell'Advanced Access al valore true di almeno uno dei due.
Cosa è cambiato nei suggerimenti di hashtag il 25 settembre 2026?
/business/hashtag/suggestion/ ha ottenuto post_count, il numero di post che hanno usato ciascun hashtag consigliato, e i suoi 10 suggerimenti sono ora ordinati per numero di post dopo una corrispondenza esatta, cosa che TikTok dice rispecchia i consigli dell'app. Nulla è stato rimosso, quindi il codice esistente continua a funzionare; una classifica basata sul vecchio ordine cambia, e post_count serve proprio a ordinare.
Cosa è cambiato per il testo dei commenti il 7 agosto 2026?
TikTok ha portato il limite del testo in /business/comment/create/ e /business/comment/reply/create/ da 150 a 1.200 caratteri, e anche nella risposta a una menzione di commento della Mentions API. Non si rompe nulla. Il codice che troncava le risposte a 150 caratteri per un limite di TikTok ormai superato può lasciarle più lunghe, tenendo presente l'avviso di TikTok secondo cui molti commenti simili tra loro pubblicati in poco tempo possono essere segnalati come spam.
Quali aggiunte del 2026 non richiedono modifiche al codice?
Tre aggiunte di pubblicazione e di post sono campi facoltativi che le chiamate esistenti possono ignorare:
- 24 luglio: /business/publish/location/ elenca i tag di località di un account, e gli endpoint di pubblicazione accettano
location_idinsieme alocation_name, che è obbligatorio in abbinamento. - 15 maggio:
is_adsu /business/video/list/, come campo da richiedere e come valore di risposta, indica se un post è promosso come annuncio. - 16 gennaio:
music_sound_infosugli endpoint di pubblicazione di video e foto collega una traccia della Commercial Music Library.
Cosa è cambiato nei webhook dei commenti il 18 giugno 2026?
comment.update ha ottenuto text, il contenuto del commento o della risposta, accanto a comment_id, video_id, comment_action e all'unique_identifier del commentatore. Un ricevitore può leggere le parole dall'evento invece di chiamare /business/comment/list/; il nome visualizzato e lo username del commentatore continuano a provenire da quella lista, e anche gli ID in content sono ancora numeri JSON troppo grandi per un double.
Cosa è cambiato nella Research API quest'anno?
Due modifiche, entrambe nei Research Tools di TikTok for Developers. Il 26 febbraio TikTok ha cambiato la sua pipeline dei dati per coprire tutti i contenuti video pubblici, inclusi quelli non idonei al feed For You, quindi i conteggi confrontati con estrazioni precedenti possono cambiare. Il 21 maggio, Query Videos e le query sui video piaciuti, fissati e ripubblicati dall'utente hanno iniziato a restituire favorites_count, e Query Video Comments ha iniziato a restituire display_name per commenti e risposte.
Cosa è cambiato nella revisione delle app il 20 marzo 2026?
Dalle 00:00 GMT di quel giorno, gli sviluppatori devono completare l'Accounts API Access Application Form di TikTok prima di inviare una nuova app o di chiedere un ampliamento dello scope che include il permesso TikTok Accounts. Ciò che si rompe è un invio fatto senza il modulo. La correzione è completare prima il modulo, con informazioni chiare e accurate, e poi inviare l'app o la modifica dello scope; la revisione di TikTok può richiedere da 2 a 3 giorni lavorativi per dare una risposta.
Cosa è cambiato per i commenti il 13 febbraio 2026?
I commenti possono contenere immagini. /business/comment/image/upload/ accetta un'immagine e restituisce un image_uri, che /business/comment/create/ e /business/comment/reply/create/ accettano insieme a image_width e image_height, e le liste dei commenti restituiscono image_url per i commenti con immagine. Il testo è ora una delle due opzioni di una risposta, quindi il codice che presume che ogni commento abbia del testo dovrebbe gestire anche image_url.
Cosa è segnalato per la rimozione senza una data?
user_id nelle risposte dei commenti. I riferimenti di TikTok per /business/comment/list/ e /business/comment/reply/create/ lo contrassegnano come To-be-deprecated, dicendo che sarà ritirato nella prossima versione dell'API, e raccomandano unique_identifier, che resta invariato tra le API. La v1.3 non ha una data di fine: la timeline delle versioni di TikTok la indica come disponibile fino a TBD.
Come gestisce easyCoexistence queste modifiche?
La sua connessione TikTok usa i token dell'API for Business, che mantengono la durata di un giorno e di un anno e che easyCoexistence rinnova da sé, quindi la modifica del 2 novembre non lo raggiunge. Il resto, modifica per modifica:
- Una lista di metriche vuota in
get_social_insightsrichiede a TikTok entrambi i flag,is_business_accountehas_advanced_access. reply_to_commentinvia il testo così come lo scrivi, quindi si applica il limite di 1.200 caratteri di TikTok, mentre le automazioni mantengono le risposte di TikTok a 150 caratteri e le regole sui commenti a 500.- Gli eventi comment.update inoltrati contengono text così come li invia TikTok, con gli ID convertiti in stringhe.
is_ade gli altri campi della lista dei post sono raggiungibili dal tuo codice su business/video/list/, con il token diget_social_credentials.- Per i test non serve alcuna sandbox: un account di tua proprietà si collega accedendo su TikTok.
Errori comuni
- Codificare fisse le durate dei token. TikTok for Developers ha cambiato le durate documentate il 2 novembre 2026, mentre il suo esempio di refresh mostra ancora 86400: pianifica quindi i rinnovi in base a expires_in in ogni risposta.
- Conservare il primo refresh token. Su TikTok for Developers, ogni rinnovo restituisce un nuovo refresh_token e invalida quello inviato, quindi salva ogni volta il più recente.
- Limitare le funzionalità dell'Advanced Access solo con is_business_account. Dal 16 ottobre 2026 è false per gli account con Advanced Access non verificati.
- Mantenere il limite di 150 caratteri per un motivo ormai superato. Gli endpoint dei commenti accettano fino a 1.200 caratteri dal 7 agosto 2026.
Da US$ 9 a US$ 0,75 per connessione al mese, in calo man mano che aggiungi connessioni, con i primi 3 giorni gratuiti.
Domande frequenti
L'API for Business ha cambiato le durate dei token nel 2026?
No. La sua guida all'autenticazione assegna ancora ai token di accesso degli account TikTok un giorno e ai refresh token un anno; le durate di 2 ore e 180 giorni sono quelle di TikTok for Developers.
Dove TikTok annuncia le modifiche alle API?
In What's New su business-api.tiktok.com per l'API for Business, e nel Changelog su developers.tiktok.com per TikTok for Developers. Anche le pagine di riferimento riportano note datate, come quella del modulo del 20 marzo.
TikTok ha cambiato i limiti di frequenza della Accounts API nel 2026?
Le voci What's New 2026 sulla Accounts API non registrano modifiche: 40 chiamate al minuto per account su ciascun endpoint, e 600 o 1.000 al minuto per app.
Quale modifica del 2026 conta di più per un agente AI che risponde ai commenti TikTok?
Due: le risposte possono arrivare a 1.200 caratteri dal 7 agosto, e comment.update contiene il testo del commento dal 18 giugno, quindi un agente lo legge dall'evento.
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