एपीआई के ज़रिए TikTok वीडियो मेट्रिक्स: व्यूज़, वॉच टाइम और पूरा देखने की दर
TikTok API for Business GET /business/video/list/ से हर पोस्ट के पूरे जीवनकाल के मेट्रिक्स लौटाता है। fields में नाम लेकर ये माँगे जाते हैं: video_views, reach, likes, comments, shares और favorites, total_time_watched और average_time_watched (सेकंड में), full_video_watched_rate, video_view_retention, impression_sources, और audience_countries जैसे दर्शक विवरण। ज़्यादातर गिनती 24 से 48 घंटे देर से आती है, और प्रकाशन के 365 दिन बाद अपडेट होना रुक जाता है।
easyCoexistence Claude, ChatGPT या अपने कोड से get_social_insights के ज़रिए TikTok वीडियो के मेट्रिक्स पढ़ता है: वे fields नाम लें जो चाहिए, जैसे video_views, reach या full_video_watched_rate, और वीडियो का item_id दें।
वॉच टाइम, पूरा देखने, रिटेंशन, ट्रैफ़िक स्रोतों और दर्शक विवरण के लिए ज़रूरी स्कोप; बुनियादी गिनती के लिए video.list चाहिए।
निष्क्रियता की वह अवधि जिसके बाद किसी वीडियो के लिए reach, वॉच टाइम, ट्रैफ़िक स्रोत और audience_countries गायब हो सकते हैं।
किसी वीडियो की audience_countries और audience_cities सूचियों में ज़्यादातर प्रविष्टियाँ।
video_views, likes, reach, वॉच टाइम और ट्रैफ़िक स्रोतों के लिए आम देरी, UTC में।
किसी वीडियो के कौन-से मेट्रिक्स होते हैं?
GET /business/video/list/ fields में नामित हर पोस्ट के लिए ये लौटाता है, और यह पोस्ट के पूरे जीवनकाल पर जोड़ा जाता है, खाता मेट्रिक्स की 60 दिन की विंडो पर नहीं। व्यूज़ और लाइक्स जैसी गिनती के लिए टोकन पर video.list स्कोप चाहिए, जबकि वॉच, पूरा देखने और रिटेंशन के आँकड़ों के लिए video.insights:
इनका अनुरोध कैसे करें?
इन्हें fields में नाम लेकर माँगें। यह JSON array होना चाहिए, और जब इसमें एक से ज़्यादा field हों तो इसमें item_id ज़रूर होना चाहिए। filters.video_ids से पोस्ट चुनें। फ़िल्टर के बिना एंडपॉइंट खाते की पोस्ट्स को एक बार में 20 करके पेजिंग करता है:
curl -G 'https://business-api.tiktok.com/open_api/v1.3/business/video/list/' \
-H 'Access-Token: <ACCESS_TOKEN>' \
--data-urlencode 'business_id=<OPEN_ID>' \
--data-urlencode 'fields=["item_id","video_views","reach","video_duration","total_time_watched","average_time_watched","full_video_watched_rate","impression_sources","audience_countries"]' \
--data-urlencode 'filters={"video_ids":["<ITEM_ID>"]}'जवाब कैसा दिखता है?
हर पोस्ट के लिए एक ऑब्जेक्ट वाला videos array, माँगे गए fields के साथ, और पेजिंग के लिए cursor और has_more। TikTok का अपना संक्षिप्त उदाहरण इकाइयाँ दिखाता है: वॉच टाइम सेकंड में, तीन दशमलव तक, और full_video_watched_rate दशमलव के रूप में, यहाँ 0.0237:
{
"code": 0,
"message": "OK",
"request_id": "2021080307532501024502410704A7306F",
"data": {
"videos": [
{
"item_id": "6990565363377392901",
"video_views": 1231,
"reach": 154,
"likes": 10,
"comments": 2,
"shares": 0,
"video_duration": 20.0,
"total_time_watched": 695.942,
"average_time_watched": 4.118,
"full_video_watched_rate": 0.0237,
"impression_sources": [
{ "impression_source": "For You", "percentage": 0.8983 },
{ "impression_source": "Personal Profile", "percentage": 0.0904 },
{ "impression_source": "Follow", "percentage": 0.0113 }
],
"audience_countries": [
{ "country": "US", "percentage": 0.7574 },
{ "country": "GB", "percentage": 0.1775 }
]
}
],
"cursor": 0,
"has_more": false
}
}ट्रैफ़िक स्रोतों का क्या मतलब है?
impression_sources बताता है कि दर्शकों ने पोस्ट कहाँ से खोजी, सबसे बड़े हिस्से से सबसे छोटे तक क्रम में। हर प्रविष्टि एक impression_source है जिसमें उसका प्रतिशत है। TikTok ये मान दर्ज करता है:
- For You: For You फ़ीड।
- Follow: Follow फ़ीड।
- Sound: साउंड पेज।
- Personal Profile: प्रोफ़ाइल पेज।
- Search: सर्च पेज।
- Direct Message: डायरेक्ट मैसेज, जब TikTok Studio उस खाते के लिए यह डेटा दिखाता है।
- Others: बाक़ी सब कुछ।
दर्शक विवरण कौन-से हैं?
चार हैं, और सब उस पोस्ट को देखने वाले लोगों का वर्णन करते हैं, खाते के फ़ॉलोअर्स का नहीं। सबको video.insights चाहिए:
audience_genders: दर्शकों के हिस्से लिंग के अनुसार, Female, Male या Other।audience_countries: 10 तक देश या क्षेत्र, ISO 3166-1 alpha-2 कोड में।audience_cities: 10 तक शहर, US Cincinnati जैसे नाम से।audience_types:NEW_VIEWERऔरRETURN_VIEWER, औरFOLLOWER_PERCENTबनामNON_FOLLOWER_PERCENT।
कुछ मेट्रिक्स खाते के प्रकार पर निर्भर करते हैं?
कुछ क्लिक और प्रोफ़ाइल विज़िट TikTok के Business Analytics से आते हैं, और इनके लिए पर्सनल खाते से ज़्यादा चाहिए। profile_views, यानी वह प्रोफ़ाइल विज़िट जो कोई पोस्ट लाई, के लिए Advanced Access वाला खाता या Verified Business Account चाहिए। website_clicks, phone_number_clicks, lead_submissions, app_download_clicks, email_clicks और address_clicks के लिए Verified Business Account चाहिए।
कोई मेट्रिक गायब या देर से क्यों आता है?
क्योंकि TikTok ज़्यादातर मेट्रिक्स ऑफ़लाइन और केवल TikTok Analytics से गिनता है। गिनती और वॉच मेट्रिक्स आम तौर पर 24 से 48 घंटे पीछे रहते हैं, जबकि item_id, caption और links रीयल टाइम में आते हैं। Reach, वॉच टाइम, ट्रैफ़िक स्रोत और audience_countries उस वीडियो के लिए गायब हो सकते हैं जिसे 7 दिन तक किसी ने न देखा, न लाइक किया, न उस पर कमेंट किया, न शेयर किया। TikTok की सलाह है कि उसके साथ इंटरैक्ट करें और 24 से 48 घंटे बाद दोबारा कोशिश करें। प्रकाशन के 365 दिन बाद डेटा अपडेट होना रुक जाता है, और उल्लंघन के कारण फ़िल्टर हुई पोस्ट, जैसे म्यूज़िक कॉपीराइट, वापस नहीं आतीं।
easyCoexistence किसी वीडियो के मेट्रिक्स कैसे पढ़ता है?
get_social_insights से: वीडियो का item_id object_id के रूप में दें, और fields के नाम metrics में। यह उस पोस्ट के fields लौटाता है, खाते की 20 सबसे नई पोस्ट्स में खोजकर। पुरानी पोस्ट के लिए, आपका अपना कोड get_social_credentials से मिले टोकन का उपयोग करके parameters के रूप में fields और filters.video_ids के साथ business/video/list/ को कॉल करता है।
get_social_insights {
"account_id": "<ACCOUNT_ID>",
"object_id": "<ITEM_ID>",
"metrics": ["video_views", "reach", "average_time_watched", "full_video_watched_rate", "impression_sources"]
}आम गड़बड़ियाँ
- हर प्रतिशत के लिए एक ही पैमाना मान लेना। TikTok के उदाहरणों में impression_sources भिन्न के रूप में आते हैं जिनका योग 1 है, जबकि उसका audience_cities उदाहरण 17.4921 जैसे मान दिखाता है।
- item_id के बिना कई fields माँगना। TikTok का संदर्भ चेतावनी देता है कि ऐसा अनुरोध विफल हो सकता है।
- किसी पुराने, शांत वीडियो के लिए reach की उम्मीद करना। TikTok 7 दिन तक व्यूज़, लाइक्स, कमेंट या शेयर न होने पर reach, वॉच टाइम और ट्रैफ़िक स्रोत खाली छोड़ सकता है।
- पोस्ट के मेट्रिक्स की तुलना रोज़ के खाता मेट्रिक्स से करना। पोस्ट के आँकड़े उसके पूरे जीवनकाल के होते हैं, जबकि खाता मेट्रिक्स 60 दिन तक दिन के हिसाब से आते हैं।
पुरानी पोस्ट के लिए, get_social_credentials आपके अपने कोड को खाते का टोकन देता है। US$ 9 से लेकर US$ 0.75 तक प्रति कनेक्शन प्रति माह, कनेक्शन बढ़ने के साथ घटती दर पर, और पहले 3 दिन मुफ़्त।
अक्सर पूछे जाने वाले सवाल
क्या TikTok API प्रति वीडियो वॉच टाइम देता है?
हाँ। total_time_watched और average_time_watched /business/video/list/ से सेकंड में आते हैं, video.insights स्कोप वाले टोकन के लिए।
एपीआई से TikTok वीडियो की पूरा देखने की दर कैसे मिलेगी?
/business/video/list/ पर fields में full_video_watched_rate माँगें। TikTok इसे उन दर्शकों का प्रतिशत बताता है जो वीडियो पूरा देखते हैं।
मेरे TikTok वीडियो के लिए reach और वॉच टाइम खाली क्यों हैं?
पिछले 7 दिनों में जिस वीडियो पर कोई व्यूज़, लाइक्स, कमेंट या शेयर न हो, TikTok उन्हें छोड़ सकता है, और ताज़ा डेटा 24 से 48 घंटे पीछे रहता है।
क्या एपीआई एक खास TikTok वीडियो के मेट्रिक्स लौटा सकता है?
हाँ। उसका ID filters.video_ids में दें, और item_id के साथ चाहे गए मेट्रिक्स fields में।
पढ़ना जारी रखें
दो मिनट में अपना पहला चैनल कनेक्ट करें।
किसी प्लैटफ़ॉर्म की समीक्षा का इंतज़ार नहीं। WhatsApp, Instagram, TikTok या कोई और चैनल कनेक्ट करें, फिर अपने AI से पोस्ट करने, जवाब देने या रिपोर्ट बनाने को कहें और उसे काम करते देखें।
- 3 दिन मुफ़्त
- कभी भी रद्द करें
- सिर्फ़ आधिकारिक एपीआई
- 24/7 निगरानी
इस तारीख को सत्यापित