TikTok spominjanja putem API-ja: pronalaženje objava i komentara koji spominju račun
TikTokov Mentions API, dio API for Business, vraća prvih 1.000 javnih objava iz posljednjih 90 dana koje u opisu označavaju poslovni račun znakom @, putem GET /business/mention/video/list/, te prvih 1.000 komentara ili odgovora koji ga spominju, putem /business/mention/comment/list/. Oba zahtijevaju opseg biz.brand.insights i račun s Advanced Access ili verificirani poslovni račun.
easyCoexistence povezuje TikTok račun putem TikTokovog API for Business: Claude, ChatGPT ili vaš vlastiti kod čitaju komentare i odgovaraju na njih posebnim alatima te primaju događaje komentara čim stignu, a get_social_credentials daje vašem kodu token za ostale pozive API for Business, uključujući Mentions endpointe gdje ih TikTok otvara računu.
Najviše spominjanih objava koje vraća /business/mention/video/list/, sve javne i iz posljednjih 90 dana, do 100 po pozivu.
Približno kašnjenje između nastanka spominjanja i njegove dostupnosti kroz Mentions API.
Kašnjenje koje TikTok navodi za Mentions webhook nakon što korisnik spomene poslovni račun u opisu ili komentaru.
Koliko često TikTok preporučuje pozivati svaki Mentions endpoint po računu, nakon osvježavanja od 0 do 7 h UTC.
Opseg /business/mention/comment/list/ uz biz.brand.insights potreban je za dohvat komentara koji spominju račun.
Koje endpointe ima Mentions API?
Šest endpointa za čitanje, svaki kao GET na https://business-api.tiktok.com/open_api/v1.3, s pristupnim tokenom računa u zaglavlju Access-Token i njegovim open_id kao business_id. Dva popisuju spominjanja, dva sažimaju što objave koje spominju račun govore, a dva dohvaćaju jedno spominjanje koje je webhook najavio:
Koje objave i komentari se računaju kao spominjanja?
One koje označavaju korisničko ime računa znakom @ u opisu objave ili u tekstu komentara, na javnoj objavi, i koje prođu ostale TikTokove filtre:
- Objava je objavljena u posljednjih 90 dana.
- Autor nije maloljetan niti je nepoznate dobi: 17 ili manje računa se kao maloljetnost u Europi, 12 ili manje u SAD-u i drugim regijama.
- Pripada među prvih 1.000 najlajkanijih objava ili komentara koji spominju korisničko ime.
- Objave samog poslovnog računa koje zadovoljavaju ova pravila također se broje.
- Komentari koji sadrže samo oznaku, bez drugog teksta, rangiraju se niže.
Što račun treba prije korištenja?
Prikladan račun, aplikaciju s odgovarajućom dozvolom, opsege na tokenu i jedan dan čekanja nakon što vlasnik autorizira aplikaciju:
- Advanced Access ili verificirani poslovni račun;
has_advanced_accessna /business/get/ pokazuje koji računi se kvalificiraju. - Dozvola Mentions u razvojnoj aplikaciji, navedena kao Mentions, Content za objave i Mentions, Comment za komentare.
- biz.brand.insights na pristupnom tokenu, plus comment.list za spominjanja u komentarima.
- 24 sata nakon autorizacije prije prvog dohvata, kako traži TikTokov vodič za početak.
Kako popisati objave koje spominju račun?
GET /business/mention/video/list/. fields bira podatke: item_id i caption su zadani, a create_time, video_link, likes, comments, shares, thumbnail_url, views, reach i creator_handle_name dodaju se na zahtjev. sort_field prima CREATE_TIME, LIKES, COMMENTS ili SHARES uz sort_type ASC ili DESC, number_of_days sužava 90 dana, regions izdvaja kreatore iz odabranih regija, a cursor uz has_more prolazi kroz rezultate po stranicama. views i reach vraćaju null ispod 1.000, a poveznice na sličice vrijede 48 sati:
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
}
}Kako popisati komentare koji spominju račun?
GET /business/mention/comment/list/, čiji token također treba comment.list. Zadano vraća comment_id i comment_text; item_id, video_link, caption, video_likes, thumbnail_url, commenter_display_name, comment_type, comment_create_time i comment_likes dolaze na zahtjev, a comment_type ima vrijednost COMMENT ili REPLY. Stranica sadrži 10 zapisa, osim ako max_count ne traži do 100, a sortira se po VIDEO_LIKES, COMMENT_CREATE_TIME ili COMMENT_LIKES. Zbog TikTokovih pravila o povjerenju i sigurnosti stranica može biti kraća, dok has_more i dalje ostaje true.
Kako odgovoriti na spominjanje?
Putem TikTokovog endpointa za odgovore na komentare. POST /business/comment/reply/create/ prima business_id, video_id postavljen na item_id iz spominjanja u komentaru, comment_id i text do 1.200 znakova, a odgovor se javno prikazuje ispod tog komentara, na objavi na kojoj se nalazi. TikTokova referenca navodi opseg comment.list.manage i isti uvjet za račun. Njegova referenca za Mentions navodi odgovor samo za spominjanja u komentarima.
Mogu li spominjanja stići webhookom?
Da. Uz dozvolu Mentions aplikacija poziva POST /business/webhook/update/ s event_type BRAND_MENTION, a TikTok zatim šalje brand.mention.event unutar dva do tri sata od spominjanja, potpisan zaglavljem Tiktok-Signature kao i ostali webhookovi. content je serijalizirani JSON niz koji sadrži:
type_of_event: CREATE, EDIT iliPRIVACY_CHANGEza promjenu postavke privatnosti objave.mention_type: COMMENT za komentar ili odgovor,VIDEO_MENTIONza opis, gdjecomment_idima vrijednost 0.video_id,video_create_time,share_urlivideo_caption, koji opisuju objavu.open_id_of_mentioned_user,unique_name_of_mentioned_useriunique_identifier, ID komentatora koji ostaje isti kroz sve API-je.- Pojedinosti slijede iz /business/mention/video/get/ ili /business/mention/comment/get/, unutar 48 sati od događaja.
Koliko često treba pozivati Mentions endpointe?
Jednom dnevno po endpointu i računu, nakon 7 h UTC, preporuka je TikToka. Endpointi dijele globalna ograničenja brzine razvojne aplikacije, ali TikTok osvježava podatke prethodnog dana između ponoći i 7 h UTC, a dodatni dohvati u istom danu nepotrebni su. Novo spominjanje također treba otprilike 24 do 48 sati da stigne do popisnih endpointa, pa je webhook brži signal.
Kako rade brend hashtagovi?
Oni proširuju spominjanja na objave koje koriste hashtagove koje je tvrtka odabrala. POST /business/mention/hashtag/add/ omogućuje do 10 hashtagova po pozivu i 50 po računu, uzetih iz najviše 100 koje predlaže /business/mention/hashtag/verify/list/ ili onih koji sadrže cijelo korisničko ime, kao #drinktiktok za @TikTok. Omogućeni hashtag ne može se ukloniti sljedećih sedam dana, a njegove objave stižu na /business/mention/hashtag/video/list/ 24 sata nakon omogućavanja.
Što easyCoexistence može učiniti s TikTok spominjanjima?
Dajte vlastitom kodu token računa: get_social_credentials vraća token i business_id za putanje API for Business pod business/, među njima business/mention/. TikTok odgovara kad račun i aplikacija ispune gore navedene uvjete. Webhookovi za spominjanja ostaju izvan toga: easyCoexistence pretplaćuje svoju aplikaciju samo na događaje komentara i putanje business/webhook/ zadržava za sebe, pa se događaji BRAND_MENTION ne prosljeđuju. Komentari na vlastite objave računa, uključujući spominjanja, i dalje stižu kao događaji comment.update, koje prosljeđuje set_social_webhook_destination:
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!" }Uobičajene pogreške
- Pozivanje Mentions endpointa za račun bez Advanced Access. TikTok ih služi računima s Advanced Access ili verificiranim poslovnim računom, što prijavljuje has_advanced_access na /business/get/.
- Dohvat spominjanja odmah nakon ponoći UTC. TikTok osvježava podatke prethodnog dana između ponoći i 7 h UTC, pa dohvat nakon 7 h vidi cijeli dan.
- Čitanje comment_id 0 kao komentara. U webhooku za spominjanje to znači da je spominjanje u opisu objave, s mention_type VIDEO_MENTION.
- Omogućavanje brend hashtaga za probu. TikTok zadržava omogućeni hashtag sedam dana prije nego ga je moguće ukloniti, a broji se u ograničenih 50 po računu.
Od US$ 9 do US$ 0,75 po vezi mjesečno, pri čemu cijena pada kako dodajete veze, a prva 3 dana su besplatna.
Često postavljana pitanja
Može li TikTok API pronaći videozapise koji spominju vaš račun?
Da, one koje u opisu označavaju njegovo korisničko ime s @. /business/mention/video/list/ vraća do 1.000 javnih objava iz posljednjih 90 dana, a creator_handle_name imenuje svakog kreatora.
Broje li se privatne TikTok objave kao spominjanja?
Ne. Mentions API broji samo javne objave iz posljednjih 90 dana i izostavlja autore koji su maloljetni ili nepoznate dobi: 17 ili manje u Europi, 12 ili manje u SAD-u i drugim regijama.
Koliko dugo traje da se TikTok spominjanje pojavi?
Otprilike 24 do 48 sati kroz popisne endpointe, a do dva ili tri sata kroz Mentions webhook.
Može li easyCoexistence javiti kad je vaš TikTok račun spomenut?
Ne kao prosljeđeni događaj, jer prosljeđuje TikTokove događaje komentara, a ne događaje spominjanja. Vaš kod može čitati spominjanja na zahtjev, s tokenom iz get_social_credentials, gdje račun ispunjava uvjete.
Nastavite čitati
Povežite svoj prvi kanal u dvije minute.
Bez čekanja na provjere platformi. Povežite WhatsApp, Instagram, TikTok ili drugi kanal, zatim zamolite svoju umjetnu inteligenciju da objavi, odgovori ili izradi izvješće i gledajte kako radi.
- 3 dana besplatno
- Otkažite bilo kada
- Samo službeni API-ji
- Nadzor 24/7
Provjereno na