Pengaturan postingan TikTok lewat API: privasi, komentar, Duet dan Stitch
API for Business dari TikTok menerima pengaturan postingan dalam panggilan publikasi, sebagian besar di dalam post_info. Video menerima disable_comment, disable_duet, disable_stitch, sampul dari thumbnail_offset atau custom_thumbnail_url, label is_brand_organic dan is_branded_content, serta is_ai_generated. Postingan foto menerima privacy_level, disable_comment, label merek yang sama, dan auto_add_music. GET /business/video/settings/ mengembalikan nilai yang diizinkan tiap akun.
easyCoexistence mempublikasikan video dan postingan foto TikTok dengan publish_tiktok_post dari Claude, ChatGPT, atau kode Anda sendiri, dengan keterangan, judul postingan foto, dan komentar aktif atau nonaktif, dan get_social_credentials memberi kode Anda sendiri token untuk membaca pengaturan yang diizinkan akun.
Opsi privasi untuk postingan foto akun publik: PUBLIC_TO_EVERYONE, MUTUAL_FOLLOW_FRIENDS dan SELF_ONLY.
Tingkat privasi yang didapat akun privat sebagai pengganti PUBLIC_TO_EVERYONE: hanya terlihat oleh pengikutnya.
Nilai default disable_comment, disable_duet dan disable_stitch, sehingga komentar, Duet dan Stitch tetap aktif kecuali diatur.
Gambar sampul kustom terbesar untuk video, minimal 360 x 360 piksel dan maksimal 20 MB.
Label is_branded_content yang dipasang; label ini yang diutamakan jika is_brand_organic juga bernilai true.
Field wajib dari post_info postingan foto, dibatasi pada opsi yang dikembalikan GET /business/video/settings/ untuk akun tersebut.
Pengaturan apa saja yang diterima setiap endpoint publikasi?
/business/video/publish/ dan /business/photo/publish/ berbagi sebagian pengaturan dan berbeda pada sebagian lainnya. Kebanyakan berada di dalam post_info, sedangkan custom_thumbnail_url dan photo_cover_index berada di level teratas body. Berikut perbandingannya, sesuai daftar referensi TikTok, dengan Tidak ada field jika endpoint tidak mendokumentasikan pengaturan tersebut:
| Video post | Photo post | |
|---|---|---|
| Who sees it | No privacy field: the endpoint publishes public video posts | privacy_level, required |
| Comments | disable_comment | disable_comment |
| Duet and Stitch | disable_duet, disable_stitch | No field |
| Cover | custom_thumbnail_url or thumbnail_offset | photo_cover_index |
| Brand labels | is_brand_organic, is_branded_content | is_brand_organic, is_branded_content |
| AI label | is_ai_generated | No field |
| Music | music_sound_info, video_original_sound_volume | auto_add_music, music_sound_info |
| Location | location_id with location_name | location_id with location_name |
| Draft | upload_to_draft | is_draft |
Apa yang diizinkan akun?
GET /business/video/settings/ dengan business_id mengembalikan batas akun untuk postingannya. Baca sebelum mempublikasikan, karena TikTok hanya menerima nilai yang tercantum:
privacy_level_options:PUBLIC_TO_EVERYONE,MUTUAL_FOLLOW_FRIENDSdanSELF_ONLYuntuk akun publik;FOLLOWER_OF_CREATOR,MUTUAL_FOLLOW_FRIENDSdanSELF_ONLYuntuk akun privat.comment_disabled: true jika akun tidak menerima komentar dari siapa pun, dan dalam kasus itudisable_commenthanya menerima true.duet_disableddanstitch_disabled: true jika akun hanya mengizinkan Duet atau Stitch untuk Hanya Anda, atau jika akun privat; sakelar yang sesuai kemudian hanya menerima true.max_video_post_duration_sec: video terpanjang yang bisa dipublikasikan akun; video yang lebih panjang akan gagal.
curl -G 'https://business-api.tiktok.com/open_api/v1.3/business/video/settings/' \
-H 'Access-Token: <ACCESS_TOKEN>' \
--data-urlencode 'business_id=<OPEN_ID>'
{
"code": 0,
"message": "OK",
"request_id": "<REQUEST_ID>",
"data": {
"comment_disabled": false,
"duet_disabled": false,
"max_video_post_duration_sec": 600,
"privacy_level_options": ["PUBLIC_TO_EVERYONE", "MUTUAL_FOLLOW_FRIENDS", "SELF_ONLY"],
"stitch_disabled": false
}
}Siapa yang bisa melihat postingan?
Pada postingan foto, privacy_level yang Anda kirim: PUBLIC_TO_EVERYONE untuk orang di dalam maupun di luar TikTok, MUTUAL_FOLLOW_FRIENDS untuk pengikut yang juga diikuti balik oleh akun, FOLLOWER_OF_CREATOR untuk pengikut akun privat, atau SELF_ONLY. Endpoint video tidak punya field privasi, karena endpoint itu mempublikasikan postingan video publik. Postingan yang diatur ke Teman atau Hanya Anda juga tidak bisa ditonton lewat embed_url-nya.
Bagaimana cara kerja komentar, Duet dan Stitch?
Masing-masing adalah sakelar yang mematikan fitur ketika bernilai true. disable_comment ada di kedua endpoint; disable_duet dan disable_stitch hanya ada di video. Semuanya bernilai false secara default, yang membiarkan fitur tetap aktif, selama sesuai dengan pengaturan privasi akun: akun yang tidak menerima komentar dari siapa pun, atau yang membatasi Duet atau Stitch hanya untuk Hanya Anda, hanya bisa mempublikasikan dengan sakelar tersebut bernilai true.
Bagaimana sampul dipilih?
Pada video, ada dua cara. post_info.thumbnail_offset memilih bingkai berdasarkan waktunya dalam milidetik, default 0, dibulatkan ke bingkai terdekat; waktu yang melewati akhir video akan mengirim webhook kegagalan dan video tidak dipublikasikan. custom_thumbnail_url, di level teratas body, memberikan gambar sebagai gantinya dan membuat TikTok mengabaikan offset. Pada postingan foto, photo_cover_index memilih salah satu gambar, dihitung mulai dari 0.
- Gambar sampul kustom: JPG, JPEG, WebP atau PNG, maksimal 20 MB.
- Ukuran: dari 360 x 360 piksel hingga 1080 x 1920, atau 1920 x 1080.
- Lokasi: domain atau awalan URL yang terverifikasi untuk aplikasi, seperti videonya sendiri.
Apa arti label merek?
Keterangan yang ditampilkan TikTok pada postingan. is_brand_organic bernilai true memberi label Konten promosi, untuk postingan yang mempromosikan bisnis akun sendiri. is_branded_content bernilai true memberi label Kemitraan berbayar, untuk postingan yang dibuat dalam kemitraan berbayar dengan sebuah merek, dan diutamakan jika keduanya bernilai true. Pada video dengan is_branded_content, tto_invite_link dapat menautkan postingan ke kampanye TikTok One Creator Marketplace yang diikuti akun.
Opsi lain apa yang ada di post_info?
Beberapa lagi, masing-masing didokumentasikan pada endpoint yang menerimanya:
is_ai_generated, video: memberi label postingan sebagai buatan AI oleh kreator, yang tidak bisa diubah setelah diposting.location_iddenganlocation_name: tag lokasi yang ditemukan melalui GET /business/publish/location/.music_sound_info: suara komersial berdasarkan ID; pada video juga volumenya, 0 sampai 100, serta awal dan akhirnya dalam milidetik.auto_add_music, postingan foto: menambahkan musik yang direkomendasikan, yang bisa diubah nanti di aplikasi TikTok.upload_to_draftatauis_draft: mengirim postingan ke kotak masuk kreator sebagai draf, bersama videonya, dengan scope video.upload.is_ads_only, video: mempublikasikan postingan Hanya tampil di iklan yang tidak tampil di profil.
Pengaturan apa saja yang diatur publish_tiktok_post?
Tiga berasal dari permintaan Anda: keterangan, judul postingan foto, dan disable_comment. easyCoexistence mengirim is_brand_organic dan is_branded_content sebagai false, mempublikasikan postingan foto sebagai PUBLIC_TO_EVERYONE dengan gambar pertama sebagai sampul, dan tidak menyertakan sisa pengaturan video, sehingga default TikTok berlaku: disable_duet dan disable_stitch false, thumbnail_offset 0, dan is_ai_generated false.
Bagaimana mengirim pengaturan lainnya?
Dari kode Anda sendiri, dengan token dan business_id akun dari get_social_credentials, pada path Business API di bawah business/. GET ke business/video/settings/ membaca batas akun. POST ke business/video/publish/ atau business/photo/publish/ dapat membawa body lengkap sesuai dokumentasi, dan dikirim ke TikTok apa adanya, termasuk URL media, sehingga URL tersebut harus berada di domain atau awalan URL yang terverifikasi untuk aplikasi; publish_tiktok_post adalah panggilan yang mengarahkan tautan Anda melalui rute media terverifikasi milik easyCoexistence.
GET https://business-api.tiktok.com/open_api/v1.3/business/video/settings/?business_id=<BUSINESS_ID>
Access-Token: <ACCESS_TOKEN>Kesalahan umum
- Mengharapkan privacy_level berfungsi pada video. Endpoint video hanya mempublikasikan postingan publik dan referensinya tidak mencantumkan field privasi; postingan foto yang menerima privacy_level.
- Mengaktifkan komentar untuk akun yang tidak menerima komentar sama sekali. Jika comment_disabled bernilai true, TikTok hanya menerima disable_comment bernilai true.
- Mengatur thumbnail_offset melewati akhir video. TikTok mengirim webhook kegagalan dan video tidak dipublikasikan.
- Mengirim PUBLIC_TO_EVERYONE untuk akun privat. privacy_level_options-nya justru mencantumkan FOLLOWER_OF_CREATOR, MUTUAL_FOLLOW_FRIENDS dan SELF_ONLY.
US$ 9 hingga US$ 0.75 per koneksi per bulan, turun seiring Anda menambah koneksi, dengan 3 hari pertama gratis.
Pertanyaan yang sering diajukan
Bisakah saya mengunggah video TikTok privat lewat API?
Tidak dengan endpoint video, yang hanya mempublikasikan postingan publik. Postingan foto menerima privacy_level, termasuk SELF_ONLY, dan video bisa dikirim ke kotak masuk kreator sebagai draf dengan upload_to_draft.
Bagaimana cara mematikan Duet dan Stitch lewat API?
Atur post_info.disable_duet dan post_info.disable_stitch ke true pada /business/video/publish/. Jika akun sudah membatasinya, TikTok hanya menerima true.
Bisakah saya menambahkan tag lokasi lewat API TikTok?
Bisa. post_info menerima location_id dengan location_name, untuk tag lokasi yang ditemukan melalui GET /business/publish/location/.
Apa perbedaan is_brand_organic dan is_branded_content?
is_brand_organic menambahkan label Konten promosi untuk bisnis akun sendiri; is_branded_content menambahkan label Kemitraan berbayar dan diutamakan jika keduanya bernilai true.
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