Log masukMulakan percubaan percuma
easyCoexistence API rasmi

Sebutan TikTok melalui API: mencari siaran dan komen yang menyebut akaun

API Sebutan TikTok, sebahagian daripada API untuk Perniagaan, memulangkan 1,000 siaran awam teratas dalam 90 hari lepas yang @menyebut akaun perniagaan dalam kapsyen, melalui GET /business/mention/video/list/, dan 1,000 komen atau balasan teratas yang menyebutnya, melalui /business/mention/comment/list/. Kedua-duanya memerlukan skop biz.brand.insights dan akaun dengan Advanced Access atau Akaun Perniagaan Disahkan.

easyCoexistence menyambungkan akaun TikTok melalui API untuk Perniagaan TikTok: Claude, ChatGPT atau kod anda sendiri membaca komennya dan membalasnya dengan alat khusus serta menerima peristiwa komen apabila ia tiba, dan get_social_credentials memberi kod anda sendiri token bagi panggilan API untuk Perniagaan yang lain, termasuk endpoint Sebutan di tempat TikTok membukanya kepada akaun itu.

1,000

Jumlah tertinggi siaran yang dipulangkan oleh /business/mention/video/list/, semuanya awam dan daripada 90 hari lepas, sehingga 100 setiap permintaan.

24 to 48 hours

Anggaran kelewatan antara sebutan dibuat dan ketersediaannya melalui API Sebutan.

2 to 3 hours

Latensi yang diberikan TikTok untuk webhook Sebutan selepas pengguna menyebut perniagaan dalam kapsyen atau komen.

Once a day

Kekerapan yang disyorkan TikTok untuk memanggil setiap endpoint Sebutan bagi setiap akaun, selepas penyegaran data pada 0 hingga 7 pagi UTC.

comment.list

Skop /business/mention/comment/list/ yang diperlukan selain biz.brand.insights untuk memulangkan komen yang menyebut akaun.

Apakah endpoint yang ada pada API Sebutan?

Enam endpoint baca, setiap satu ialah GET pada https://business-api.tiktok.com/open_api/v1.3 dengan token akses akaun dalam header Access-Token dan open_id-nya sebagai business_id. Dua menyenaraikan sebutan, dua meringkaskan apa yang dikatakan oleh siaran yang disebut, dan dua mengambil satu sebutan tunggal yang diumumkan oleh 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

Siaran dan komen mana yang dikira sebagai sebutan?

Yang menanda nama pengguna akaun dengan @, dalam kapsyen siaran atau teks komen, pada siaran awam, dan yang lulus penapis lain TikTok:

  • Siaran itu dimuat naik dalam tempoh 90 hari lepas.
  • Pengarangnya tidak di bawah umur atau berumur tidak diketahui: 17 tahun ke bawah dikira di bawah umur di Eropah, 12 tahun ke bawah di Amerika Syarikat dan rantau lain.
  • Ia termasuk dalam 1,000 siaran, atau komen, paling digemari yang menyebut nama pengguna itu.
  • Siaran perniagaan itu sendiri yang memenuhi peraturan ini turut dikira.
  • Komen yang hanya terdiri daripada sebutan tanpa teks lain disusun lebih rendah.

Apa yang diperlukan akaun sebelum boleh menggunakannya?

Akaun yang layak, aplikasi dengan kebenaran yang betul, skop pada token, dan tunggu sehari selepas pemilik membenarkan aplikasi:

  • Advanced Access atau Akaun Perniagaan Disahkan; has_advanced_access pada /business/get/ menunjukkan akaun mana yang layak.
  • Kebenaran Mentions pada aplikasi pembangun, disenaraikan sebagai Mentions, Kandungan untuk siaran dan Mentions, Komen untuk komen.
  • biz.brand.insights pada token akses, serta comment.list untuk sebutan komen.
  • 24 jam selepas kebenaran sebelum tarikan pertama, seperti yang diminta oleh panduan permulaan TikTok.

Bagaimana anda menyenaraikan siaran yang menyebut akaun?

Dengan GET /business/mention/video/list/. fields memilih data, item_id dan caption secara lalai, serta 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 menyempitkan 90 hari, regions menapis pencipta dari wilayah yang dipilih, dan cursor dengan has_more menelusuri hasil halaman demi halaman. views dan reach dibaca sebagai null di bawah 1,000, dan pautan imej kecil kekal aktif 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 anda menyenaraikan komen yang menyebut akaun?

Dengan GET /business/mention/comment/list/, yang tokennya perlu comment.list juga. Secara lalai ia memulangkan 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 diperoleh jika diminta, dan comment_type dibaca sebagai COMMENT atau REPLY. Setiap halaman mengandungi 10 melainkan max_count meminta sehingga 100, disusun mengikut VIDEO_LIKES, COMMENT_CREATE_TIME atau COMMENT_LIKES. Disebabkan dasar kepercayaan dan keselamatan TikTok, satu halaman boleh dipulangkan dengan kurang item walaupun has_more masih benar.

Bagaimana anda membalas sebutan?

Melalui endpoint balasan komen TikTok. POST /business/comment/reply/create/ menerima business_id, video_id yang ditetapkan kepada item_id daripada sebutan komen, comment_id dan text sehingga 1,200 aksara, dan balasan itu muncul secara awam di bawah komen tersebut, pada mana-mana siaran yang memuatkannya. Rujukan TikTok menamakan skop comment.list.manage dan keperluan akaun yang sama untuknya. Rujukan Mentions-nya menyenaraikan balasan untuk sebutan komen sahaja.

Bolehkah sebutan tiba melalui webhook?

Boleh. Dengan kebenaran Mentions, aplikasi memanggil POST /business/webhook/update/ dengan event_type BRAND_MENTION, dan TikTok kemudian menghantar brand.mention.event dalam tempoh sehingga dua hingga tiga jam selepas sebutan, ditandatangani dalam Tiktok-Signature seperti webhook lain. content ialah rentetan JSON bersiri yang mengandungi:

  • type_of_event: CREATE, EDIT, atau PRIVACY_CHANGE untuk perubahan pada tetapan privasi siaran.
  • mention_type: COMMENT untuk komen atau balasan, VIDEO_MENTION untuk kapsyen, dengan comment_id dibaca 0.
  • video_id, video_create_time, share_url dan video_caption, yang menerangkan siaran.
  • open_id_of_mentioned_user, unique_name_of_mentioned_user, dan unique_identifier, ID pengulas yang kekal sama merentas semua API.
  • Butiran diperoleh daripada /business/mention/video/get/ atau /business/mention/comment/get/, dalam tempoh 48 jam selepas peristiwa.

Berapa kerap endpoint Sebutan perlu dipanggil?

Sekali sehari bagi setiap endpoint dan akaun, selepas 7 pagi UTC, adalah nasihat TikTok. Endpoint berkongsi had kadar global aplikasi pembangun, tetapi TikTok menyegarkan data hari sebelumnya antara tengah malam dan 7 pagi UTC, dan tarikan tambahan dalam hari yang sama tidak perlu. Sebutan baharu juga mengambil masa lebih kurang 24 hingga 48 jam untuk sampai ke endpoint senarai, menjadikan webhook isyarat yang lebih pantas.

Bagaimana hashtag jenama berfungsi?

Ia memperluas sebutan kepada siaran yang menggunakan hashtag yang dipilih oleh perniagaan. POST /business/mention/hashtag/add/ mengaktifkan sehingga 10 hashtag setiap permintaan dan 50 setiap akaun, diambil daripada sehingga 100 cadangan /business/mention/hashtag/verify/list/ atau hashtag yang mengandungi nama pengguna penuh, seperti #drinktiktok bagi @TikTok. Hashtag yang diaktifkan tidak boleh dibuang selama tujuh hari, dan siarannya sampai ke /business/mention/hashtag/video/list/ 24 jam selepas diaktifkan.

Apakah yang boleh easyCoexistence lakukan dengan sebutan TikTok?

Serahkan token akaun kepada kod anda sendiri: get_social_credentials memulangkan token dan business_id bagi laluan API untuk Perniagaan di bawah business/, termasuk business/mention/. TikTok menjawab apabila akaun dan aplikasi memenuhi keperluan di atas. Webhook sebutan kekal di luar fungsi ini: easyCoexistence melanggan aplikasinya kepada peristiwa komen sahaja dan mengekalkan laluan business/webhook/ untuk dirinya sendiri, jadi peristiwa BRAND_MENTION tidak diteruskan. Komen pada siaran akaun itu sendiri, termasuk sebutan, tetap tiba sebagai peristiwa 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!" }

Kesilapan biasa

  • Memanggil endpoint Sebutan untuk akaun tanpa Advanced Access. TikTok hanya menyediakannya kepada akaun dengan Advanced Access atau Akaun Perniagaan Disahkan, yang dilaporkan oleh has_advanced_access pada /business/get/.
  • Menarik sebutan sejurus selepas tengah malam UTC. TikTok menyegarkan data hari sebelumnya antara tengah malam dan 7 pagi UTC, jadi tarikan selepas 7 pagi melihat keseluruhan hari.
  • Membaca comment_id 0 sebagai komen. Dalam webhook sebutan, ia bermakna sebutan berada dalam kapsyen siaran, dengan mention_type VIDEO_MENTION.
  • Mengaktifkan hashtag jenama untuk mencuba. TikTok mengekalkan hashtag yang diaktifkan selama tujuh hari sebelum ia boleh dibuang, dan ia dikira dalam had 50 akaun.
Menggunakan EasyCoexistence untuk ini

US$ 9 hingga US$ 0.75 setiap sambungan sebulan, menurun apabila anda menambah sambungan, dengan percubaan percuma 3 hari pertama.

Soalan lazim

Bolehkah API TikTok mencari video yang menyebut akaun anda?

Boleh, iaitu yang @menyebut nama penggunanya dalam kapsyen. /business/mention/video/list/ memulangkan sehingga 1,000 siaran awam daripada 90 hari lepas, dengan creator_handle_name menamakan setiap pencipta.

Adakah siaran TikTok persendirian dikira sebagai sebutan?

Tidak. API Sebutan hanya mengira siaran awam daripada 90 hari lepas, dan tidak merangkumi pengarang yang di bawah umur atau berumur tidak diketahui: 17 tahun ke bawah di Eropah, 12 tahun ke bawah di Amerika Syarikat dan rantau lain.

Berapa lama sebutan TikTok mengambil masa untuk muncul?

Lebih kurang 24 hingga 48 jam melalui endpoint senarai, dan sehingga dua hingga tiga jam melalui webhook Sebutan.

Bolehkah easyCoexistence memberi amaran apabila akaun TikTok anda disebut?

Tidak sebagai peristiwa yang diteruskan, kerana ia meneruskan peristiwa komen TikTok dan bukan peristiwa sebutan. Kod anda sendiri boleh membaca sebutan atas permintaan, dengan token daripada get_social_credentials, jika akaun itu layak.

Teruskan membaca

Sambungkan saluran pertama anda dalam masa dua minit.

Tidak perlu menunggu semakan platform. Sambungkan WhatsApp, Instagram, TikTok atau saluran lain, kemudian minta AI anda menyiarkan, membalas atau melaporkan, dan lihat ia bekerja.

  • 3 hari percuma
  • Batal bila-bila masa
  • API rasmi sahaja
  • Dipantau 24/7

Disahkan pada