MasukMulai uji coba gratis
easyCoexistence API resmi

Mention TikTok lewat API: menemukan postingan dan komentar yang me-mention sebuah akun

API Mentions TikTok, bagian dari API for Business, mengembalikan 1,000 postingan publik teratas dari 90 hari terakhir yang memuat @mention ke akun bisnis di keterangannya, melalui GET /business/mention/video/list/, dan 1,000 komentar atau balasan teratas yang me-mention akun itu, melalui /business/mention/comment/list/. Keduanya memerlukan scope biz.brand.insights dan akun dengan Advanced Access atau Verified Business Account.

easyCoexistence menghubungkan akun TikTok lewat API for Business TikTok: Claude, ChatGPT, atau kode Anda sendiri membaca komentarnya dan membalasnya dengan tool khusus dan menerima event komentarnya saat masuk, dan get_social_credentials memberi kode Anda sendiri token untuk panggilan API for Business lainnya, termasuk endpoint Mentions di tempat TikTok membukanya untuk akun tersebut.

1,000

Postingan terbanyak yang dikembalikan /business/mention/video/list/, semuanya publik dan dari 90 hari terakhir, hingga 100 per permintaan.

24 to 48 hours

Perkiraan jeda antara sebuah mention dibuat dan ketersediaannya lewat Mentions API.

2 to 3 hours

Latensi yang diberikan TikTok untuk webhook Mentions setelah pengguna me-mention bisnis di keterangan atau komentar.

Once a day

Seberapa sering TikTok menyarankan setiap endpoint Mentions dipanggil per akun, setelah penyegaran dari pukul 0 hingga 7 pagi UTC.

comment.list

Scope /business/mention/comment/list/ yang dibutuhkan selain biz.brand.insights untuk mengembalikan komentar yang me-mention akun.

Endpoint apa saja yang dimiliki Mentions API?

Enam endpoint baca, masing-masing GET ke https://business-api.tiktok.com/open_api/v1.3 dengan token akses akun di header Access-Token dan open_id-nya sebagai business_id. Dua untuk daftar mention, dua untuk merangkum apa yang dikatakan postingan yang di-mention, dan dua untuk mengambil satu mention yang diumumkan webhook:

/business/mention/video/list/Up to 1,000 posts whose caption mentions the account, 100 a page
/business/mention/comment/list/Up to 1,000 comments or replies whose text mentions the account
/business/mention/top_word/list/The 20 keywords that appear most in mentioned posts' captions
/business/mention/top_hashtag/list/The 20 hashtags used most in those captions
/business/mention/video/get/One mentioned post from a webhook event, within 48 hours
/business/mention/comment/get/One comment mention from a webhook event, within 48 hours

Postingan dan komentar mana yang dihitung sebagai mention?

Yang menandai handle akun dengan @, di keterangan postingan atau di teks komentar, pada postingan publik, dan lolos filter TikTok lainnya:

  • Postingan diunggah dalam 90 hari terakhir.
  • Penulisnya tidak di bawah umur atau usianya tidak diketahui: 17 tahun ke bawah dihitung di bawah umur di Eropa, 12 tahun ke bawah di AS dan wilayah lain.
  • Termasuk 1,000 postingan atau komentar paling disukai yang me-mention handle tersebut.
  • Postingan bisnis sendiri yang memenuhi aturan ini juga dihitung.
  • Komentar yang hanya berisi mention tanpa teks lain diberi peringkat lebih rendah.

Apa yang dibutuhkan akun sebelum bisa menggunakannya?

Akun yang memenuhi syarat, aplikasi dengan izin yang tepat, scope pada token, dan jeda satu hari setelah pemilik mengotorisasi aplikasi:

  • Advanced Access atau Verified Business Account; has_advanced_access pada /business/get/ menunjukkan akun mana yang memenuhi syarat.
  • Izin Mentions pada aplikasi developer, tercantum sebagai Mentions, Content untuk postingan dan Mentions, Comment untuk komentar.
  • biz.brand.insights pada token akses, ditambah comment.list untuk mention komentar.
  • 24 jam setelah otorisasi sebelum penarikan pertama, sesuai panduan memulai dari TikTok.

Bagaimana cara mendaftar postingan yang me-mention akun?

Dengan GET /business/mention/video/list/. fields menentukan data yang diambil, yaitu item_id dan caption secara default, ditambah create_time, video_link, likes, comments, shares, thumbnail_url, views, reach dan creator_handle_name jika diminta. sort_field menerima CREATE_TIME, LIKES, COMMENTS atau SHARES dengan sort_type ASC atau DESC, number_of_days mempersempit 90 hari, regions membatasi kreator dari wilayah yang dipilih, dan cursor bersama has_more untuk berpindah halaman hasil. views dan reach bernilai null di bawah 1,000, dan tautan thumbnail berlaku 48 jam:

Mentioned posts, sorted by likes
curl --get 'https://business-api.tiktok.com/open_api/v1.3/business/mention/video/list/' \
  -H 'Access-Token: <ACCESS_TOKEN>' \
  --data-urlencode 'business_id=<OPEN_ID>' \
  --data-urlencode 'fields=["item_id","video_link","caption","likes","creator_handle_name"]' \
  --data-urlencode 'sort_field=LIKES' \
  --data-urlencode 'number_of_days=30' \
  --data-urlencode 'max_count=100'

{
  "code": 0,
  "message": "OK",
  "request_id": "<REQUEST_ID>",
  "data": {
    "videos": [
      {
        "item_id": "<ITEM_ID>",
        "video_link": "https://www.tiktok.com/@/video/<ITEM_ID>",
        "caption": "<CAPTION>",
        "likes": 243,
        "creator_handle_name": "<HANDLE>"
      }
    ],
    "cursor": 100,
    "has_more": true
  }
}

Bagaimana cara mendaftar komentar yang me-mention akun?

Dengan GET /business/mention/comment/list/, yang tokennya juga memerlukan comment.list. Secara default mengembalikan comment_id dan comment_text. item_id, video_link, caption, video_likes, thumbnail_url, commenter_display_name, comment_type, comment_create_time dan comment_likes diambil jika diminta, dan comment_type bernilai COMMENT atau REPLY. Satu halaman berisi 10 kecuali max_count meminta hingga 100, diurutkan menurut VIDEO_LIKES, COMMENT_CREATE_TIME atau COMMENT_LIKES. Karena kebijakan kepercayaan dan keamanan TikTok, sebuah halaman bisa kembali lebih pendek sementara has_more tetap bernilai true.

Bagaimana cara membalas mention?

Lewat endpoint balasan komentar TikTok. POST /business/comment/reply/create/ menerima business_id, video_id yang diisi dengan item_id dari mention komentar, comment_id, dan text hingga 1,200 karakter. Balasan tampil secara publik di bawah komentar itu, di postingan mana pun yang memuatnya. Referensi TikTok menyebut scope comment.list.manage dan syarat akun yang sama untuknya. Referensi Mentions-nya hanya mencantumkan balasan untuk mention komentar.

Bisakah mention datang lewat webhook?

Bisa. Dengan izin Mentions, sebuah aplikasi memanggil POST /business/webhook/update/ dengan event_type BRAND_MENTION, lalu TikTok mengirim brand.mention.event dalam waktu hingga dua atau tiga jam sejak mention, ditandatangani di Tiktok-Signature seperti webhook lainnya. content adalah string JSON yang diserialisasi dan berisi:

  • type_of_event: CREATE, EDIT, atau PRIVACY_CHANGE untuk perubahan pengaturan privasi postingan.
  • mention_type: COMMENT untuk komentar atau balasan, VIDEO_MENTION untuk keterangan, di mana comment_id bernilai 0.
  • video_id, video_create_time, share_url dan video_caption, yang menjelaskan postingan.
  • open_id_of_mentioned_user, unique_name_of_mentioned_user, dan unique_identifier, yaitu ID pengomentar yang tetap sama di semua API.
  • Detailnya diambil dari /business/mention/video/get/ atau /business/mention/comment/get/, dalam 48 jam sejak event.

Seberapa sering endpoint Mentions sebaiknya dipanggil?

Sekali sehari per endpoint dan akun, setelah pukul 7 pagi UTC, adalah saran TikTok. Endpoint-endpoint ini berbagi pembatasan laju global aplikasi developer, tetapi TikTok menyegarkan data hari sebelumnya antara tengah malam dan pukul 7 pagi UTC, dan penarikan lanjutan pada hari yang sama tidak perlu. Mention baru juga membutuhkan sekitar 24 hingga 48 jam untuk sampai ke endpoint daftar, itulah sebabnya webhook menjadi sinyal yang lebih cepat.

Bagaimana cara kerja hashtag merek?

Hashtag memperluas mention ke postingan yang memakai hashtag yang dipilih bisnis. POST /business/mention/hashtag/add/ mengaktifkan hingga 10 hashtag per permintaan dan 50 per akun, diambil dari hingga 100 yang disarankan /business/mention/hashtag/verify/list/ atau yang memuat handle lengkap, seperti #drinktiktok untuk @TikTok. Hashtag yang sudah diaktifkan tidak bisa dihapus selama seven days, dan postingannya masuk ke /business/mention/hashtag/video/list/ 24 jam setelah diaktifkan.

Apa yang bisa dilakukan easyCoexistence dengan mention TikTok?

Berikan token akun kepada kode Anda sendiri: get_social_credentials mengembalikan token dan business_id untuk path API for Business di bawah business/, termasuk business/mention/. TikTok menjawab ketika akun dan aplikasi memenuhi syarat di atas. Webhook mention tetap di luar: easyCoexistence hanya berlangganan event komentar untuk aplikasinya dan menyimpan path business/webhook/ untuk dirinya sendiri, sehingga event BRAND_MENTION tidak diteruskan. Komentar pada postingan milik akun, termasuk mention di dalamnya, tetap datang sebagai event comment.update, yang diteruskan oleh set_social_webhook_destination:

Comment mentions and a reply, from your own code
GET https://business-api.tiktok.com/open_api/v1.3/business/mention/comment/list/
  ?business_id=<BUSINESS_ID>
  &fields=["item_id","comment_id","comment_text","commenter_display_name","comment_type"]
  &sort_field=COMMENT_CREATE_TIME&max_count=50
Access-Token: <ACCESS_TOKEN>

POST https://business-api.tiktok.com/open_api/v1.3/business/comment/reply/create/
Access-Token: <ACCESS_TOKEN>
{ "business_id": "<BUSINESS_ID>", "video_id": "<ITEM_ID>", "comment_id": "<COMMENT_ID>", "text": "Thanks for the mention!" }

Kesalahan umum

  • Memanggil endpoint Mentions untuk akun tanpa Advanced Access. TikTok melayaninya untuk akun dengan Advanced Access atau Verified Business Account, yang dilaporkan has_advanced_access pada /business/get/.
  • Menarik mention tepat setelah tengah malam UTC. TikTok menyegarkan data hari sebelumnya antara tengah malam dan pukul 7 pagi UTC, sehingga penarikan setelah pukul 7 pagi sudah mencakup seluruh hari.
  • Membaca comment_id 0 sebagai komentar. Dalam webhook mention, itu berarti mention ada di keterangan postingan, dengan mention_type VIDEO_MENTION.
  • Mengaktifkan hashtag merek hanya untuk mencoba. TikTok menahan hashtag yang sudah diaktifkan selama tujuh hari sebelum bisa dihapus, dan hashtag itu dihitung dalam batas 50 per akun.
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

Apakah API TikTok bisa menemukan video yang me-mention akun saya?

Bisa, yaitu yang me-mention handle-nya di keterangan. /business/mention/video/list/ mengembalikan hingga 1,000 postingan publik dari 90 hari terakhir, dengan creator_handle_name yang menyebut setiap kreator.

Apakah postingan TikTok yang privat dihitung sebagai mention?

Tidak. Mentions API hanya menghitung postingan publik dari 90 hari terakhir, dan tidak menyertakan penulis yang di bawah umur atau usianya tidak diketahui: 17 tahun ke bawah di Eropa, 12 tahun ke bawah di AS dan wilayah lain.

Berapa lama sebuah mention TikTok baru muncul?

Sekitar 24 hingga 48 jam lewat endpoint daftar, dan hingga dua atau tiga jam lewat webhook Mentions.

Bisakah easyCoexistence memberi tahu saya saat akun TikTok saya di-mention?

Tidak sebagai event yang diteruskan, karena easyCoexistence meneruskan event komentar TikTok, bukan event mention. Kode Anda sendiri bisa membaca mention atas permintaan, dengan token dari get_social_credentials, jika akun memenuhi syarat.

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