API کے ذریعے TikTok Mentions: کسی اکاؤنٹ کا ذکر کرنے والی پوسٹس اور کمنٹس تلاش کرنا
TikTok کا Mentions API، جو API for Business کا حصہ ہے، GET /business/mention/video/list/ کے ذریعے وہ 1,000 سرفہرست عوامی پوسٹس لوٹاتا ہے جو پچھلے 90 دنوں کی ہیں اور اپنے کیپشن میں کسی کاروباری اکاؤنٹ کو @ سے ذکر کرتی ہیں، اور /business/mention/comment/list/ کے ذریعے وہ 1,000 سرفہرست کمنٹس یا جوابات جو اسے ذکر کرتے ہیں۔ دونوں کے لیے biz.brand.insights اسکوپ اور Advanced Access یا Verified Business Account والا اکاؤنٹ درکار ہے۔
easyCoexistence TikTok اکاؤنٹ کو TikTok کے API for Business کے ذریعے کنیکٹ کرتا ہے: Claude، ChatGPT یا آپ کا اپنا کوڈ اس کے کمنٹس پڑھتا ہے اور مخصوص ٹولز سے ان کا جواب دیتا ہے اور اس کے کمنٹ ایونٹس آتے ہی وصول کرتا ہے، اور get_social_credentials آپ کے اپنے کوڈ کو دوسری API for Business کالز کے لیے ٹوکن دیتا ہے، جن میں Mentions اینڈ پوائنٹس بھی شامل ہیں جہاں TikTok انہیں اکاؤنٹ کے لیے کھولتا ہے۔
/business/mention/video/list/ سے ایک درخواست میں ملنے والی پوسٹس، سب عوامی اور پچھلے 90 دنوں کی، زیادہ سے زیادہ 100 تک۔
کسی ذکر کے کیے جانے اور Mentions API کے ذریعے اس کے دستیاب ہونے کے درمیان تقریباً وقفہ۔
کوئی صارف کیپشن یا کمنٹ میں کاروبار کا ذکر کرے تو Mentions ویب ہک کے لیے TikTok کی بتائی ہوئی تاخیر۔
0 سے 7 بجے UTC کے ریفریش کے بعد، TikTok ہر اکاؤنٹ کے لیے ہر Mentions اینڈ پوائنٹ کو کتنی بار کال کرنے کا مشورہ دیتا ہے۔
اکاؤنٹ کا ذکر کرنے والے کمنٹس لوٹانے کے لیے، /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 کی شروع کرنے کی گائیڈ کہتی ہے۔
اکاؤنٹ کا ذکر کرنے والی پوسٹس کیسے لسٹ کریں؟
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 نتائج کو صفحات میں دیکھتا ہے۔ 1,000 سے کم ہونے پر views اور reach کی قیمت null ہوتی ہے، اور thumbnail لنکس 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 ہوتی ہے۔ ایک صفحے میں 10 ہوتے ہیں، الا یہ کہ max_count 100 تک مانگے، اور VIDEO_LIKES، COMMENT_CREATE_TIME یا COMMENT_LIKES کے لحاظ سے ترتیب دیے جاتے ہیں۔ TikTok کی ٹرسٹ اور سیفٹی پالیسیوں کی وجہ سے صفحہ کم نتائج کے ساتھ واپس آ سکتا ہے، جبکہ has_more پھر بھی true ہو۔
کسی ذکر کا جواب کیسے دیں؟
TikTok کے کمنٹ جواب کے اینڈ پوائنٹ کے ذریعے۔ POST /business/comment/reply/create/ میں business_id، video_id جو کمنٹ ذکر کے item_id پر سیٹ ہوتا ہے، comment_id اور 1,200 حروف تک کا text لیا جاتا ہے، اور جواب اس کمنٹ کے نیچے عوامی طور پر ظاہر ہوتا ہے، اس پوسٹ پر جس میں وہ ہو۔ TikTok کا حوالہ اس کے لیے comment.list.manage اسکوپ اور وہی اکاؤنٹ شرط بتاتا ہے۔ اس کا Mentions حوالہ جواب کو صرف کمنٹ ذکر کے لیے درج کرتا ہے۔
کیا ذکر ویب ہک کے ذریعے آ سکتے ہیں؟
ہاں۔ Mentions اجازت کے ساتھ، ایک ایپ POST /business/webhook/update/ کو event_type BRAND_MENTION کے ساتھ کال کرتی ہے، اور 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، کمنٹ کرنے والے کی ایک آئی ڈی جو تمام APIs میں یکساں رہتی ہے۔- تفصیلات /business/mention/video/get/ یا /business/mention/comment/get/ سے آتی ہیں، واقعے کے 48 گھنٹوں کے اندر۔
Mentions اینڈ پوائنٹس کتنی بار کال کیے جائیں؟
ہر اینڈ پوائنٹ اور اکاؤنٹ کے لیے دن میں ایک بار، 7 بجے UTC کے بعد، یہ TikTok کا مشورہ ہے۔ اینڈ پوائنٹس ڈیولپر ایپ کی عالمی ریٹ لمٹس شیئر کرتے ہیں، مگر TikTok پچھلے دن کا ڈیٹا آدھی رات اور 7 بجے UTC کے درمیان ریفریش کرتا ہے، اور اسی دن مزید درخواستیں کرنا غیر ضروری ہے۔ نیا ذکر لسٹ اینڈ پوائنٹس تک تقریباً 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 جواب دیتا ہے جب اکاؤنٹ اور ایپ اوپر کی شرائط پوری کریں۔ Mention ویب ہکس اس سے باہر ہیں: 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 ویب ہک میں اس کا مطلب ہے کہ ذکر پوسٹ کے کیپشن میں ہے، جس کا 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 نگرانی
تصدیق شدہ تاریخ