लॉग इनमुफ़्त ट्रायल शुरू करें
easyCoexistence आधिकारिक एपीआई

एपीआई के ज़रिए 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.insights

वॉच टाइम, पूरा देखने, रिटेंशन, ट्रैफ़िक स्रोतों और दर्शक विवरण के लिए ज़रूरी स्कोप; बुनियादी गिनती के लिए video.list चाहिए।

7 days

निष्क्रियता की वह अवधि जिसके बाद किसी वीडियो के लिए reach, वॉच टाइम, ट्रैफ़िक स्रोत और audience_countries गायब हो सकते हैं।

10

किसी वीडियो की audience_countries और audience_cities सूचियों में ज़्यादातर प्रविष्टियाँ।

24 to 48 h

video_views, likes, reach, वॉच टाइम और ट्रैफ़िक स्रोतों के लिए आम देरी, UTC में।

किसी वीडियो के कौन-से मेट्रिक्स होते हैं?

GET /business/video/list/ fields में नामित हर पोस्ट के लिए ये लौटाता है, और यह पोस्ट के पूरे जीवनकाल पर जोड़ा जाता है, खाता मेट्रिक्स की 60 दिन की विंडो पर नहीं। व्यूज़ और लाइक्स जैसी गिनती के लिए टोकन पर video.list स्कोप चाहिए, जबकि वॉच, पूरा देखने और रिटेंशन के आँकड़ों के लिए video.insights:

video_viewsViews, counted on the first playback in an impression session
reachPeople who watched the post at least once
likes, comments, sharesLifetime totals; shares include sends to friends inside TikTok
favoritesTimes the post was added to favorites
total_time_watchedSeconds viewers spent watching, in total
average_time_watchedAverage seconds viewers spent watching
full_video_watched_rateShare of viewers who finished the video
video_view_retentionShare of viewers still watching at each second
impression_sourcesWhere viewers found the post, by share
new_followersViewers who started following the account
engagement_likesShare of viewers who liked at each second
video_durationLength of the video in seconds

इनका अनुरोध कैसे करें?

इन्हें fields में नाम लेकर माँगें। यह JSON array होना चाहिए, और जब इसमें एक से ज़्यादा field हों तो इसमें item_id ज़रूर होना चाहिए। filters.video_ids से पोस्ट चुनें। फ़िल्टर के बिना एंडपॉइंट खाते की पोस्ट्स को एक बार में 20 करके पेजिंग करता है:

Metrics for one video
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:

A video's metrics, from TikTok's example
{
  "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/ को कॉल करता है।

One video's metrics through MCP
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 दिन तक दिन के हिसाब से आते हैं।
EasyCoexistence के साथ ऐसा करना

पुरानी पोस्ट के लिए, 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 में।

पढ़ना जारी रखें

एपीआई के ज़रिए TikTok दर्शक डेमोग्राफ़िक्सTikTok के API for Business से मिलने वाले फ़ॉलोअर डेमोग्राफ़िक्स: उम्र, लिंग, देश, शहर का हिस्सा, हर घंटे की गतिविधि और 100 फ़ॉलोअर का नियम।API के ज़रिए TikTok खाते के वीडियो की सूची/business/video/list/ से TikTok खाते की पोस्ट की सूची: फ़ील्ड, कर्सर पेजिनेशन, प्रति पेज 20 पोस्ट और ID से फ़िल्टर।TikTok एनालिटिक्स API: अकाउंट इनसाइट्स और वीडियो मेट्रिक्सAPI for Business से मिलने वाले TikTok मेट्रिक्स: किसी अकाउंट के रोज़ के फ़ॉलोअर, व्यूज़ और लाइक, तथा हर वीडियो के व्यूज़, लाइक, कमेंट और शेयर।TikTok API for Business के स्कोप: हर अनुमति क्या खोलती हैTikTok के अपने नामों वाली अनुमतियाँ, जो उसकी Accounts API के साथ काम करती हैं: हर एक क्या खोलती है, हर फ़ील्ड के स्कोप, और टोकन कैसे जाँचें।एपीआई के ज़रिए TikTok पर वीडियो कैसे पोस्ट करेंबिज़नेस एपीआई से TikTok पर वीडियो पोस्ट करें: पब्लिश एंडपॉइंट, उसकी JSON बॉडी, लौटने वाला share_id और स्टेटस कॉल, curl और Python में।

दो मिनट में अपना पहला चैनल कनेक्ट करें।

किसी प्लैटफ़ॉर्म की समीक्षा का इंतज़ार नहीं। WhatsApp, Instagram, TikTok या कोई और चैनल कनेक्ट करें, फिर अपने AI से पोस्ट करने, जवाब देने या रिपोर्ट बनाने को कहें और उसे काम करते देखें।

  • 3 दिन मुफ़्त
  • कभी भी रद्द करें
  • सिर्फ़ आधिकारिक एपीआई
  • 24/7 निगरानी

इस तारीख को सत्यापित