TikTok API for Business scopes: wat elk recht ontgrendelt
De API for Business van TikTok verleent toegang in twee lagen. De ontwikkelaarsapp heeft rechten onder TikTok Accounts, zoals Video Publish en Manage Account Comment, die endpoints openen. De autorisatie van de accounteigenaar geeft het toegangstoken scopes, zoals user.insights en video.list, die bepalen welke velden worden teruggegeven. /tt_user/token_info/get/ toont de scopes die een token bevat.
easyCoexistence vraagt de TikTok-accounteigenaar in één keer inloggen om de rechten die de app heeft, zodat Claude, ChatGPT of je eigen code via de tools van easyCoexistence kunnen publiceren, comments beheren en statistieken lezen, en get_social_credentials geeft je eigen code hetzelfde token voor andere endpoints van de Accounts API.
Scope-ID van TikTok Accounts, het recht op het eerste niveau boven de profiel-, post-, comment- en publicatie-endpoints van de Accounts API.
Scope achter is_business_account en has_advanced_access in de profieldata van een account.
Scope die de eigenaar moet verlenen en actief moet houden, zodat de app comment.update-webhook-events ontvangt.
Scope die een token nodig heeft om een post als concept te uploaden in plaats van te publiceren.
Werkdagen die de beoordeling door TikTok van een wijziging in de rechten van een ontwikkelaarsapp kan duren.
Wat zijn de twee lagen van TikTok-rechten?
App-rechten en token-scopes. App-rechten kies je onder My Apps, de app, Scope of permission, en TikTok beoordeelt ze. Ze komen in drie niveaus, en een recht op het eerste niveau dekt elk endpoint daaronder. Token-scopes zijn wat de accounteigenaar heeft goedgekeurd bij het autoriseren van de app; ze worden per token teruggegeven als scope, één door komma's gescheiden string. Een aanroep heeft het app-recht voor het endpoint nodig, en sommige antwoordvelden hebben daarnaast een scope op het token nodig.
Welk app-recht opent elk endpoint?
De API-referentie van TikTok geeft voor elk endpoint van de Accounts API het recht onder TikTok Accounts dat het opent, of geen. De permission scope-referentie en de webhookgids noemen dezelfde groepen Business User, Business Media, Business Comment en Business Content, dus reken op beide sets namen:
Welke token-scopes ontgrendelen welke velden?
De referenties van TikTok voor /business/get/ en /business/video/list/ geven per antwoordveld een vereist recht, en twee andere functies noemen een eigen scope:
- user.info.basic:
display_nameenprofile_image. - user.info.username: username, dat tot juni 2023 user.info.basic nodig had.
- user.info.profile:
profile_deep_link,bio_descriptionenis_verified. - user.info.stats:
following_count,followers_count,total_likesenvideos_count. - user.account.type:
is_business_accountenhas_advanced_access. - user.insights: de dagelijkse accountstatistieken en de volgersuitsplitsingen naar leeftijd, geslacht, land en stad.
- video.list: postvelden zoals
item_id, caption,share_url, likes, comments, shares, reach envideo_views. - video.insights: kijktijd, het percentage volledig bekeken, retentie, verkeersbronnen, kijkersuitsplitsingen en de klikken die een post oplevert.
- comment.list: de comment.update-webhook, door TikTok omschreven als het lezen van de reacties en antwoorden op in-app content.
- video.upload: het uploaden van een video- of fotopost als concept, met
upload_to_draftofis_draft.
Hoe zie je de scopes op een token?
Vraag /tt_user/token_info/get/ op, met de app_id en het toegangstoken. Die geeft de scope van het token en de creator_id van het account terug. De voorbeeld-scopestrings van TikTok bevatten ook video.publish en comment.list.manage, waarvan de namen overeenkomen met de publicatie- en commentbeheer-endpoints, al koppelen de referenties geen veld aan een van beide.
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"
}
}Wat vraagt de TikTok-verbinding van easyCoexistence?
De rechten die de ontwikkelaarsapp heeft, allemaal zichtbaar op de toestemmingspagina van TikTok. easyCoexistence stuurt de accounteigenaar naar de autorisatie-URL voor de accounthouder van TikTok die het TikTok-portaal voor de app genereert. Die URL noemt die rechten al, en easyCoexistence voegt er alleen een eigen state-waarde aan toe. De eigenaar keurt goed wat TikTok toont, en de scopestring die TikTok teruggeeft, wordt bij de verbinding opgeslagen. De endpoints die easyCoexistence daarna voor het account aanroept:
- /business/get/ voor het profiel, de dagelijkse statistieken en de volgersuitsplitsingen.
- /business/video/list/ voor posts en hun statistieken.
- /business/video/publish/, /business/photo/publish/ en /business/publish/status/ voor publicatie.
- /business/comment/list/, /business/comment/reply/create/, /business/comment/hide/ en /business/comment/delete/ voor comments.
- /business/webhook/update/, op appniveau, voor de comment-webhook.
Hoe voeg je later een recht toe?
In twee stappen, één per laag. Voor de app open je My Apps, de app, Scope of permission, bewerk die, geef een reden die bij de nieuwe scopes past en dien in. De beoordeling door TikTok kan twee tot drie werkdagen duren, en sinds 20 maart 2026 heeft een aanvraag die TikTok Accounts bevat eerst het Accounts API Access Application Form nodig. Voor het token autoriseert de eigenaar de app opnieuw, want een token houdt de scopes die bij uitgifte zijn goedgekeurd.
Wat gebeurt er als een recht ontbreekt?
Bij een aanroep is de retourcode van TikTok 40001, geen toestemming voor de bijbehorende bewerking, en de oplossing verwijst naar de permission scope-referentie. Bij een veld maken de referenties het pas beschikbaar nadat de eigenaar de scope heeft verleend, en hun oplossing is dat de eigenaar de app opnieuw autoriseert met die scope. Controleer de scope van het token met /tt_user/token_info/get/ voordat je het vraagt.
Veelgemaakte fouten
- Verwachten dat gekoppelde accounts vanzelf een nieuw app-recht krijgen. Hun tokens houden de scopes die bij autorisatie zijn goedgekeurd, totdat elke eigenaar de app opnieuw autoriseert.
- is_business_account vragen zonder user.account.type. TikTok maakt dat veld en has_advanced_access alleen beschikbaar voor tokens met die scope.
- Wachten op comment.update zonder comment.list. TikTok stuurt commentevents alleen zolang de autorisatie van de eigenaar met die scope geldig blijft.
- Het token doorzoeken op namen van app-rechten. De scopestring gebruikt namen zoals video.list, terwijl namen zoals Get Account Media bij de instellingen van de app horen.
US$ 9 tot US$ 0,75 per verbinding per maand, dalend naarmate je meer verbindingen toevoegt, met een gratis proefperiode van 3 dagen.
Veelgestelde vragen
Welke scopes gebruikt de TikTok API for Business?
Token-scopes zoals user.info.basic, user.info.stats, user.insights, video.list, video.insights, comment.list en video.upload, verleend door de accounteigenaar bovenop de TikTok Accounts-rechten van de app.
Welke rechten heeft de comment-webhook van TikTok nodig?
De app heeft TikTok Accounts en Business Comment nodig, en de eigenaar moet comment.list verlenen. Events stoppen als die autorisatie verloopt of wordt ingetrokken.
Geldt een nieuwe TikTok-scope ook voor al uitgegeven tokens?
Nee. Een token houdt de scopes die bij uitgifte zijn goedgekeurd, dus de accounteigenaar autoriseert de app opnieuw om een nieuwe toe te voegen.
Hoelang duurt het voordat TikTok een nieuw recht goedkeurt?
TikTok zegt dat de beoordeling van een wijziging in rechten twee tot drie werkdagen kan duren, en aanvragen die TikTok Accounts toevoegen, hebben eerst het Accounts API Access Application Form nodig.
Lees verder
Koppel je eerste kanaal in twee minuten.
Geen platformbeoordelingen om op te wachten. Verbind WhatsApp, Instagram, TikTok of een ander kanaal, vraag je AI om te posten, te reageren of een rapport te maken, en zie het aan het werk.
- 3 dagen gratis
- Op elk moment opzegbaar
- Alleen officiële API's
- 24/7 bewaakt
Geverifieerd op