API-এর মাধ্যমে TikTok Mentions: কোনো অ্যাকাউন্টকে উল্লেখ করা পোস্ট ও কমেন্ট খোঁজা
TikTok-এর Mentions API, যা API for Business-এর অংশ, GET /business/mention/video/list/ এন্ডপয়েন্টের মাধ্যমে গত 90 দিনের শীর্ষ 1,000টি পাবলিক পোস্ট ফেরত দেয়, যেগুলোর ক্যাপশনে কোনো ব্যবসা অ্যাকাউন্টকে @ দিয়ে উল্লেখ করা হয়েছে। এছাড়া /business/mention/comment/list/ এন্ডপয়েন্টের মাধ্যমে সেই অ্যাকাউন্টকে উল্লেখ করা শীর্ষ 1,000টি কমেন্ট বা রিপ্লাই পাওয়া যায়। দুটোর জন্যই biz.brand.insights স্কোপ এবং Advanced Access বা Verified Business Account থাকা অ্যাকাউন্ট লাগে।
easyCoexistence TikTok-এর API for Business-এর মাধ্যমে একটি TikTok অ্যাকাউন্ট সংযুক্ত করে: Claude, ChatGPT বা আপনার নিজের কোড নির্দিষ্ট টুল দিয়ে তার কমেন্ট পড়ে ও উত্তর দেয় এবং কমেন্ট ইভেন্টগুলো আসার সঙ্গে সঙ্গে গ্রহণ করে, আর get_social_credentials আপনার নিজের কোডকে অন্য API for Business কলগুলোর জন্য টোকেন দেয়, যেখানে TikTok অ্যাকাউন্টকে অনুমতি দেয় সেখানে Mentions এন্ডপয়েন্টসহ।
/business/mention/video/list/ যে সর্বোচ্চ সংখ্যক উল্লেখ করা পোস্ট ফেরত দেয়, সবই পাবলিক ও গত 90 দিনের, প্রতি রিকোয়েস্টে 100 পর্যন্ত।
উল্লেখ করার পর থেকে Mentions API-তে তা পাওয়া যাওয়ার আনুমানিক বিলম্ব।
কেউ ক্যাপশন বা কমেন্টে ব্যবসাকে উল্লেখ করার পর TikTok Mentions ওয়েবহুকের জন্য যে লেটেন্সি দেয়।
UTC 0:00 থেকে 7:00 পর্যন্ত রিফ্রেশের পর, প্রতি অ্যাকাউন্টে প্রতিটি Mentions এন্ডপয়েন্ট কত ঘন ঘন কল করতে TikTok সুপারিশ করে।
/business/mention/comment/list/-এর জন্য biz.brand.insights-এর পাশাপাশি যে স্কোপ লাগে, যাতে ব্যবসাকে উল্লেখ করা কমেন্ট ফেরত আসে।
Mentions API-তে কোন এন্ডপয়েন্টগুলো আছে?
ছয়টি রিড এন্ডপয়েন্ট, প্রতিটি https://business-api.tiktok.com/open_api/v1.3-এ একটি GET, অ্যাকাউন্টের অ্যাক্সেস টোকেন Access-Token হেডারে এবং তার open_id business_id হিসেবে পাঠাতে হয়। দুটি উল্লেখের তালিকা দেয়, দুটি উল্লেখ করা পোস্ট কী বলছে তার সারাংশ দেয়, আর দুটি একটি ওয়েবহুকের জানানো একক উল্লেখ আনে:
কোন পোস্ট ও কমেন্ট উল্লেখ হিসেবে গণ্য হয়?
যেগুলো পোস্টের ক্যাপশনে বা কমেন্টের টেক্সটে অ্যাকাউন্টের হ্যান্ডেলকে @ দিয়ে ট্যাগ করে, পাবলিক পোস্টে, এবং TikTok-এর অন্য ফিল্টারগুলো পাস করে:
- পোস্টটি গত 90 দিনের মধ্যে প্রকাশিত।
- এর লেখক অপ্রাপ্তবয়স্ক বা বয়স অজানা নন: ইউরোপে 17 বা তার নিচের, আর যুক্তরাষ্ট্র ও অন্যান্য অঞ্চলে 12 বা তার নিচের বয়সকে অপ্রাপ্তবয়স্ক ধরা হয়।
- এটি হ্যান্ডেল উল্লেখকারী সবচেয়ে বেশি লাইক পাওয়া 1,000টি পোস্ট বা কমেন্টের মধ্যে থাকে।
- ব্যবসার নিজের পোস্ট, যদি এই নিয়মগুলো মেলে, সেগুলোও গণ্য হয়।
- শুধু উল্লেখ নিয়ে, অন্য কোনো টেক্সট ছাড়া করা কমেন্ট নিচের দিকে থাকে।
অ্যাকাউন্টটি ব্যবহার করার আগে কী লাগে?
একটি যোগ্য অ্যাকাউন্ট, সঠিক অনুমতিসহ একটি অ্যাপ, টোকেনে থাকা স্কোপ এবং মালিক অ্যাপটি অনুমোদন দেওয়ার পর এক দিনের অপেক্ষা:
- Advanced Access বা Verified Business Account; /business/get/-এ
has_advanced_accessদেখায় কোন অ্যাকাউন্টগুলো যোগ্য। - ডেভেলপার অ্যাপে Mentions অনুমতি, যা পোস্টের জন্য Mentions, Content এবং কমেন্টের জন্য Mentions, Comment হিসেবে তালিকাভুক্ত।
- অ্যাক্সেস টোকেনে biz.brand.insights, আর কমেন্ট উল্লেখের জন্য comment.list।
- প্রথম পুল করার আগে অনুমোদনের পর 24 ঘণ্টা, যেমন TikTok-এর getting-started গাইড চায়।
উল্লেখ করা পোস্টের তালিকা কীভাবে আনবেন?
GET /business/mention/video/list/ দিয়ে। fields ঠিক করে কোন ডেটা আসবে, ডিফল্টে 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 নির্দিষ্ট অঞ্চলের নির্মাতাদের রাখে, এবং cursor ও has_more ফলাফলের পৃষ্ঠা ধরে এগোয়। views ও reach 1,000-এর নিচে null দেখায়, আর থাম্বনেইল লিংকের মেয়াদ 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
}
}উল্লেখ করা কমেন্টের তালিকা কীভাবে আনবেন?
GET /business/mention/comment/list/ দিয়ে, যার টোকেনে comment.list-ও লাগে। ডিফল্টে 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। max_count-এ 100 পর্যন্ত চাওয়া না হলে এক পৃষ্ঠায় 10টি থাকে, এবং VIDEO_LIKES, COMMENT_CREATE_TIME বা COMMENT_LIKES অনুযায়ী সাজানো যায়। TikTok-এর বিশ্বাস ও নিরাপত্তা নীতির কারণে has_more সত্য থাকলেও কোনো পৃষ্ঠা কম ফেরত আসতে পারে।
উল্লেখে কীভাবে উত্তর দেবেন?
TikTok-এর কমেন্ট রিপ্লাই এন্ডপয়েন্টের মাধ্যমে। POST /business/comment/reply/create/ নেয় business_id, video_id, যা কমেন্ট উল্লেখের item_id-এর মান, comment_id এবং সর্বোচ্চ 1,200 অক্ষরের একটি text। উত্তরটি সেই কমেন্টের নিচে প্রকাশ্যে দেখা যায়, যে পোস্টেই সেটি থাকুক না কেন। TikTok-এর রেফারেন্সে এর জন্য comment.list.manage স্কোপ এবং একই অ্যাকাউন্টের শর্ত লেখা আছে। তাদের Mentions রেফারেন্সে উত্তর শুধু কমেন্ট উল্লেখের জন্য দেখানো আছে।
উল্লেখ কি ওয়েবহুকে আসতে পারে?
হ্যাঁ। Mentions অনুমতি থাকলে একটি অ্যাপ event_type BRAND_MENTION দিয়ে POST /business/webhook/update/ কল করে, এবং এরপর TikTok উল্লেখ হওয়ার দুই বা তিন ঘণ্টার মধ্যে brand.mention.event পাঠায়, যা অন্য ওয়েবহুকের মতোই Tiktok-Signature হেডারে স্বাক্ষরিত থাকে। content একটি সিরিয়ালাইজড JSON স্ট্রিং, যাতে থাকে:
type_of_event: CREATE, EDIT, অথবাPRIVACY_CHANGE, পোস্টের গোপনীয়তা সেটিংস বদলানোর জন্য।mention_type: কমেন্ট বা রিপ্লাইয়ের জন্য COMMENT, ক্যাপশনের জন্যVIDEO_MENTION; এই ক্ষেত্রেcomment_id0 থাকে।video_id,video_create_time,share_urlওvideo_caption, যেগুলো পোস্টটি বর্ণনা করে।open_id_of_mentioned_user,unique_name_of_mentioned_user, এবংunique_identifier, একটি কমেন্টকারীর ID যা সব API-তে একই থাকে।- বিস্তারিত আসে /business/mention/video/get/ বা /business/mention/comment/get/ থেকে, ঘটনার 48 ঘণ্টার মধ্যে।
Mentions এন্ডপয়েন্টগুলো কত ঘন ঘন কল করা উচিত?
প্রতি অ্যাকাউন্ট ও প্রতি এন্ডপয়েন্টে দিনে একবার, UTC সকাল 7টার পর, এটাই TikTok-এর পরামর্শ। এন্ডপয়েন্টগুলো ডেভেলপার অ্যাপের বৈশ্বিক রেট লিমিট ভাগ করে নেয়, তবে TikTok মধ্যরাত থেকে UTC সকাল 7টা পর্যন্ত আগের দিনের ডেটা রিফ্রেশ করে, আর একই দিনে আরও পুল করা অপ্রয়োজনীয়। নতুন উল্লেখ তালিকার এন্ডপয়েন্টে পৌঁছাতে মোটামুটি 24 থেকে 48 ঘণ্টা লাগে, তাই ওয়েবহুকই দ্রুততর সংকেত।
ব্র্যান্ড হ্যাশট্যাগ কীভাবে কাজ করে?
এগুলো ব্যবসার বেছে নেওয়া হ্যাশট্যাগ ব্যবহার করা পোস্টেও উল্লেখ বিস্তৃত করে। POST /business/mention/hashtag/add/ প্রতি রিকোয়েস্টে সর্বোচ্চ 10টি এবং প্রতি অ্যাকাউন্টে 50টি হ্যাশট্যাগ চালু করে, যেগুলো /business/mention/hashtag/verify/list/ থেকে পাওয়া 100টি পর্যন্ত প্রস্তাবের মধ্য থেকে নেওয়া, অথবা পুরো হ্যান্ডেল ধারণ করা, যেমন @TikTok-এর জন্য #drinktiktok। চালু হওয়া হ্যাশট্যাগ সাত দিন সরানো যায় না, এবং এর পোস্টগুলো চালু হওয়ার 24 ঘণ্টা পর /business/mention/hashtag/video/list/-এ আসে।
easyCoexistence TikTok উল্লেখ নিয়ে কী করতে পারে?
আপনার নিজের কোডকে অ্যাকাউন্টের টোকেন দিন: get_social_credentials business/-এর অধীনে থাকা API for Business পথগুলোর জন্য টোকেন ও business_id ফেরত দেয়, যার মধ্যে business/mention/ও আছে। অ্যাকাউন্ট ও অ্যাপ উপরের শর্ত পূরণ করলে TikTok উত্তর দেয়। উল্লেখের ওয়েবহুক এর বাইরে থাকে: easyCoexistence তার অ্যাপকে শুধু কমেন্ট ইভেন্টে সাবস্ক্রাইব করে এবং business/webhook/ পথগুলো নিজের কাছে রাখে, তাই BRAND_MENTION ইভেন্ট ফরোয়ার্ড হয় না। অ্যাকাউন্টের নিজের পোস্টের কমেন্টগুলো, উল্লেখসহ, এখনও comment.update ইভেন্ট হিসেবে আসে, যা 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 এন্ডপয়েন্ট কল করা। TikTok এগুলো শুধু Advanced Access বা Verified Business Account-এর জন্য দেয়, যা /business/get/-এ has_advanced_access দেখায়।
- মধ্যরাত UTC-র পরপরই উল্লেখ পুল করা। TikTok মধ্যরাত থেকে সকাল 7টা UTC-র মধ্যে আগের দিনের ডেটা রিফ্রেশ করে, তাই সকাল 7টার পরের পুল পুরো দিনটি দেখে।
- comment_id 0-কে কমেন্ট হিসেবে পড়া। ওয়েবহুকে এর মানে উল্লেখটি পোস্টের ক্যাপশনে, mention_type VIDEO_MENTION।
- কেবল পরীক্ষা করার জন্য ব্র্যান্ড হ্যাশট্যাগ চালু করা। TikTok চালু হওয়া হ্যাশট্যাগ সরানোর আগে সাত দিন রাখে, এবং এটি অ্যাকাউন্টের 50-এর সীমার মধ্যে গণনা হয়।
প্রতি সংযোগে প্রতি মাসে US$ 9 থেকে US$ 0.75, সংযোগ বাড়ালে কমে, প্রথম 3 দিন ফ্রি ট্রায়াল।
প্রায়শই জিজ্ঞাসিত প্রশ্ন
TikTok API কি আমার অ্যাকাউন্টকে উল্লেখ করা ভিডিও খুঁজে দিতে পারে?
হ্যাঁ, যেগুলো ক্যাপশনে এর হ্যান্ডেলকে @ দিয়ে উল্লেখ করে। /business/mention/video/list/ গত 90 দিনের 1,000টি পর্যন্ত পাবলিক পোস্ট ফেরত দেয়, প্রতিটির নির্মাতাকে creator_handle_name দিয়ে চিহ্নিত করে।
ব্যক্তিগত TikTok পোস্ট কি উল্লেখ হিসেবে গণ্য হয়?
না। Mentions API শুধু গত 90 দিনের পাবলিক পোস্ট গণনা করে, এবং অপ্রাপ্তবয়স্ক বা বয়স অজানা লেখকদের বাদ দেয়: ইউরোপে 17 বা তার নিচে, যুক্তরাষ্ট্র ও অন্যান্য অঞ্চলে 12 বা তার নিচে।
TikTok উল্লেখ দেখাতে কত সময় লাগে?
তালিকা এন্ডপয়েন্টে প্রায় 24 থেকে 48 ঘণ্টা, আর Mentions ওয়েবহুকে দুই বা তিন ঘণ্টা পর্যন্ত।
easyCoexistence কি TikTok উল্লেখ হলে আমাকে সতর্ক করতে পারে?
ফরোয়ার্ড করা ইভেন্ট হিসেবে নয়, কারণ এটি TikTok-এর কমেন্ট ইভেন্ট ফরোয়ার্ড করে, উল্লেখ ইভেন্ট নয়। যেখানে অ্যাকাউন্ট যোগ্য, আপনার নিজের কোড get_social_credentials-এর টোকেন দিয়ে অনুরোধে উল্লেখ পড়তে পারে।
আরও পড়ুন
দুই মিনিটে আপনার প্রথম চ্যানেল সংযুক্ত করুন।
প্ল্যাটফর্মের রিভিউয়ের জন্য অপেক্ষা করতে হবে না। WhatsApp, Instagram, TikTok বা অন্য কোনো চ্যানেল সংযুক্ত করুন, তারপর আপনার AI-কে পোস্ট করতে, রিপ্লাই দিতে বা রিপোর্ট দিতে বলুন, আর নিজের চোখে দেখুন কীভাবে কাজ করে।
- 3 দিন ফ্রি
- যেকোনো সময় বাতিল করুন
- শুধুমাত্র অফিশিয়াল API
- 24/7 পর্যবেক্ষণ
যাচাই করা হয়েছে