Perubahan API TikTok 2026: yang berhenti berfungsi dan cara memperbaikinya
Ada empat perubahan API TikTok di 2026 yang perlu ditindaklanjuti: TikTok for Developers kini mendokumentasikan token akses 2 jam dan refresh token 180 hari yang dirotasi (2 November); is_business_account hanya berarti Verified Business Account (16 Oktober); aplikasi Accounts API baru wajib memakai formulir akses TikTok (20 Maret); dan akun sandbox API for Business berakhir 1 Desember. Sebagian besar perubahan lain menambahkan field, misalnya teks komentar pada webhook.
easyCoexistence menjaga koneksi TikTok Anda tetap mutakhir untuk Claude, ChatGPT, atau platform Anda sendiri: token diperbarui lebih awal, has_advanced_access dan is_business_account ada di field profil bawaannya, event komentar diteruskan beserta teksnya, dan token akun dari get_social_credentials untuk sisa API for Business.
Halaman token TikTok for Developers diperbarui: token akses pengguna berlaku 2 jam, refresh token 180 hari dan dirotasi pada setiap refresh.
Sejak itu, is_business_account pada /business/get/ hanya menandai Verified Business Account, dan has_advanced_access menunjukkan Advanced Access.
Jumlah karakter yang dapat dimuat komentar atau balasan melalui API sejak 7 Agustus 2026, naik dari 150.
Saat TikTok menambahkan teks komentar ke event webhook comment.update.
Awal aturan bahwa aplikasi baru atau penambahan scope dengan TikTok Accounts memerlukan Formulir Permohonan Akses Accounts API.
Tanggal ketika TikTok menghentikan akun sandbox API for Business, dan menyarankan akun uji di produksi sebagai gantinya.
Perubahan API TikTok 2026 mana yang merusak sesuatu?
Halaman What's New dan referensi TikTok di business-api.tiktok.com, serta Changelog dan halaman token di developers.tiktok.com, mencatat perubahan 2026 pada API yang mengelola akun dan kontennya. Dari yang terbaru, dengan tanggal mendatang di paling atas; sebagian besar menambahkan field, dan beberapa memerlukan tindakan:
| 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 |
Apa yang berakhir pada 1 Desember 2026?
Akun sandbox API for Business. Halaman sandbox TikTok menyatakan akun tersebut akan dihentikan paling lambat 1 Desember 2026 dan menyarankan membuat akun uji sendiri di produksi. Akun ini adalah akun iklan dengan data laporan tiruan di https://sandbox-ads.tiktok.com/open_api, jadi pengujian Accounts API dipindahkan ke akun TikTok sungguhan yang disimpan untuk pengujian, dengan URL video uji yang diberikan TikTok untuk /business/video/publish/.
Apa yang berubah pada token TikTok for Developers pada 2 November 2026?
Halaman token-nya kini memberikan token akses pengguna berlaku 2 jam sejak diterbitkan dan refresh token berlaku 180 hari sejak penerbitan pertama, serta merotasi refresh token: refresh yang berhasil mengembalikan refresh_token baru dan langsung membatalkan yang dikirim. Yang rusak adalah tugas yang melakukan refresh sekali sehari atau memakai ulang refresh token yang tersimpan. Perbaikannya: lakukan refresh sebelum expires_in habis, simpan setiap refresh_token baru sebelum dipakai, dan rencanakan otorisasi ulang dalam 180 hari. Panduan autentikasi API for Business masih memberi token akun TikTok berlaku satu hari dan satu tahun.
Apa yang berubah pada is_business_account pada 16 Oktober 2026?
TikTok menambahkan has_advanced_access ke /business/get/, sebagai nilai untuk fields dan sebagai field respons, serta mempersempit is_business_account hanya untuk berarti Verified Business Account. Kode yang membaca is_business_account sebagai tanda Advanced Access kini menerima false untuk akun yang memiliki Advanced Access tanpa verifikasi. Perbaikannya: minta kedua field tersebut, yang memerlukan scope user.account.type, dan batasi fitur yang dibuka Advanced Access agar hanya aktif jika salah satunya bernilai true.
Apa yang berubah pada saran hashtag pada 25 September 2026?
/business/hashtag/suggestion/ mendapat post_count, yaitu jumlah postingan yang telah memakai setiap hashtag yang direkomendasikan, dan 10 sarannya kini diurutkan berdasarkan post_count setelah kecocokan persis, yang menurut TikTok mencerminkan rekomendasi di aplikasi. Tidak ada yang dihapus, sehingga kode yang ada tetap berjalan; peringkat yang dibangun dari urutan lama akan bergeser, dan post_count tersedia untuk dijadikan dasar pengurutan.
Apa yang berubah untuk teks komentar pada 7 Agustus 2026?
TikTok menaikkan batas teks pada /business/comment/create/ dan /business/comment/reply/create/ dari 150 menjadi 1,200 karakter, dan juga pada balasan komentar di Mentions API. Tidak ada yang rusak. Kode yang memotong balasan pada 150 karakter demi TikTok dapat membiarkannya lebih panjang, dengan mengingat catatan TikTok bahwa banyak komentar yang sangat mirip dikirim dalam waktu singkat bisa ditandai sebagai spam.
Tambahan 2026 mana yang tidak memerlukan perubahan kode?
Tiga tambahan publikasi dan postingan berupa field opsional yang dapat diabaikan oleh panggilan yang sudah ada:
- 24 Juli: /business/publish/location/ menampilkan tag lokasi sebuah akun, dan endpoint publikasi menerima
location_idbesertalocation_name, yang wajib disertakan bersamanya. - 15 Mei:
is_adpada /business/video/list/, sebagai field yang diminta dan sebagai nilai respons, menunjukkan apakah sebuah postingan sedang dipromosikan sebagai iklan. - 16 Januari:
music_sound_infopada endpoint publikasi video dan foto menyertakan trek dari Commercial Music Library.
Apa yang berubah pada webhook komentar pada 18 Juni 2026?
comment.update mendapat text, yaitu isi komentar atau balasan, di samping comment_id, video_id, comment_action dan unique_identifier pengomentar. Penerima dapat membaca kata-katanya langsung dari event tanpa memanggil /business/comment/list/; nama tampilan dan username pengomentar tetap berasal dari daftar tersebut, dan ID dalam content tetap berupa angka JSON yang terlalu besar untuk double.
Apa yang berubah pada Research API tahun ini?
Dua perubahan, keduanya ada di Research Tools TikTok for Developers. Pada 26 Februari, TikTok mengubah pipeline datanya agar mencakup semua konten video publik, termasuk video yang tidak memenuhi syarat untuk feed For You, sehingga jumlah yang dibandingkan dengan tarikan data sebelumnya bisa bergeser. Pada 21 Mei, Query Videos serta kueri video yang disukai, disematkan, dan dibagikan ulang mulai mengembalikan favorites_count, dan Query Video Comments mulai mengembalikan display_name untuk komentar dan balasan.
Apa yang berubah pada tinjauan aplikasi pada 20 Maret 2026?
Sejak pukul 00:00 GMT hari itu, pengembang wajib melengkapi Formulir Permohonan Akses Accounts API TikTok sebelum mengirim aplikasi pengembang baru atau meminta penambahan scope yang mencakup izin TikTok Accounts. Yang rusak adalah pengiriman yang dilakukan tanpa formulir tersebut. Perbaikannya: lengkapi formulir terlebih dahulu, dengan informasi yang jelas dan akurat, lalu kirim aplikasi atau perubahan scope. Tinjauan TikTok dapat memerlukan waktu 2 hingga 3 hari kerja.
Apa yang berubah pada komentar pada 13 Februari 2026?
Komentar kini bisa memuat gambar. /business/comment/image/upload/ menerima gambar dan mengembalikan image_uri, yang diterima /business/comment/create/ dan /business/comment/reply/create/ bersama image_width dan image_height, dan daftar komentar mengembalikan image_url untuk komentar bergambar. Teks menjadi salah satu dari dua pilihan pada balasan, sehingga kode yang menganggap setiap komentar memiliki teks juga harus menangani image_url.
Apa yang ditandai untuk dihapus tanpa tanggal?
user_id pada respons komentar. Referensi TikTok untuk /business/comment/list/ dan /business/comment/reply/create/ menandainya To-be-deprecated, yang berarti akan dihentikan pada versi API berikutnya, dan merekomendasikan unique_identifier, yang tetap sama di seluruh API. v1.3 sendiri tidak memiliki tanggal berakhir: timeline versi TikTok mencantumkannya tersedia hingga TBD.
Bagaimana easyCoexistence menangani perubahan ini?
Koneksi TikTok-nya berjalan di atas token API for Business, yang mempertahankan masa berlaku satu hari dan satu tahun serta diperbaruinya sendiri, sehingga perubahan 2 November tidak berdampak padanya. Sisanya, perubahan demi perubahan:
- Daftar metrics yang kosong pada
get_social_insightsmeminta TikTok untuk kedua flag,is_business_accountdanhas_advanced_access. reply_to_commentmengirim teks Anda apa adanya, sehingga batas 1,200 karakter TikTok berlaku, sementara otomasi tetap membatasi balasan TikTok pada 150 karakter dan aturan komentar pada 500.- Event comment.update yang diteruskan membawa text seperti yang dikirim TikTok, dengan ID diubah menjadi string.
is_addan field lain dari daftar postingan dapat diakses dari kode Anda sendiri pada business/video/list/, dengan token dariget_social_credentials.- Pengujian tidak memerlukan sandbox: akun yang Anda miliki terhubung dengan masuk di TikTok.
Kesalahan umum
- Menuliskan masa berlaku token secara tetap di kode. TikTok for Developers mengubah masa berlaku yang didokumentasikannya pada 2 November 2026, sementara contoh refresh-nya masih menampilkan 86400, sehingga jadwalkan refresh berdasarkan expires_in di setiap respons.
- Menyimpan refresh token pertama. Di TikTok for Developers, setiap refresh mengembalikan refresh_token baru dan membatalkan yang Anda kirim, sehingga simpan yang terbaru setiap kali.
- Membatasi fitur Advanced Access hanya dengan is_business_account. Sejak 16 Oktober 2026, nilainya false untuk akun Advanced Access yang belum terverifikasi.
- Mempertahankan batas 150 karakter demi TikTok. Endpoint komentar telah menerima hingga 1,200 karakter sejak 7 Agustus 2026.
Mulai dari US$ 9 per koneksi per bulan, turun hingga US$ 0.75 seiring Anda menambah koneksi, dengan 3 hari pertama gratis.
Pertanyaan yang sering diajukan
Apakah API for Business mengubah masa berlaku token pada 2026?
Tidak. Panduan autentikasinya masih memberi token akses akun TikTok berlaku satu hari dan refresh token satu tahun; masa berlaku 2 jam dan 180 hari adalah milik TikTok for Developers.
Di mana TikTok mengumumkan perubahan API?
Di What's New pada business-api.tiktok.com untuk API for Business, dan di Changelog pada developers.tiktok.com untuk TikTok for Developers. Halaman referensi juga memuat catatan bertanggal, seperti formulir 20 Maret.
Apakah TikTok mengubah batas laju Accounts API pada 2026?
Entri What's New 2026 untuk Accounts tidak mencatat perubahan: 40 panggilan per menit per akun pada setiap endpoint, dan 600 atau 1,000 per menit per aplikasi.
Perubahan 2026 mana yang paling penting bagi agen AI yang membalas komentar TikTok?
Dua: balasan dapat mencapai 1,200 karakter sejak 7 Agustus, dan comment.update telah memuat teks komentar sejak 18 Juni, sehingga agen membacanya dari event.
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