Mentions sa TikTok API: paghahanap ng mga post at comment na nag-mention sa isang account
Ang Mentions API ng TikTok, bahagi ng TikTok API para sa Negosyo, ay nagbabalik ng nangungunang 1,000 public na post sa nakaraang 90 araw na nag-@mention sa account ng negosyo sa caption, sa pamamagitan ng GET /business/mention/video/list/, at ng nangungunang 1,000 comment o reply na nagme-mention dito, sa pamamagitan ng /business/mention/comment/list/. Kailangan ng dalawa ang scope na biz.brand.insights at isang account na may Advanced Access o isang Verified na account ng negosyo.
Nagkokonekta ang easyCoexistence ng TikTok account sa pamamagitan ng TikTok API para sa Negosyo: nababasa ng Claude, ChatGPT o sarili ninyong code ang mga comment at nakakasagot sa mga ito gamit ang nakalaang tool, at natatanggap ang mga comment event habang dumarating ang mga ito, at ibinibigay ng get_social_credentials sa sarili ninyong code ang token para sa iba pang tawag sa API para sa Negosyo, kasama ang Mentions endpoint kung saan ito binubuksan ng TikTok sa account.
Pinakamaraming post na may mention na ibinabalik ng /business/mention/video/list/, lahat public at mula sa nakaraang 90 araw, hanggang 100 kada request.
Tinatayang delay mula nang gawin ang mention hanggang maging available ito sa Mentions API.
Latency na ibinibigay ng TikTok para sa Mentions webhook matapos mag-mention ang user ng negosyo sa caption o comment.
Gaano kadalas inirerekomenda ng TikTok na tawagin ang bawat Mentions endpoint kada account, pagkatapos ng refresh mula 0 hanggang 7 am UTC.
Scope na kailangan ng /business/mention/comment/list/ bukod sa biz.brand.insights para maibalik ang mga comment na nagme-mention sa account.
Anong mga endpoint ang mayroon ang Mentions API?
Anim na read endpoint, bawat isa ay GET sa https://business-api.tiktok.com/open_api/v1.3, kasama ang access token ng account sa Access-Token header at ang open_id nito bilang business_id. Dalawa ang naglilista ng mention, dalawa ang nagbubuod ng sinasabi ng mga post na may mention, at dalawa ang kumukuha ng iisang mention na ipinahayag ng webhook:
Aling mga post at comment ang binibilang na mention?
Ang mga nag-tag ng handle ng account gamit ang @, sa caption ng post o sa text ng comment, sa public na post, at pumasa sa iba pang filter ng TikTok:
- Ang post ay na-upload sa nakaraang 90 araw.
- Ang author nito ay hindi menor de edad o hindi alam ang edad: ang 17 pababa ay itinuturing na menor de edad sa Europe, at ang 12 pababa sa US at iba pang rehiyon.
- Kabilang sa 1,000 pinakagustong post, o comment, na nagme-mention sa handle.
- Kasama rin ang sariling post ng negosyo na pasok sa mga patakarang ito.
- Ang mga comment na mention lang ang laman, walang ibang text, ay mas mababa ang ranggo.
Ano ang kailangan ng account bago ito makagamit ng mga ito?
Isang kwalipikadong account, isang app na may tamang permission, ang mga scope sa token, at isang araw na paghihintay pagkatapos mag-authorize ang may-ari sa app:
- Advanced Access o isang Verified na account ng negosyo; ipinapakita ng
has_advanced_accesssa /business/get/ kung aling account ang kwalipikado. - Ang Mentions permission sa developer app, nakalista bilang Mentions, Content para sa post at Mentions, Comment para sa comment.
- biz.brand.insights sa access token, kasama ang comment.list para sa comment na mention.
- 24 oras pagkatapos ng authorization bago ang unang pull, ayon sa getting-started guide ng TikTok.
Paano ililista ang mga post na nag-mention sa account?
Gamit ang GET /business/mention/video/list/. Pinipili ng fields ang data: item_id at caption bilang default, kasama ang create_time, video_link, likes, comments, shares, thumbnail_url, views, reach at creator_handle_name kapag hiniling. Ang sort_field ay tumatanggap ng CREATE_TIME, LIKES, COMMENTS o SHARES na may sort_type na ASC o DESC, pinapaliit ng number_of_days ang 90 araw, pinipili ng regions ang mga creator mula sa napiling rehiyon, at ang cursor kasama ang has_more ay nagpapalipat-lipat sa mga resulta. Ang views at reach ay nagbabalik ng null sa ilalim ng 1,000, at ang thumbnail link ay tumatagal ng 48 oras:
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
}
}Paano ililista ang mga comment na nag-mention sa account?
Gamit ang GET /business/mention/comment/list/, na nangangailangan din ng comment.list sa token. Bilang default, ibinabalik nito ang comment_id at comment_text. Ang item_id, video_link, caption, video_likes, thumbnail_url, commenter_display_name, comment_type, comment_create_time at comment_likes ay makukuha kapag hiniling, at ang comment_type ay nagbabasa ng COMMENT o REPLY. Ang isang pahina ay may 10, maliban kung hihingi ng hanggang 100 sa max_count, na nakaayos ayon sa VIDEO_LIKES, COMMENT_CREATE_TIME o COMMENT_LIKES. Dahil sa trust and safety policy ng TikTok, maaaring kulang ang isang pahina habang nananatiling true ang has_more.
Paano sasagot sa isang mention?
Sa pamamagitan ng comment reply endpoint ng TikTok. Tumatanggap ang POST /business/comment/reply/create/ ng business_id, video_id na itinakda sa item_id mula sa comment mention, comment_id, at text na hanggang 1,200 character. Lumalabas sa publiko ang sagot sa ilalim ng comment na iyon, sa alinmang post na may dala nito. Binabanggit ng reference ng TikTok ang scope na comment.list.manage at ang parehong kinakailangan sa account para dito. Nakalista sa Mentions reference nito ang sagot para sa comment mention lamang.
Maaari bang dumating ang mention sa pamamagitan ng webhook?
Oo. Sa Mentions permission, tumatawag ang app sa POST /business/webhook/update/ na may event_type na BRAND_MENTION. Pagkatapos ay nagpapadala ang TikTok ng brand.mention.event sa loob ng hanggang dalawa o tatlong oras mula sa mention, na nilagdaan sa Tiktok-Signature tulad ng iba pa nilang webhook. Ang content ay serialized JSON string na naglalaman ng:
type_of_event: CREATE, EDIT, oPRIVACY_CHANGEpara sa pagbabago sa privacy setting ng post.mention_type: COMMENT para sa comment o reply,VIDEO_MENTIONpara sa caption, kung saan angcomment_iday 0.video_id,video_create_time,share_urlatvideo_caption, na naglalarawan sa post.open_id_of_mentioned_user,unique_name_of_mentioned_user, atunique_identifier, isang commenter ID na nananatiling pareho sa lahat ng API.- Ang mga detalye ay kinukuha mula sa /business/mention/video/get/ o /business/mention/comment/get/, sa loob ng 48 oras mula sa event.
Gaano kadalas dapat tawagin ang mga Mentions endpoint?
Isang beses kada araw kada endpoint at kada account, pagkatapos ng 7 am UTC, ang payo ng TikTok. Ibinabahagi ng mga endpoint ang global rate limit ng developer app, ngunit nire-refresh ng TikTok ang data ng nakaraang araw sa pagitan ng hatinggabi at 7 am UTC, at hindi na kailangan ang mga karagdagang pull sa parehong araw. Ang bagong mention ay umaabot din nang humigit-kumulang 24 hanggang 48 oras bago makarating sa list endpoint, kaya mas mabilis na senyales ang webhook.
Paano gumagana ang brand hashtag?
Pinalalawak nito ang mention sa mga post na gumagamit ng hashtag na pinili ng negosyo. Pinapagana ng POST /business/mention/hashtag/add/ ang hanggang 10 hashtag kada request at 50 kada account, na kinuha mula sa hanggang 100 na iminumungkahi ng /business/mention/hashtag/verify/list/ o naglalaman ng buong handle, tulad ng #drinktiktok para sa @TikTok. Hindi maaaring alisin ang naka-enable na hashtag sa loob ng pitong araw, at ang mga post nito ay makakarating sa /business/mention/hashtag/video/list/ 24 oras matapos itong paganahin.
Ano ang magagawa ng easyCoexistence sa TikTok mention?
Ibigay sa sarili ninyong code ang token ng account: ibinabalik ng get_social_credentials ang token at business_id para sa mga path ng TikTok API para sa Negosyo sa ilalim ng business/, kasama ang business/mention/. Sasagot ang TikTok kapag natugunan ng account at app ang mga kinakailangan sa itaas. Nasa labas ng saklaw na ito ang mention webhook: nag-subscribe ang easyCoexistence sa app nito sa comment event lamang at hindi nito hinahawakan ang business/webhook/ paths, kaya hindi ipinapasa ang BRAND_MENTION event. Ang mga comment sa sariling post ng account, kasama ang mention, ay dumarating pa rin bilang comment.update event, na ipinapasa ng 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!" }Mga karaniwang pagkakamali
- Pagtawag sa Mentions endpoint para sa account na walang Advanced Access. Ibinibigay lang ng TikTok ang mga ito sa mga account na may Advanced Access o Verified na account ng negosyo, na iniuulat ng has_advanced_access sa /business/get/.
- Pagkuha ng mention kaagad pagkatapos ng hatinggabi UTC. Nire-refresh ng TikTok ang data ng nakaraang araw sa pagitan ng hatinggabi at 7 am UTC, kaya ang pull pagkatapos ng 7 am ay nakikita na ang buong araw.
- Pagbasa sa comment_id na 0 bilang comment. Sa mention webhook, ibig sabihin nito ay nasa caption ng post ang mention, na may mention_type na VIDEO_MENTION.
- Pag-enable ng brand hashtag para lang subukan. Pinapanatili ng TikTok ang naka-enable na hashtag sa loob ng pitong araw bago ito maalis, at binibilang ito sa 50 ng account.
Mula US$ 9 hanggang US$ 0.75 kada koneksyon kada buwan, bumababa habang dumarami ang koneksyon, at may unang 3 araw na free trial.
Mga madalas itanong
Mahahanap ba ng TikTok API ang mga video na nag-mention sa account ko?
Oo, ang mga nag-@mention sa handle nito sa caption. Ibinabalik ng /business/mention/video/list/ ang hanggang 1,000 public na post sa nakaraang 90 araw, at ipinapakita ng creator_handle_name ang pangalan ng bawat creator.
Binibilang ba bilang mention ang mga pribadong post sa TikTok?
Hindi. Binibilang lamang ng Mentions API ang public na post sa nakaraang 90 araw, at inaalis nito ang mga author na menor de edad o hindi alam ang edad: 17 pababa sa Europe, at 12 pababa sa US at iba pang rehiyon.
Gaano katagal bago lumabas ang mention sa TikTok?
Mga 24 hanggang 48 oras sa pamamagitan ng list endpoint, at hanggang dalawa o tatlong oras sa pamamagitan ng Mentions webhook.
Maaari bang bigyan ako ng easyCoexistence ng alert kapag nabanggit ang TikTok account ko?
Hindi bilang ipinasang event, dahil ipinapasa nito ang comment event ng TikTok at hindi ang mention event. Maaaring basahin ng sarili ninyong code ang mention kapag hiniling, gamit ang token mula sa get_social_credentials, kung kwalipikado ang account.
Magpatuloy sa pagbabasa
I-connect ang inyong unang channel sa loob ng dalawang minuto.
Walang review ng platform na hihintayin. I-connect ang WhatsApp, Instagram, TikTok o iba pang channel, pagkatapos ay utusan ang inyong AI na mag-post, mag-reply o gumawa ng report, at panoorin itong gumana.
- 3 araw na libre
- Mag-cancel anumang oras
- Official API lang
- Minomonitor 24/7
Na-verify noong