TikTok Mentions API मार्फत: खाताको उल्लेख गर्ने पोस्ट र कमेन्ट खोज्ने
TikTok को Mentions API, जो व्यवसाय API को भाग हो, GET /business/mention/video/list/ मार्फत खाताको क्याप्सनमा @ उल्लेख गर्ने विगत 90 दिनका शीर्ष 1,000 सार्वजनिक पोस्ट फर्काउँछ, र /business/mention/comment/list/ मार्फत उल्लेख गर्ने शीर्ष 1,000 कमेन्ट वा रिप्लाइ फर्काउँछ। दुवैलाई biz.brand.insights स्कोप र Advanced Access वा प्रमाणित व्यवसाय खाता चाहिन्छ।
easyCoexistence ले TikTok खाता TikTok को व्यवसाय API मार्फत जडान गर्छ: Claude, ChatGPT वा तपाईंको आफ्नै कोडले यसका कमेन्ट पढ्छन् र समर्पित टूलहरूमार्फत तिनको उत्तर दिन्छन्, खाताका कमेन्ट इभेन्टहरू आउँदा प्राप्त गर्छन्, र get_social_credentials ले तपाईंको आफ्नै कोडलाई अन्य व्यवसाय API कलहरूका लागि टोकन दिन्छ, जसमा TikTok ले खोल्ने ठाउँमा Mentions एन्डपोइन्टहरू पनि पर्छन्।
GET /business/mention/video/list/ ले फर्काउने सबैभन्दा धेरै उल्लेखित पोस्ट, सबै सार्वजनिक र विगत 90 दिनका, प्रति अनुरोध 100 सम्म।
उल्लेख गरिएको र Mentions API मा उपलब्ध हुनुबीचको अनुमानित ढिलाइ।
प्रयोगकर्ताले खाताको क्याप्सन वा कमेन्टमा व्यवसायलाई उल्लेख गरेपछि Mentions वेबहुकका लागि TikTok ले दिने विलम्ब।
मध्यरातदेखि 7 बजे UTC सम्मको रिफ्रेसपछि, प्रत्येक खाताका लागि हरेक 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 वा प्रमाणित व्यवसाय खाता; /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 देखिन्छन्, र थम्बनेल लिङ्क 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, कमेन्ट उल्लेखको item_id लाई video_id मा सेट गरेको, comment_id, र 1,200 वर्णसम्मको पाठ लिन्छ, र रिप्लाइ त्यो कमेन्टमुनि सार्वजनिक रूपमा देखिन्छ, जुन पोस्टमा भए पनि। 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_idको मान 0 हुन्छ।video_id,video_create_time,share_urlरvideo_caption, जसले पोस्टको वर्णन गर्छन्।open_id_of_mentioned_user,unique_name_of_mentioned_user, रunique_identifier, एउटा कमेन्टकर्ता ID जुन APIs भर एउटै रहन्छ।- विवरणहरू /business/mention/video/get/ वा /business/mention/comment/get/ बाट आउँछन्, घटनाको 48 घण्टाभित्र।
Mentions endpoint हरू कति पटक कल गर्नुपर्छ?
प्रत्येक खाता र एन्डपोइन्टका लागि दिनमा एक पटक, 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 पथहरूका लागि टोकन र 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 वा प्रमाणित व्यवसाय खाता भएका खातालाई मात्र दिन्छ, जुन /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 दिन निःशुल्क
- जुनसुकै बेला रद्द गर्नुहोस्
- आधिकारिक एपीआई मात्र
- 24/7 निगरानी
प्रमाणीकरण गरिएको