لاگ اِن کریںفری ٹرائل شروع کریں
easyCoexistence آفیشل APIs

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 انہیں اکاؤنٹ کے لیے کھولتا ہے۔

1,000

/business/mention/video/list/ سے ایک درخواست میں ملنے والی پوسٹس، سب عوامی اور پچھلے 90 دنوں کی، زیادہ سے زیادہ 100 تک۔

24 to 48 hours

کسی ذکر کے کیے جانے اور Mentions API کے ذریعے اس کے دستیاب ہونے کے درمیان تقریباً وقفہ۔

2 to 3 hours

کوئی صارف کیپشن یا کمنٹ میں کاروبار کا ذکر کرے تو Mentions ویب ہک کے لیے TikTok کی بتائی ہوئی تاخیر۔

Once a day

0 سے 7 بجے UTC کے ریفریش کے بعد، TikTok ہر اکاؤنٹ کے لیے ہر Mentions اینڈ پوائنٹ کو کتنی بار کال کرنے کا مشورہ دیتا ہے۔

comment.list

اکاؤنٹ کا ذکر کرنے والے کمنٹس لوٹانے کے لیے، /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 کے طور پر جاتا ہے۔ دو ذکر کی فہرست دیتے ہیں، دو ذکر شدہ پوسٹس میں جو کچھ ہے اس کا خلاصہ دیتے ہیں، اور دو ایسے ذکر لاتے ہیں جن کی ویب ہک نے اطلاع دی ہو:

/business/mention/video/list/Up to 1,000 posts whose caption mentions the account, 100 a page
/business/mention/comment/list/Up to 1,000 comments or replies whose text mentions the account
/business/mention/top_word/list/The 20 keywords that appear most in mentioned posts' captions
/business/mention/top_hashtag/list/The 20 hashtags used most in those captions
/business/mention/video/get/One mentioned post from a webhook event, within 48 hours
/business/mention/comment/get/One comment mention from a webhook event, within 48 hours

کون سی پوسٹس اور کمنٹس ذکر کے طور پر شمار ہوتے ہیں؟

وہ جو کیپشن یا کمنٹ کے متن میں اکاؤنٹ کا ہینڈل @ کے ساتھ ٹیگ کریں، عوامی پوسٹ پر، اور 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 گھنٹے تک کارآمد رہتے ہیں:

Mentioned posts, sorted by likes
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_id 0 ہوتا ہے۔
  • 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 آگے بھیجتا ہے:

Comment mentions and a reply, from your own code
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 کی حد میں شمار ہوتا ہے۔
EasyCoexistence کے ساتھ یہ کام کرنا

فی کنیکشن ماہانہ 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 کے ٹوکن کے ساتھ، جہاں اکاؤنٹ اہل ہو۔

مزید پڑھیں

TikTok کمنٹس کے جوابات اور API کے ذریعے موڈریشنTikTok کی API for Business کمنٹس پڑھنے، ان کا جواب دینے، چھپانے اور ڈیلیٹ کرنے دیتی ہے، اور رول اور آٹومیشن نئے کمنٹس کا خود جواب دیتے ہیں۔TikTok ویب ہکس کی تصدیق: سگنیچر ہیڈر اور اسے چیک کرنے کا طریقہTikTok API for Business ویب ہک کی تصدیق کریں: Tiktok-Signature ہیڈر، t اور خام body کا HMAC-SHA256، Node.js میں۔TikTok API ریٹ لمٹس: فی اکاؤنٹ، ایپ اور اینڈ پوائنٹ کے حساب سے درخواستیںTikTok API ریٹ لمٹس: ہر اکاؤنٹ اور اینڈ پوائنٹ پر ایک منٹ میں 40 کالز، Accounts API پر ایپ کی سطح کے مطابق 600 یا 1,000 فی منٹ، اور چار ایپ لیولز۔TikTok API for Business کے اسکوپس: ہر اجازت کیا کھولتی ہےTikTok Accounts API کے ساتھ کام کرنے والی اجازتیں، TikTok کے اپنے ناموں سے: ہر ایک کیا کھولتی ہے، فی فیلڈ ٹوکن اسکوپس، اور ٹوکن کیسے جانچیں۔TikTok تبصروں کے AI جواباتکاروبار کا اپنا AI TikTok تبصروں کا عوامی طور پر جواب دیتا ہے: نئے تبصروں پر آٹومیشن، 150 حروف تک کے جوابات اور کی ورڈ قواعد۔TikTok کمنٹ ویب ہک ایونٹسTikTok کا comment.update ویب ہک کمنٹس اور ریپلائیز کیسے بتاتا ہے، ہر ایونٹ میں کیا ہوتا ہے، اور وہ دستخط شدہ آپ کے اینڈ پوائنٹ تک کیسے پہنچتے ہیں۔

دو منٹ میں اپنا پہلا چینل کنیکٹ کریں۔

کسی پلیٹ فارم کے ریویو کا انتظار نہیں۔ WhatsApp، Instagram، TikTok یا کوئی اور چینل کنیکٹ کریں، پھر اپنے AI سے پوسٹ کرنے، جواب دینے یا رپورٹ بنانے کو کہیں اور اسے کام کرتے دیکھیں۔

  • 3 دن مفت
  • کسی بھی وقت منسوخ کریں
  • صرف آفیشل API
  • 24/7 نگرانی

تصدیق شدہ تاریخ