AccediInizia la prova gratuita
easyCoexistence API ufficiali

Scope dell'API for Business di TikTok: cosa sblocca ogni permesso

L'API for Business di TikTok concede l'accesso su due livelli. L'app per sviluppatori detiene i permessi in TikTok Accounts, come Video Publish e Manage Account Comment, che aprono gli endpoint. L'autorizzazione del titolare dell'account assegna al token di accesso gli scope, come user.insights e video.list, che decidono i campi restituiti. /tt_user/token_info/get/ elenca gli scope di cui è dotato un token.

easyCoexistence chiede al titolare dell'account TikTok i permessi che la sua app detiene con un solo accesso, così Claude, ChatGPT o il tuo codice possono pubblicare, gestire i commenti e leggere le metriche tramite i suoi strumenti, e get_social_credentials fornisce al tuo codice lo stesso token per altri endpoint dell'API Accounts.

18000000

ID di scope di TikTok Accounts, il permesso di primo livello sopra gli endpoint di profilo, post, commento e pubblicazione dell'API Accounts.

user.account.type

Scope da cui dipendono is_business_account e has_advanced_access nei dati del profilo di un account.

comment.list

Scope che il titolare deve concedere e mantenere attivo perché l'app riceva gli eventi webhook comment.update.

video.upload

Scope necessario a un token per caricare un post come bozza invece di pubblicarlo.

2 to 3 days

Giorni lavorativi che può richiedere la revisione di TikTok su una modifica ai permessi di un'app per sviluppatori.

Quali sono i due livelli dei permessi TikTok?

Permessi dell'app e scope del token. I permessi dell'app si scelgono in My Apps, nell'app, Scope of permission, e TikTok li revisiona; sono su tre livelli, e un permesso di primo livello copre tutti gli endpoint sottostanti. Gli scope del token sono ciò che il titolare dell'account ha approvato autorizzando l'app, restituiti come stringa scope, con valori separati da virgola, in ogni token. Una chiamata richiede il permesso dell'app per il suo endpoint, e alcuni campi della risposta richiedono anche uno scope sul token.

Quale permesso dell'app apre ogni endpoint?

La documentazione dell'API di TikTok elenca, per ogni endpoint dell'API Accounts, il permesso in TikTok Accounts che lo apre, oppure nessuno. La documentazione dei permission scope e la guida ai webhook chiamano gli stessi gruppi Business User, Business Media, Business Comment e Business Content, quindi troverai entrambi i set di nomi:

Account User/business/get/: profile data and account insights
Get Account Media/business/video/list/: the account's posts and their metrics
Video Publish/business/video/publish/, /business/publish/status/, /business/video/settings/, hashtag suggestions and location tags
Photo Publish/business/photo/publish/
Get Business Comment/business/comment/list/ and /business/comment/reply/list/
Manage Account CommentCreating, replying to, liking, hiding and deleting comments, and comment image uploads
Business Benchmark/business/benchmark/: benchmarks for a business category
No permission needed/tt_user/token_info/get/, the URL property endpoints and the webhook configuration endpoints

Quali scope del token sbloccano quali campi?

Le documentazioni di /business/get/ e /business/video/list/ indicano un permesso richiesto per ogni campo della risposta, e altre due funzionalità citano uno scope proprio:

  • user.info.basic: display_name e profile_image.
  • user.info.username: username, che fino a giugno 2023 richiedeva user.info.basic.
  • user.info.profile: profile_deep_link, bio_description e is_verified.
  • user.info.stats: following_count, followers_count, total_likes e videos_count.
  • user.account.type: is_business_account e has_advanced_access.
  • user.insights: le metriche giornaliere dell'account e le suddivisioni dei follower per età, genere, paese e città.
  • video.list: campi dei post come item_id, caption, share_url, likes, comments, shares, reach e video_views.
  • video.insights: tempo di visione, tasso di visione completa, retention, fonti di traffico, suddivisioni degli spettatori e i clic generati da un post.
  • comment.list: il webhook comment.update, che TikTok descrive come lettura dei commenti e delle risposte ai contenuti in-app.
  • video.upload: caricamento di un post video o foto come bozza, con upload_to_draft o is_draft.

Come si vedono gli scope di un token?

Chiedi a /tt_user/token_info/get/, che riceve app_id e il token di accesso e restituisce lo scope del token e il creator_id dell'account. Gli esempi di stringhe di scope di TikTok includono anche video.publish e comment.list.manage, i cui nomi corrispondono agli endpoint di pubblicazione e di gestione dei commenti, anche se la documentazione non collega alcun campo a nessuno dei due.

Read the scopes an access token carries
curl -X POST 'https://business-api.tiktok.com/open_api/v1.3/tt_user/token_info/get/' \
  -H 'Content-Type: application/json' \
  -d '{"app_id": "<APP_ID>", "access_token": "<ACCESS_TOKEN>"}'

{
  "code": 0,
  "message": "OK",
  "request_id": "<REQUEST_ID>",
  "data": {
    "app_id": "<APP_ID>",
    "creator_id": "<OPEN_ID>",
    "scope": "video.publish,user.info.basic,video.list,user.insights,comment.list.manage,video.insights,comment.list"
  }
}

Quali permessi chiede la connessione TikTok di easyCoexistence?

I permessi che la sua app per sviluppatori detiene, tutti mostrati nella pagina di consenso di TikTok. easyCoexistence invia il titolare dell'account all'URL di autorizzazione dell'account holder di TikTok che il portale di TikTok genera per la sua app, il quale già indica quei permessi, e aggiunge solo un proprio valore state. Il titolare approva ciò che TikTok mostra, e la stringa di scope restituita da TikTok viene salvata con la connessione. Gli endpoint che easyCoexistence chiama poi per l'account:

  • /business/get/ per il profilo, le metriche giornaliere e le suddivisioni dei follower.
  • /business/video/list/ per i post e le loro metriche.
  • /business/video/publish/, /business/photo/publish/ e /business/publish/status/ per la pubblicazione.
  • /business/comment/list/, /business/comment/reply/create/, /business/comment/hide/ e /business/comment/delete/ per i commenti.
  • /business/webhook/update/, a livello di app, per il webhook dei commenti.

Come si aggiunge un permesso in seguito?

In due passaggi, uno per livello. Per l'app, apri My Apps, l'app, Scope of permission, modificalo, indica un motivo coerente con i nuovi scope e invia; la revisione di TikTok può richiedere due o tre giorni lavorativi, e dal 20 marzo 2026 una richiesta che include TikTok Accounts richiede prima il modulo Accounts API Access Application Form. Per il token, il titolare autorizza di nuovo l'app, perché un token mantiene gli scope approvati al momento del rilascio.

Cosa succede quando manca un permesso?

Per una chiamata, il codice restituito da TikTok è 40001, nessun permesso per eseguire l'operazione collegata, e la soluzione rimanda alla documentazione dei permission scope. Per un campo, la documentazione lo rende disponibile solo quando il titolare ha concesso il suo scope, e la soluzione è far autorizzare di nuovo l'app al titolare con quello scope. Controlla lo scope del token con /tt_user/token_info/get/ prima di chiedere al titolare.

Errori comuni

  • Aspettarsi che gli account collegati ottengano da soli un nuovo permesso dell'app. I loro token mantengono gli scope approvati all'autorizzazione finché ogni titolare non autorizza di nuovo l'app.
  • Richiedere is_business_account senza user.account.type. TikTok rende disponibili quel campo e has_advanced_access solo ai token che hanno quello scope.
  • Attendere comment.update senza comment.list. TikTok invia eventi di commento solo finché l'autorizzazione del titolare con quello scope resta valida.
  • Cercare nel token i nomi dei permessi dell'app. La stringa di scope usa nomi come video.list, mentre nomi come Get Account Media appartengono alle impostazioni dell'app.
Farlo con EasyCoexistence

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

Domande frequenti

Quali scope usa l'API for Business di TikTok?

Scope del token come user.info.basic, user.info.stats, user.insights, video.list, video.insights, comment.list e video.upload, concessi dal titolare dell'account in aggiunta ai permessi TikTok Accounts dell'app.

Quali permessi servono al webhook dei commenti di TikTok?

L'app ha bisogno di TikTok Accounts e Business Comment, e il titolare deve concedere comment.list. Gli eventi si interrompono se quell'autorizzazione scade o viene revocata.

Un nuovo scope di TikTok vale per i token già rilasciati?

No. Un token mantiene gli scope approvati al momento del rilascio, quindi il titolare autorizza di nuovo l'app per aggiungerne uno nuovo.

Quanto tempo impiega TikTok ad approvare un nuovo permesso?

TikTok afferma che la revisione di una modifica ai permessi può richiedere due o tre giorni lavorativi, e le richieste che aggiungono TikTok Accounts richiedono prima il modulo Accounts API Access Application Form.

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