TikTok pominjanja preko API-ja: pronalaženje objava i komentara koji pominju nalog
TikTok-ov Mentions API, deo API for Business, vraća 1.000 najboljih javnih objava iz poslednjih 90 dana koje u opisu sadrže @oznaku firmenog naloga, preko GET /business/mention/video/list/, i 1.000 najboljih komentara ili odgovora koji ga pominju, preko /business/mention/comment/list/. Oba zahtevaju opseg biz.brand.insights i nalog sa Advanced Access ili Verified Business Account.
easyCoexistence povezuje TikTok nalog preko TikTokovog API for Business: Claude, ChatGPT ili vaš kod čitaju njegove komentare i odgovaraju na njih pomoću namenskih alata i primaju događaje komentara čim stignu, a get_social_credentials daje vašem kodu token za druge pozive API for Business, uključujući Mentions endpointe tamo gde ih TikTok otvara za nalog.
Najviše pominjanih objava koje vraća /business/mention/video/list/, sve javne i iz poslednjih 90 dana, do 100 po zahtevu.
Približno kašnjenje između pominjanja i dostupnosti preko Mentions API-ja.
Latencija koju TikTok navodi za Mentions webhook nakon što korisnik pomene firmu u opisu ili komentaru.
Koliko često TikTok preporučuje pozivanje svakog Mentions endpointa po nalogu, posle osvežavanja od 0 do 7 časova UTC.
Opseg /business/mention/comment/list/ pored biz.brand.insights, potreban da bi vratio komentare koji pominju nalog.
Koje endpointe ima Mentions API?
Šest endpointa za čitanje, svaki kao GET na https://business-api.tiktok.com/open_api/v1.3, sa access tokenom naloga u zaglavlju Access-Token i njegovim open_id kao business_id. Dva navode pominjanja, dva sažimaju šta pominjane objave govore, a dva dohvataju jedno pominjanje koje je webhook najavio:
Koje objave i komentari se računaju kao pominjanja?
Oni koji označavaju nalog sa @, u opisu objave ili u tekstu komentara, na javnoj objavi, i koji prolaze ostale TikTok filtere:
- Objava je postavljena u poslednjih 90 dana.
- Autor nije maloletan niti nepoznatog uzrasta: 17 godina i mlađi važe kao maloletni u Evropi, 12 i mlađi u SAD i drugim regionima.
- Ubraja se među 1.000 najlajkovanijih objava ili komentara koji pominju taj nalog.
- Objave samog naloga koje ispunjavaju ova pravila takođe se računaju.
- Komentari koji sadrže samo oznaku, bez drugog teksta, rangiraju se niže.
Šta nalog treba pre korišćenja?
Odgovarajući nalog, aplikaciju sa potrebnom dozvolom, opsege na tokenu i dan čekanja nakon što vlasnik autorizuje aplikaciju:
- Advanced Access ili Verified Business Account;
has_advanced_accessna /business/get/ pokazuje koji nalozi ispunjavaju uslove. - Dozvola Mentions u developerskoj aplikaciji, navedena kao Mentions, Content za objave i Mentions, Comment za komentare.
- biz.brand.insights na access tokenu, a uz to comment.list za komentare koji pominju nalog.
- 24 sata nakon autorizacije pre prvog preuzimanja, kako traži TikTokov vodič za početak.
Kako se navode objave koje pominju nalog?
Pomoću GET /business/mention/video/list/. fields bira podatke: item_id i caption podrazumevano, a create_time, video_link, likes, comments, shares, thumbnail_url, views, reach i creator_handle_name na zahtev. 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 izabranih regiona, a cursor uz has_more služi za paginaciju rezultata. views i reach su null ispod 1.000, a linkovi sličica važe 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 se navode komentari koji pominju nalog?
Pomoću GET /business/mention/comment/list/, čiji token takođe treba comment.list. Podrazumevano 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 zahtev, a comment_type glasi COMMENT ili REPLY. Stranica sadrži 10, osim ako max_count ne traži do 100, sortirano po VIDEO_LIKES, COMMENT_CREATE_TIME ili COMMENT_LIKES. Zbog TikTokovih pravila o poverenju i bezbednosti, stranica može stići kraća iako je has_more i dalje tačno.
Kako odgovoriti na pominjanje?
Preko TikTokovog endpointa za odgovor na komentar. POST /business/comment/reply/create/ prima business_id, video_id postavljen na item_id iz pominjanja komentara, comment_id i text do 1.200 karaktera, a odgovor se javno prikazuje ispod tog komentara, na objavi koja ga nosi. TikTokova referenca navodi opseg comment.list.manage i isti uslov za nalog. Njihova referenca za Mentions navodi odgovor samo za pominjanja u komentarima.
Mogu li pominjanja stizati preko webhooka?
Mogu. Uz dozvolu Mentions, aplikacija poziva POST /business/webhook/update/ sa event_type BRAND_MENTION, a TikTok zatim šalje brand.mention.event u roku od najviše dva do tri sata od pominjanja, potpisan u Tiktok-Signature kao i ostali webhookovi. content je serijalizovani JSON string koji sadrži:
type_of_event: CREATE, EDIT iliPRIVACY_CHANGEza promenu podešavanja privatnosti objave.mention_type: COMMENT za komentar ili odgovor,VIDEO_MENTIONza opis, gdecomment_idglasi 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.- Detalji se dobijaju iz /business/mention/video/get/ ili /business/mention/comment/get/, u roku od 48 sati od događaja.
Koliko često treba pozivati Mentions endpointe?
Jednom dnevno po endpointu i nalogu, posle 7 časova UTC, preporuka je TikToka. Endpointi dele globalna ograničenja brzine developerske aplikacije, ali TikTok osvežava podatke prethodnog dana između ponoći i 7 časova UTC, pa dodatna preuzimanja u istom danu nisu potrebna. Novo pominjanje takođe treba otprilike 24 do 48 sati da stigne do endpointa za listu, zbog čega je webhook brži signal.
Kako rade brend heštegovi?
Oni proširuju pominjanja na objave koje koriste heštegove koje firma izabere. POST /business/mention/hashtag/add/ omogućava do 10 heštegova po zahtevu i 50 po nalogu, izabranih među do 100 koje predlaže /business/mention/hashtag/verify/list/ ili onih koji sadrže punu oznaku, kao što bi #drinktiktok za @TikTok. Omogućen hešteg ne može da se ukloni sedam dana, a njegove objave stižu na /business/mention/hashtag/video/list/ 24 sata nakon omogućavanja.
Šta easyCoexistence može da radi sa TikTok pominjanjima?
Predajte svom kodu token naloga: get_social_credentials vraća token i business_id za putanje API for Business pod business/, među njima business/mention/. TikTok odgovara kada nalog i aplikacija ispune gore navedene uslove. Webhookovi za pominjanja ostaju van toga: easyCoexistence pretplaćuje svoju aplikaciju samo na događaje komentara i zadržava putanje business/webhook/ za sebe, pa se događaji BRAND_MENTION ne prosleđuju. Komentari na objave samog naloga, uključujući pominjanja, i dalje stižu kao događaji comment.update, koje prosleđ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!" }Česte greške
- Pozivanje Mentions endpointa za nalog bez Advanced Access. TikTok ih služi nalozima sa Advanced Access ili Verified Business Account, što prijavljuje has_advanced_access na /business/get/.
- Preuzimanje pominjanja odmah posle ponoći UTC. TikTok osvežava podatke prethodnog dana između ponoći i 7 časova UTC, pa preuzimanje posle 7 časova vidi ceo dan.
- Čitanje comment_id 0 kao komentara. U webhooku za pominjanje to znači da se pominjanje nalazi u opisu objave, sa mention_type VIDEO_MENTION.
- Omogućavanje brend heštega radi probe. TikTok čuva omogućen hešteg sedam dana pre nego što može da se ukloni, i on se računa u limit naloga od 50.
Od US$ 9 do US$ 0,75 po vezi mesečno, s padom kako dodajete veze, uz prva 3 dana besplatno.
Često postavljana pitanja
Može li TikTok API da pronađe video snimke koji pominju moj nalog?
Može, one koji u opisu sadrže njegovu oznaku @. /business/mention/video/list/ vraća do 1.000 javnih objava iz poslednjih 90 dana, a creator_handle_name imenuje svakog kreatora.
Da li privatne TikTok objave računaju kao pominjanja?
Ne. Mentions API računa samo javne objave iz poslednjih 90 dana i izostavlja autore koji su maloletni ili nepoznatog uzrasta: 17 godina i mlađi u Evropi, 12 i mlađi u SAD i drugim regionima.
Koliko dugo treba da se TikTok pominjanje pojavi?
Približno 24 do 48 sati preko endpointa za listu, a do dva do tri sata preko Mentions webhooka.
Može li easyCoexistence da me obavesti kada se pominje moj TikTok nalog?
Ne kao prosleđeni događaj, jer prosleđuje TikTokove događaje komentara, a ne događaje pominjanja. Vaš kod može da čita pominjanja na zahtev, sa tokenom iz get_social_credentials, tamo gde nalog ispunjava uslove.
Nastavite sa čitanjem
Povežite prvi kanal za dva minuta.
Bez čekanja na odobrenja platformi. Povežite WhatsApp, Instagram, TikTok ili drugi kanal, zatim zamolite svoj AI da objavi, odgovori ili napravi izveštaj, i gledajte kako radi.
- 3 dana besplatno
- Otkažite bilo kada
- Samo zvanični API-ji
- Nadzor 24/7
Provereno na