MasukMulai uji coba gratis
easyCoexistence API resmi

Scope API TikTok for Business: apa yang dibuka setiap izin

API for Business TikTok memberi akses dalam dua lapisan. Aplikasi developer memegang izin di bawah TikTok Accounts, seperti Video Publish dan Manage Account Comment, yang membuka endpoint. Otorisasi pemilik akun memberi scope access token, seperti user.insights dan video.list, yang menentukan field apa saja yang dikembalikan. /tt_user/token_info/get/ menampilkan daftar scope yang dibawa sebuah token.

easyCoexistence meminta pemilik akun TikTok untuk izin yang dimiliki aplikasinya dalam satu kali masuk, sehingga Claude, ChatGPT, atau kode Anda sendiri dapat mempublikasikan, mengelola komentar, dan membaca insights melalui tool-nya, dan get_social_credentials memberi kode Anda sendiri token yang sama untuk endpoint Accounts API lain.

18000000

Scope ID TikTok Accounts, izin tingkat pertama di atas endpoint profil, postingan, komentar, dan publikasi milik Accounts API.

user.account.type

Scope di balik is_business_account dan has_advanced_access dalam data profil sebuah akun.

comment.list

Scope yang harus diberikan pemilik, dan tetap aktif, agar aplikasi menerima event webhook comment.update.

video.upload

Scope yang dibutuhkan token untuk mengunggah postingan sebagai draf, bukan langsung mempublikasikannya.

2 to 3 days

Hari kerja yang mungkin dibutuhkan TikTok untuk meninjau perubahan izin aplikasi developer.

Apa dua lapisan izin TikTok?

Izin aplikasi dan scope token. Izin aplikasi dipilih di My Apps, lalu aplikasi, Scope of permission, dan TikTok yang meninjaunya; ada tiga tingkat, dan izin tingkat pertama mencakup setiap endpoint di bawahnya. Scope token adalah yang disetujui pemilik akun saat mengotorisasi aplikasi, dikembalikan sebagai scope, berupa satu string dipisahkan koma, bersama setiap token. Sebuah panggilan memerlukan izin aplikasi untuk endpoint-nya, dan sebagian field respons juga memerlukan scope pada token.

Izin aplikasi mana yang membuka setiap endpoint?

Referensi API TikTok mencantumkan, untuk setiap endpoint Accounts API, izin di bawah TikTok Accounts yang membukanya, atau tidak ada. Referensi scope izin dan panduan webhook-nya menyebut kelompok yang sama dengan Business User, Business Media, Business Comment dan Business Content, jadi siapkan kedua set nama ini:

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

Scope token mana yang membuka field mana?

Referensi TikTok untuk /business/get/ dan /business/video/list/ memberikan izin yang dibutuhkan untuk setiap field respons, dan dua fitur lain menyebut scope tersendiri:

  • user.info.basic: display_name dan profile_image.
  • user.info.username: username, yang membutuhkan user.info.basic hingga Juni 2023.
  • user.info.profile: profile_deep_link, bio_description dan is_verified.
  • user.info.stats: following_count, followers_count, total_likes dan videos_count.
  • user.account.type: is_business_account dan has_advanced_access.
  • user.insights: metrik harian akun dan rincian pengikut menurut usia, jenis kelamin, negara dan kota.
  • video.list: field postingan seperti item_id, caption, share_url, likes, comments, shares, reach dan video_views.
  • video.insights: waktu tonton, tingkat tonton penuh, retensi, sumber lalu lintas, rincian penonton dan klik yang didorong sebuah postingan.
  • comment.list: webhook comment.update, yang oleh TikTok digambarkan sebagai membaca komentar dan balasan dari konten dalam aplikasi.
  • video.upload: mengunggah postingan video atau foto sebagai draf, dengan upload_to_draft atau is_draft.

Bagaimana melihat scope pada sebuah token?

Tanyakan /tt_user/token_info/get/, yang menerima app_id dan access token, lalu mengembalikan scope token dan creator_id akun. Contoh string scope dari TikTok juga mencakup video.publish dan comment.list.manage, yang namanya cocok dengan endpoint publikasi dan manajemen komentar, meski referensinya tidak mengaitkan field apa pun dengan keduanya.

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

Apa yang diminta koneksi TikTok easyCoexistence?

Izin yang dimiliki aplikasi developer-nya, semuanya ditampilkan di halaman persetujuan TikTok. easyCoexistence mengarahkan pemilik akun ke URL otorisasi pemegang akun TikTok yang dibuat portal TikTok untuk aplikasinya, yang sudah menyebut izin-izin tersebut, dan hanya menambahkan nilai state miliknya sendiri. Pemilik menyetujui apa yang ditampilkan TikTok, dan string scope yang dikembalikan TikTok disimpan bersama koneksi. Endpoint yang kemudian dipanggil easyCoexistence untuk akun tersebut:

  • /business/get/ untuk profil, metrik harian dan rincian pengikut.
  • /business/video/list/ untuk postingan dan metriknya.
  • /business/video/publish/, /business/photo/publish/ dan /business/publish/status/ untuk publikasi.
  • /business/comment/list/, /business/comment/reply/create/, /business/comment/hide/ dan /business/comment/delete/ untuk komentar.
  • /business/webhook/update/, di tingkat aplikasi, untuk webhook komentar.

Bagaimana menambahkan izin nanti?

Dalam dua langkah, satu untuk setiap lapisan. Untuk aplikasi, buka My Apps, aplikasi, Scope of permission, sunting, beri alasan yang sesuai dengan scope baru dan kirim; peninjauan TikTok mungkin memakan dua sampai tiga hari kerja, dan sejak 20 Maret 2026 permintaan yang menyertakan TikTok Accounts lebih dulu memerlukan Accounts API Access Application Form. Untuk token, pemilik mengotorisasi ulang aplikasi, karena token menyimpan scope yang disetujui saat diterbitkan.

Apa yang terjadi jika izin tidak ada?

Untuk panggilan, kode pengembalian TikTok adalah 40001, tidak ada izin untuk menjalankan operasi terkait, dan perbaikannya menunjuk ke referensi scope izin. Untuk field, referensi hanya menyediakannya setelah pemilik memberikan scope-nya, dan perbaikannya adalah meminta pemilik mengotorisasi ulang aplikasi dengan scope tersebut. Periksa scope token dengan /tt_user/token_info/get/ sebelum bertanya.

Kesalahan umum

  • Mengira akun yang terhubung akan mendapat izin aplikasi baru dengan sendirinya. Token mereka tetap memegang scope yang disetujui saat otorisasi, sampai tiap pemilik mengotorisasi ulang aplikasi.
  • Meminta is_business_account tanpa user.account.type. TikTok hanya menyediakan field itu dan has_advanced_access bagi token yang membawa scope tersebut.
  • Menunggu comment.update tanpa comment.list. TikTok hanya mengirim event komentar selama otorisasi pemilik dengan scope itu masih berlaku.
  • Mencari di token nama izin aplikasi. String scope memakai nama seperti video.list, sedangkan nama seperti Get Account Media berada di pengaturan aplikasi.
Melakukan ini dengan EasyCoexistence

US$ 9 hingga US$ 0.75 per koneksi per bulan, turun seiring penambahan koneksi, dengan 3 hari pertama gratis.

Pertanyaan yang sering diajukan

Scope apa yang digunakan TikTok API for Business?

Scope token seperti user.info.basic, user.info.stats, user.insights, video.list, video.insights, comment.list dan video.upload, yang diberikan pemilik akun di atas izin TikTok Accounts milik aplikasi.

Izin apa yang dibutuhkan webhook komentar TikTok?

Aplikasi memerlukan TikTok Accounts dan Business Comment, dan pemilik harus memberikan comment.list. Event berhenti jika otorisasi itu kedaluwarsa atau dicabut.

Apakah scope TikTok baru berlaku untuk token yang sudah diterbitkan?

Tidak. Token tetap memegang scope yang disetujui saat diterbitkan, jadi pemilik akun mengotorisasi ulang aplikasi untuk menambahkan scope baru.

Berapa lama TikTok menyetujui izin baru?

TikTok menyebut peninjauan perubahan izin mungkin memakan dua sampai tiga hari kerja, dan permintaan yang menambahkan TikTok Accounts lebih dulu memerlukan Accounts API Access Application Form.

Lanjut membaca

Hubungkan saluran pertama Anda dalam dua menit.

Tanpa menunggu peninjauan platform. Hubungkan WhatsApp, Instagram, TikTok, atau saluran lainnya, lalu minta AI Anda untuk memposting, membalas, atau membuat laporan, dan lihat hasilnya langsung.

  • Gratis 3 hari
  • Batalkan kapan saja
  • Hanya API resmi
  • Dipantau 24/7

Diverifikasi pada