एपीआई के ज़रिए TikTok मेंशन: खाते का ज़िक्र करने वाली पोस्ट और कमेंट ढूँढना
TikTok का Mentions API, जो API for Business का हिस्सा है, GET /business/mention/video/list/ के ज़रिए 90 दिनों की वे शीर्ष 1,000 सार्वजनिक पोस्ट लौटाता है जिनके कैप्शन में किसी कारोबारी खाते को @ से मेंशन किया गया हो, और GET /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 में उपलब्ध होने के बीच लगभग देरी।
किसी उपयोगकर्ता द्वारा कैप्शन या कमेंट में कारोबार को मेंशन करने के बाद TikTok द्वारा Mentions वेबहुक के लिए बताई गई देरी।
0 से 7 am 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 की 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 नतीजों के पन्नों में आगे बढ़ाता है। 1,000 से कम पर views और reach 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 होता है। एक पन्ने में 10 होते हैं, जब तक max_count 100 तक न माँगे, और 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, एक कमेंटर आईडी जो सभी एपीआई में एक जैसी रहती है।- विवरण /business/mention/video/get/ या /business/mention/comment/get/ से इवेंट के 48 घंटे के भीतर मिलता है।
Mentions एंडपॉइंट को कितनी बार कॉल करना चाहिए?
TikTok की सलाह है कि हर एंडपॉइंट और खाते के लिए रोज़ एक बार, 7 am UTC के बाद। एंडपॉइंट डेवलपर ऐप की वैश्विक रेट लिमिट साझा करते हैं, पर TikTok आधी रात से 7 am 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/mention/ भी है, के लिए टोकन और business_id लौटाता है। 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 am UTC के बीच पिछले दिन का डेटा रीफ़्रेश करता है, इसलिए 7 am के बाद की पुल पूरा दिन देखती है।
- 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 दिन मुफ़्त
- कभी भी रद्द करें
- सिर्फ़ आधिकारिक एपीआई
- 24/7 निगरानी
इस तारीख को सत्यापित