API द्वारे TikTok मेन्शन्स: खात्याचा उल्लेख करणाऱ्या पोस्ट आणि कमेंट्स शोधणे
TikTok चे मेन्शन्स API, जे व्यवसायांसाठीच्या API चा भाग आहे, GET /business/mention/video/list/ द्वारे कॅप्शनमध्ये खात्याच्या @हँडलचा उल्लेख असलेल्या गेल्या 90 दिवसांतील शीर्ष 1,000 सार्वजनिक पोस्ट परत करते. /business/mention/comment/list/ द्वारे त्याचा उल्लेख असलेल्या शीर्ष 1,000 कमेंट्स किंवा रिप्लाय मिळतात. दोन्हीसाठी biz.brand.insights स्कोप आणि ॲडव्हान्स्ड ॲक्सेस किंवा व्हेरिफाइड व्यवसाय खाते लागते.
easyCoexistence TikTok खाते TikTok च्या व्यवसायासाठीच्या API द्वारे जोडते: Claude, ChatGPT किंवा तुमचा स्वतःचा कोड त्याच्या कमेंट्स वाचू शकतो आणि समर्पित टूल्सने त्यांना उत्तर देऊ शकतो, कमेंट इव्हेंट येताच प्राप्त करू शकतो, आणि get_social_credentials तुमच्या कोडला इतर व्यवसाय API कॉल्ससाठी टोकन देते, ज्यात TikTok ने खात्यासाठी उघडलेले मेन्शन्स एंडपॉइंट्सही येतात.
/business/mention/video/list/ परत करत असलेल्या सर्वाधिक मेन्शन असलेल्या पोस्ट, सर्व सार्वजनिक आणि गेल्या 90 दिवसांतील, प्रति विनंती 100 पर्यंत.
मेन्शन केल्यानंतर ते मेन्शन्स API द्वारे उपलब्ध होण्यासाठीचा अंदाजे विलंब.
वापरकर्ता कॅप्शन किंवा कमेंटमध्ये व्यवसायाचा उल्लेख केल्यानंतर TikTok मेन्शन वेबहुकसाठी देत असलेला विलंब.
0 ते 7 am UTC रिफ्रेशनंतर, प्रति खाते प्रत्येक मेन्शन्स एंडपॉइंट किती वेळा कॉल करावा, अशी TikTok शिफारस करते.
/business/mention/comment/list/ साठी biz.brand.insights सोबत लागणारा स्कोप, खात्याचा उल्लेख असलेल्या कमेंट्स परत मिळवण्यासाठी.
कोणते एंडपॉइंट्स मेन्शन्स API मध्ये आहेत?
सहा रीड एंडपॉइंट्स आहेत, प्रत्येक https://business-api.tiktok.com/open_api/v1.3 वर GET असून, खात्याचा ॲक्सेस टोकन Access-Token हेडरमध्ये आणि त्याचा open_id business_id म्हणून दिला जातो. दोन मेन्शनची यादी देतात, दोन मेन्शन असलेल्या पोस्ट काय म्हणतात त्याचा सारांश देतात, आणि दोन वेबहुकने जाहीर केलेला एक मेन्शन मिळवतात:
कोणत्या पोस्ट आणि कमेंट्स मेन्शन मानल्या जातात?
ज्या खात्याच्या हँडलला @ने टॅग करतात, पोस्टच्या कॅप्शनमध्ये किंवा कमेंटच्या मजकुरात, सार्वजनिक पोस्टवर, आणि TikTok च्या इतर फिल्टरमधून जातात:
- पोस्ट गेल्या 90 दिवसांत प्रकाशित झालेली असावी.
- लेखक अल्पवयीन किंवा वय अज्ञात नसावा: युरोपमध्ये 17 किंवा त्याहून कमी, अमेरिका व इतर प्रदेशांत 12 किंवा त्याहून कमी वय अल्पवयीन मानले जाते.
- हँडलचा उल्लेख करणाऱ्या सर्वाधिक लाइक्स मिळालेल्या 1,000 पोस्ट किंवा कमेंट्समध्ये स्थान मिळवते.
- व्यवसायाच्या स्वतःच्या पोस्टही हे नियम पूर्ण करत असतील तर मोजल्या जातात.
- केवळ मेन्शन असलेल्या, इतर मजकूर नसलेल्या कमेंट्स कमी क्रमांकावर येतात.
वापरासाठी खात्याला आधी काय लागते?
पात्र खाते, योग्य परवानगी असलेले ॲप, टोकनवरील स्कोप, आणि खात्याच्या मालकाने ॲपला अधिकृतता दिल्यानंतर एक दिवसाची प्रतीक्षा:
- ॲडव्हान्स्ड ॲक्सेस किंवा व्हेरिफाइड व्यवसाय खाते; /business/get/ वरील
has_advanced_accessसांगते कोणती खाती पात्र आहेत. - डेव्हलपर ॲपवर मेन्शन्सची परवानगी, पोस्टसाठी 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 निकालांची पाने पार करतात. views आणि reach 1,000 च्या खाली 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 अजून खरे असतानाही पान कमी संख्येने परत येऊ शकते.
मेन्शनला उत्तर कसे द्यायचे?
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, कमेंट करणाऱ्याचा ID जो सर्व एपीआयमध्ये सारखाच राहतो.- तपशील /business/mention/video/get/ किंवा /business/mention/comment/get/ वरून, घटनेच्या 48 तासांत मिळतात.
मेन्शन एंडपॉइंट्स किती वेळा कॉल करावेत?
प्रत्येक एंडपॉइंट आणि खात्यासाठी दिवसातून एकदा, 7 am UTC नंतर, असा TikTok चा सल्ला आहे. एंडपॉइंट्स डेव्हलपर ॲपच्या जागतिक दर मर्यादेत सामायिक होतात, पण 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 व्यवसायासाठीच्या API मार्गांसाठी 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!" }सामान्य चुका
- खात्यासाठी ॲडव्हान्स्ड ॲक्सेस शिवाय मेन्शन एंडपॉइंट्स कॉल करणे. TikTok ते ॲडव्हान्स्ड ॲक्सेस किंवा व्हेरिफाइड व्यवसाय खाते असलेल्यांना देतो, जे /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 तास, आणि मेन्शन वेबहुकद्वारे दोन-तीन तासांपर्यंत.
easyCoexistence माझे TikTok खाते मेन्शन झाल्यावर मला सूचना देऊ शकते का?
पुढे पाठवलेला इव्हेंट म्हणून नाही, कारण ते TikTok चे कमेंट इव्हेंट पुढे पाठवते, मेन्शन इव्हेंट नाही. तुमचा स्वतःचा कोड विनंतीनुसार, खाते पात्र असेल तेथे get_social_credentials मधील टोकनसह मेन्शन वाचू शकतो.
पुढे वाचा
तुमचे पहिले चॅनेल दोन मिनिटांत कनेक्ट करा.
कोणत्याही प्लॅटफॉर्म पुनरावलोकनाची वाट पाहावी लागत नाही. WhatsApp, Instagram, TikTok किंवा दुसरे चॅनेल कनेक्ट करा, मग तुमच्या AI ला पोस्ट करायला, उत्तर द्यायला किंवा रिपोर्ट द्यायला सांगा आणि ते काम करताना पाहा.
- 3 दिवस मोफत
- कधीही रद्द करा
- फक्त अधिकृत एपीआय
- 24/7 देखरेख
पडताळले: