TikTok mentions API හරහා: ගිණුමක් mention කරන posts සහ comments සෙවීම
TikTok Mentions API, API for Business හි කොටසක් ලෙස, ව්යාපාර ගිණුමක caption එකේ @mention කරන පසුගිය දින 90 තුළ පොදු posts 1,000ක් දක්වා GET /business/mention/video/list/ හරහා ආපසු ලබා දෙයි. ඒ ගිණුම mention කරන comments හෝ replies 1,000ක් /business/mention/comment/list/ හරහා ලබා දෙයි. දෙකටම biz.brand.insights scope එකත් Advanced Access හෝ Verified Business Account එකක් ඇති ගිණුමක් අවශ්යයි.
easyCoexistence TikTok ගිණුමක් TikTok හි API for Business හරහා සම්බන්ධ කරයි.
/business/mention/video/list/ මගින් ආපසු ලබා දෙන posts උපරිම ගණන, සියල්ල පොදු සහ පසුගිය දින 90 තුළ, එක් ඉල්ලීමකට 100 දක්වා.
Mention එකක් සිදු වීමත් Mentions API හරහා එය ලබා ගත හැකි වීමත් අතර ආසන්න ප්රමාදය.
පරිශීලකයෙකු caption එකේ හෝ comment එකේ ව්යාපාරය mention කළ පසු Mentions webhook සඳහා TikTok ලබා දෙන latency.
0 සිට 7 am UTC refresh එකෙන් පසු, ගිණුමකට සෑම Mentions endpoint එකක්ම කොපමණ වාර ගණනක් call කරන්න TikTok නිර්දේශ කරයි.
ගිණුම mention කරන comments ආපසු ලබා ගැනීමට biz.brand.insights ට අමතරව /business/mention/comment/list/ හට අවශ්ය scope එක.
Mentions API හි endpoints මොනවාද?
කියවීමේ endpoints හයක්, ඒ සියල්ල https://business-api.tiktok.com/open_api/v1.3 මත GET ලෙස, ගිණුමේ access token එක Access-Token header එකේ සහ එහි open_id එක business_id ලෙස යවා. දෙකක් mention ලැයිස්තුගත කරයි, දෙකක් mention වූ posts පවසන දේ සාරාංශ කරයි, සහ දෙකක් webhook එකක් දැනුම් දුන් එක් mention එකක් ලබා ගනී:
ගිණුම mention කරන posts සහ comments මොනවාද?
ගිණුමේ handle එක @ සමඟ tag කරන, post එකේ caption එකේ හෝ comment එකේ text එකේ, පොදු post එකක, සහ TikTok හි අනෙකුත් filters පසු කරන ඒවා:
- Post එක පසුගිය දින 90 තුළ පළ වී ඇත.
- එහි කර්තෘ බාල වයස්කරු හෝ වයස නොදන්නෙකු නොවිය යුතුය: යුරෝපයේ 17 හෝ ඊට අඩු, ඇමරිකාවේ සහ අනෙකුත් කලාපවල 12 හෝ ඊට අඩු බාල වයස ලෙස ගැනේ.
- එය handle එක mention කරන, වැඩියෙන්ම like ලැබූ posts හෝ comments 1,000 අතර ස්ථානගත වේ.
- මෙම නීති සපුරන ව්යාපාරයේම posts ද ගණන් ගැනේ.
- Mention එක පමණක්, වෙනත් text නැතිව, සාදන ලද comments පහළ ස්ථානගත වේ.
ගිණුමකට ඒවා භාවිත කිරීමට පෙර කුමක් අවශ්යද?
සුදුසු ගිණුමක්, නිවැරදි අවසරයක් ඇති යෙදුමක්, token එකේ scopes, සහ හිමිකරු යෙදුම authorize කළ පසු දිනක රැඳී සිටීමක්:
- Advanced Access හෝ Verified Business Account එකක්; /business/get/ හි
has_advanced_accessමගින් කුමන ගිණුම් සුදුසුද යන්න පෙන්වයි. - Developer යෙදුමේ Mentions අවසරය ලැයිස්තුගත වී ඇත: posts සඳහා Mentions, Content ලෙසත් comments සඳහා Mentions, Comment ලෙසත්.
- Access token එකේ biz.brand.insights, සහ comment mentions සඳහා comment.list.
- පළමු pull එකට පෙර authorization ලබා දී පැය 24ක්, TikTok හි getting-started guide එක ඉල්ලන පරිදි.
ගිණුමට mention කරන posts ලැයිස්තුගත කරන්නේ කෙසේද?
GET /business/mention/video/list/ සමඟ. fields මගින් දත්ත තෝරයි: default ලෙස item_id සහ caption, ඉල්ලීමක් මත create_time, video_link, likes, comments, shares, thumbnail_url, views, reach සහ creator_handle_name. sort_field මගින් CREATE_TIME, LIKES, COMMENTS හෝ SHARES ගන්නා අතර sort_type ASC හෝ DESC. number_of_days මගින් දින 90 සීමා කරයි, regions මගින් තෝරාගත් කලාපවල creators තබා ගනී, සහ cursor සහ has_more මගින් ප්රතිඵල පිටු වශයෙන් යයි. views සහ reach, 1,000 ට අඩු වූ විට null කියවෙන අතර thumbnail links පැය 48ක් වලංගුයි:
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
}
}ගිණුමට mention කරන comments ලැයිස්තුගත කරන්නේ කෙසේද?
GET /business/mention/comment/list/ සමඟ, එහි token එකට comment.list ද අවශ්යයි. Default ලෙස comment_id සහ comment_text ආපසු දෙයි. item_id, video_link, caption, video_likes, thumbnail_url, commenter_display_name, comment_type, comment_create_time සහ comment_likes ඉල්ලීමක් මත ලැබේ, සහ comment_type COMMENT හෝ REPLY ලෙස කියවේ. පිටුවක 10ක් අඩංගු වන අතර, max_count මගින් 100 දක්වා ඉල්ලන්නේ නැත්නම්, VIDEO_LIKES, COMMENT_CREATE_TIME හෝ COMMENT_LIKES අනුව අනුපිළිවෙලට. TikTok හි trust and safety policies නිසා, has_more තවමත් true වුවත් පිටුවක් අඩු ප්රමාණයකින් ආපසු ලැබිය හැක.
Mention එකකට පිළිතුරු දෙන්නේ කෙසේද?
TikTok හි comment reply endpoint එක හරහා. POST /business/comment/reply/create/ ලබා ගන්නේ business_id, comment mention එකේ item_id වන video_id, comment_id සහ අක්ෂර 1,200 දක්වා text එකක්. Reply එක, එය රැගෙන යන ඕනෑම post එකක, එම comment එක යටතේ පොදුවේ දිස් වේ. TikTok හි reference එක comment.list.manage scope එක සහ එයට එකම ගිණුම් අවශ්යතාව නම් කරයි. එහි Mentions reference එක comment mentions සඳහා පමණක් reply එකක් ලැයිස්තුගත කරයි.
Mentions webhook හරහා පැමිණිය හැකිද?
හැක. Mentions අවසරය සහිතව, යෙදුමක් POST /business/webhook/update/ අමතයි event_type BRAND_MENTION සමඟ. ඉන්පසු TikTok mention එකෙන් පැය දෙකක් හෝ තුනක් ඇතුළත brand.mention.event පළ කරයි, එය අනෙකුත් webhooks මෙන් Tiktok-Signature හි අත්සන් කර. content යනු serialized JSON string එකක් වන අතර එයට ඇතුළත් වන්නේ:
type_of_event: CREATE, EDIT, හෝPRIVACY_CHANGE, post එකක privacy සැකසුම වෙනස් කිරීම සඳහා.mention_type: comment හෝ reply සඳහා COMMENT, caption එකක් සඳහාVIDEO_MENTION, එහිදීcomment_id0 ලෙස කියවේ.video_id,video_create_time,share_urlසහvideo_caption, ඒවා post එක විස්තර කරයි.open_id_of_mentioned_user,unique_name_of_mentioned_user, සහunique_identifier, API හරහා එකම පවතින commenter ID එක.- විස්තර /business/mention/video/get/ හෝ /business/mention/comment/get/ මගින් ලැබේ, සිදුවීමෙන් පැය 48ක් ඇතුළත.
Mentions endpoints කොපමණ වාර ගණනක් call කළ යුතුද?
ගිණුමකට සහ endpoint එකකට දිනකට වරක්, UTC 7 am න් පසු, TikTok හි උපදෙසයි. Endpoints developer යෙදුමේ global rate limits බෙදා ගන්නා නමුත්, TikTok පෙර දිනයේ දත්ත මධ්යම රාත්රිය සහ UTC 7 am අතර refresh කරන අතර, එම දිනයටම තවත් pulls call කිරීම අනවශ්ය යැයි කියයි. නව mention එකක් list endpoints වෙත ළඟා වීමට පැය 24 සිට 48 දක්වා ගතවන අතර, එය webhook එක වේගවත් සංඥාවක් බවට පත් කරයි.
Brand hashtags ක්රියා කරන්නේ කෙසේද?
ව්යාපාරය තෝරාගත් hashtags භාවිත කරන posts දක්වා mentions පුළුල් කරයි. POST /business/mention/hashtag/add/ එක ඉල්ලීමකට hashtags 10 දක්වාත් ගිණුමකට 50 දක්වාත් සක්රිය කරයි, /business/mention/hashtag/verify/list/ යෝජනා කරන 100 දක්වා ඒවායින්, හෝ සම්පූර්ණ handle එක අඩංගු ඒවායින්, උදා @TikTok සඳහා #drinktiktok වැනි. සක්රිය කළ hashtag එකක් දින හතක් ඉවත් කළ නොහැකි අතර, එහි posts එය සක්රිය කළ පැය 24 කින් /business/mention/hashtag/video/list/ වෙත ළඟා වේ:
easyCoexistence TikTok mentions සමඟ කුමක් කළ හැකිද?
ඔබේම කේතයට ගිණුමේ token එක දෙන්න: get_social_credentials මගින් business/ යටතේ API for Business paths සඳහා token සහ business_id ලබා දෙයි, ඒ අතර business/mention/ ද වේ. ගිණුම සහ යෙදුම ඉහත අවශ්යතා සපුරන විට TikTok පිළිතුරු දෙයි. Mention webhooks එයින් පිටත පවතී: easyCoexistence එහි යෙදුම comment events වලට පමණක් දායක කරන අතර, business/webhook/ paths තමාටම තබා ගන්නා බැවින්, BRAND_MENTION events ඉදිරියට යවන්නේ නැත. ගිණුමේම posts මත comments, mentions ඇතුළුව, තවමත් comment.update events ලෙස පැමිණෙන අතර, ඒවා 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!" }සාමාන්ය වැරදි
- Advanced Access නැති ගිණුමක් සඳහා Mentions endpoints call කිරීම. TikTok ඒවා Advanced Access හෝ Verified Business Account ඇති ගිණුම්වලට ලබා දෙන අතර, /business/get/ හි has_advanced_access එය වාර්තා කරයි.
- UTC මධ්යම රාත්රියෙන් මඳ වේලාවකට පසු mentions pull කිරීම. TikTok පෙර දිනයේ දත්ත මධ්යම රාත්රිය සහ UTC 7 am අතර refresh කරන බැවින්, 7 am න් පසු pull එකක් සම්පූර්ණ දිනය දකී.
- comment_id 0 comment එකක් ලෙස කියවීම. Mention webhook එකක, එයින් අදහස් වන්නේ mention එක post එකේ caption එකේ ඇති බවයි, mention_type VIDEO_MENTION සමඟ.
- පරීක්ෂා කිරීමට brand hashtag එකක් සක්රිය කිරීම. TikTok සක්රිය hashtag එකක් ඉවත් කිරීමට පෙර දින හතක් තබා ගන්නා අතර, එය ගිණුමේ 50 න් ගණන් ගැනේ.
Claude, ChatGPT හෝ ඔබේ කේතයෙන් එහි comments කියවා, විශේෂිත tools සමඟ ඒවාට පිළිතුරු දිය හැකිය. Comment events ලැබෙන විටම ඒවා ලබා ගන්නා අතර, get_social_credentials ඔබේ කේතයට අනෙකුත් API for Business calls සඳහා token එක දෙයි, TikTok විවෘත කරන Mentions endpoints ඇතුළුව. එක් සම්බන්ධතාවයකට මාසිකව US$ 9 සිට US$ 0.75 දක්වා, සම්බන්ධතා එකතු කරන තරමට අඩු වෙමින්, පළමු දින 3 නොමිලේ.
නිතර අසන ප්රශ්න
TikTok API මගින් මගේ ගිණුම mention කරන videos සොයාගත හැකිද?
ඔව්, caption එකේ එහි handle එක @ සමඟ mention කරන ඒවා. /business/mention/video/list/ පසුගිය දින 90 තුළ පොදු posts 1,000 දක්වා ආපසු දෙයි, සෑම creator කෙනෙකුම creator_handle_name මගින් නම් කෙරේ.
පෞද්ගලික TikTok posts mentions ලෙස ගණන් ගනීද?
නැත. Mentions API ගණන් ගන්නේ පසුගිය දින 90 තුළ පොදු posts පමණක් වන අතර, බාල වයස්කරුවන් හෝ වයස නොදන්නා කතුවරුන් ඉවත් කරයි: යුරෝපයේ 17 හෝ ඊට අඩු, ඇමරිකාවේ සහ අනෙකුත් කලාපවල 12 හෝ ඊට අඩු.
TikTok mention එකක් දිස් වීමට කොපමණ කාලයක් ගතවේද?
List endpoints හරහා පැය 24 සිට 48 දක්වා පමණ, සහ Mentions webhook හරහා පැය දෙකක් හෝ තුනක් දක්වා.
easyCoexistence මගින් TikTok ගිණුම mention කළ විට මට අනතුරු ඇඟවීමක් ලබා දිය හැකිද?
ඉදිරිපත් කළ event එකක් ලෙස නොවේ, මන්ද එය ඉදිරියට යවන්නේ TikTok හි comment events මිස mention events නොවේ. ඔබේ කේතයට ගිණුම සුදුසු වන විට, get_social_credentials වෙතින් ලබාගත් token සමඟ, ඉල්ලීමක් මත mentions කියවිය හැක.
තවදුරටත් කියවන්න
ඔබේ පළමු channel එක මිනිත්තු දෙකකින් සම්බන්ධ කරන්න.
වේදිකා සමාලෝචන සඳහා බලා සිටීමට අවශ්ය නැත. WhatsApp, Instagram, TikTok හෝ වෙනත් channel එකක් සම්බන්ධ කර, පසුව ඔබේ AI හට පළ කිරීමට, ප්රතිචාර දැක්වීමට හෝ වාර්තා කිරීමට පවසා එය වැඩ කරන ආකාරය බලන්න.
- දින 3ක් නොමිලේ
- ඕනෑම වේලාවක අවලංගු කරන්න
- නිල API පමණි
- 24/7 නිරීක්ෂණය කෙරේ
සත්යාපනය කළේ