AnmeldenKostenlose Testphase starten
easyCoexistence Offizielle APIs

TikTok API for Business: Scopes und was jede Berechtigung freischaltet

Die API for Business von TikTok gewährt Zugriff in zwei Ebenen. Die Entwickler-App hält Berechtigungen unter TikTok Accounts, etwa Video Publish und Manage Account Comment, die Endpoints öffnen. Die Autorisierung durch den Kontoinhaber gibt dem Access-Token Scopes, etwa user.insights und video.list, die bestimmen, welche Felder zurückkommen. /tt_user/token_info/get/ listet die Scopes, die ein Token trägt.

easyCoexistence fragt den TikTok-Kontoinhaber mit einer einzigen Anmeldung nach den Berechtigungen seiner App, sodass Claude, ChatGPT oder Ihr eigener Code über ihre Tools veröffentlichen, mit Kommentaren arbeiten und Insights lesen können.

18000000

Scope-ID von TikTok Accounts, der Berechtigung der ersten Ebene oberhalb der Profil-, Post-, Kommentar- und Veröffentlichungs-Endpoints der Accounts API.

user.account.type

Scope hinter is_business_account und has_advanced_access in den Profildaten eines Kontos.

comment.list

Scope, den der Inhaber erteilen und aktiv halten muss, damit die App comment.update-Webhook-Ereignisse empfängt.

video.upload

Scope, den ein Token braucht, um einen Post als Entwurf statt zur Veröffentlichung hochzuladen.

2 to 3 days

Werktage, die die Prüfung einer Änderung an den Berechtigungen einer Entwickler-App durch TikTok dauern kann.

Was sind die zwei Ebenen der TikTok-Berechtigungen?

App-Berechtigungen und Token-Scopes. App-Berechtigungen werden unter My Apps, der App, Scope of permission gewählt, und TikTok prüft sie; es gibt drei Stufen, und eine Berechtigung der ersten Stufe deckt jeden Endpoint darunter ab. Token-Scopes sind das, was der Kontoinhaber bei der Autorisierung der App freigegeben hat; sie werden als scope, ein kommagetrennter String, mit jedem Token zurückgegeben. Ein Aufruf braucht die App-Berechtigung für seinen Endpoint, und manche Antwortfelder brauchen zusätzlich einen Scope auf dem Token.

Welche App-Berechtigung öffnet jeden Endpoint?

Die API-Referenz von TikTok listet für jeden Endpoint der Accounts API die Berechtigung unter TikTok Accounts auf, die ihn öffnet, oder keine. Ihre Referenz zu Berechtigungs-Scopes und der Webhook-Leitfaden nennen dieselben Gruppen Business User, Business Media, Business Comment und Business Content, daher sollten Sie mit beiden Namenssätzen rechnen:

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

Welche Token-Scopes schalten welche Felder frei?

Die Referenzen von TikTok zu /business/get/ und /business/video/list/ nennen für jedes Antwortfeld eine erforderliche Berechtigung, und zwei weitere Funktionen nennen einen eigenen Scope:

  • user.info.basic: display_name und profile_image.
  • user.info.username: username, das bis Juni 2023 user.info.basic benötigte.
  • user.info.profile: profile_deep_link, bio_description und is_verified.
  • user.info.stats: following_count, followers_count, total_likes und videos_count.
  • user.account.type: is_business_account und has_advanced_access.
  • user.insights: die täglichen Kontometriken und die Follower-Aufschlüsselungen nach Alter, Geschlecht, Land und Stadt.
  • video.list: Post-Felder wie item_id, caption, share_url, likes, comments, shares, reach und video_views.
  • video.insights: Wiedergabedauer, Vollwiedergabequote, Retention, Traffic-Quellen, Zuschaueraufschlüsselungen und die Klicks, die ein Post auslöst.
  • comment.list: der comment.update-Webhook, den TikTok als Lesen der Kommentare und Antworten auf In-App-Inhalte beschreibt.
  • video.upload: Hochladen eines Video- oder Foto-Posts als Entwurf, mit upload_to_draft oder is_draft.

Wie sehen Sie die Scopes eines Tokens?

Fragen Sie /tt_user/token_info/get/ ab, der app_id und Access-Token entgegennimmt und den scope des Tokens sowie die creator_id des Kontos zurückgibt. Die Beispiel-Scope-Strings von TikTok enthalten außerdem video.publish und comment.list.manage, deren Namen zu den Endpoints für Veröffentlichung und Kommentarverwaltung passen, auch wenn die Referenzen kein Feld mit einem von beiden verknüpfen.

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"
  }
}

Was verlangt die TikTok-Verbindung von easyCoexistence?

Die Berechtigungen, die ihre Entwickler-App hält, alle sichtbar auf der Zustimmungsseite von TikTok. easyCoexistence schickt den Kontoinhaber zur TikTok-Autorisierungs-URL, die das Portal von TikTok für die App erzeugt; diese URL nennt die Berechtigungen bereits, und easyCoexistence ergänzt nur einen eigenen state-Wert. Der Inhaber bestätigt, was TikTok anzeigt, und der Scope-String, den TikTok zurückgibt, wird mit der Verbindung gespeichert. Die Endpoints, die easyCoexistence danach für das Konto aufruft:

  • /business/get/ für das Profil, die täglichen Metriken und die Follower-Aufschlüsselungen.
  • /business/video/list/ für Posts und ihre Metriken.
  • /business/video/publish/, /business/photo/publish/ und /business/publish/status/ für die Veröffentlichung.
  • /business/comment/list/, /business/comment/reply/create/, /business/comment/hide/ und /business/comment/delete/ für Kommentare.
  • /business/webhook/update/, auf App-Ebene, für den Kommentar-Webhook.

Wie fügt man später eine Berechtigung hinzu?

In zwei Schritten, einer pro Ebene. Für die App öffnen Sie My Apps, die App, Scope of permission, bearbeiten es, geben eine Begründung an, die zu den neuen Scopes passt, und senden ab. Die Prüfung durch TikTok kann zwei bis drei Werktage dauern, und seit dem 20. März 2026 braucht ein Antrag, der TikTok Accounts enthält, zuerst das Formular Accounts API Access Application Form. Für das Token autorisiert der Inhaber die App erneut, denn ein Token behält die Scopes, die bei seiner Ausstellung freigegeben wurden.

Was passiert, wenn eine Berechtigung fehlt?

Bei einem Aufruf lautet der Fehlercode von TikTok 40001, keine Berechtigung für die zugehörige Operation, und die Lösung verweist auf die Referenz der Berechtigungs-Scopes. Bei einem Feld stellen die Referenzen es erst bereit, wenn der Inhaber seinen Scope erteilt hat, und ihre Lösung ist, dass der Inhaber die App mit diesem Scope erneut autorisiert. Prüfen Sie den Scope des Tokens mit /tt_user/token_info/get/, bevor Sie den Inhaber fragen.

Häufige Fehler

  • Erwarten, dass verbundene Konten von selbst eine neue App-Berechtigung erhalten. Ihre Tokens behalten die bei der Autorisierung freigegebenen Scopes, bis jeder Inhaber die App erneut autorisiert.
  • is_business_account ohne user.account.type anzufordern. TikTok macht dieses Feld und has_advanced_access nur für Tokens mit diesem Scope verfügbar.
  • Auf comment.update warten, ohne comment.list. TikTok sendet Kommentarereignisse nur, solange die Autorisierung des Inhabers mit diesem Scope gültig bleibt.
  • Im Token nach App-Berechtigungsnamen suchen. Der Scope-String verwendet Namen wie video.list, während Namen wie Get Account Media zu den Einstellungen der App gehören.
Mit EasyCoexistence

get_social_credentials gibt Ihrem eigenen Code dasselbe Token für weitere Endpoints der Accounts API. Von US$ 9 bis hinab zu US$ 0.75 pro Verbindung und Monat, sinkend mit jeder weiteren Verbindung, mit einer kostenlosen Testphase von 3 Tagen.

Häufig gestellte Fragen

Welche Scopes nutzt die TikTok API for Business?

Token-Scopes wie user.info.basic, user.info.stats, user.insights, video.list, video.insights, comment.list und video.upload, die der Kontoinhaber zusätzlich zu den App-Berechtigungen unter TikTok Accounts erteilt.

Welche Berechtigungen braucht der Kommentar-Webhook von TikTok?

Die App braucht TikTok Accounts und Business Comment, und der Inhaber muss comment.list erteilen. Die Ereignisse stoppen, wenn diese Autorisierung abläuft oder widerrufen wird.

Gilt ein neuer TikTok-Scope für bereits ausgestellte Tokens?

Nein. Ein Token behält die Scopes, die bei seiner Ausstellung freigegeben wurden, daher autorisiert der Kontoinhaber die App erneut, um einen neuen hinzuzufügen.

Wie lange braucht TikTok, um eine neue Berechtigung zu genehmigen?

TikTok sagt, die Prüfung einer Berechtigungsänderung könne zwei bis drei Werktage dauern. Anträge, die zuerst TikTok Accounts hinzufügen, brauchen das Accounts API Access Application Form.

Weiterlesen

Verbinden Sie Ihren ersten Kanal in zwei Minuten.

Keine Plattform-Prüfungen, auf die Sie warten müssen. Verbinden Sie WhatsApp, Instagram, TikTok oder einen anderen Kanal, bitten Sie dann Ihre KI, zu posten, zu antworten oder Berichte zu erstellen, und sehen Sie ihr bei der Arbeit zu.

  • 3 Tage kostenlos
  • Jederzeit kündbar
  • Nur offizielle APIs
  • Überwacht rund um die Uhr (24/7)

Verifiziert am