লগ ইনফ্রি ট্রায়াল শুরু করুন
easyCoexistence অফিসিয়াল API

API-এর মাধ্যমে 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 ভিডিওর মেট্রিক পড়ে: আপনি যে ফিল্ডগুলো চান তার নাম দিন, যেমন video_views, reach বা full_video_watched_rate, এবং ভিডিওর item_id দিন।

video.insights

watch time, completion, retention, traffic sources ও দর্শক-বিভাজনের জন্য প্রয়োজনীয় স্কোপ; মৌলিক সংখ্যার জন্য 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 অ্যারে যেখানে একাধিক ফিল্ড থাকলে 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 অ্যারে থাকে, প্রতিটি পোস্টের জন্য একটি অবজেক্ট এবং চাওয়া ফিল্ডগুলো নিয়ে, সঙ্গে পেজিংয়ের জন্য 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, ক্যাপশন ও লিংক রিয়েল টাইমে আসে। reach, দেখার সময়, ট্রাফিক উৎস ও audience_countries এমন একটি ভিডিওর জন্য অনুপস্থিত থাকতে পারে যাতে 7 দিন কেউ ভিউ, লাইক, কমেন্ট বা শেয়ার করেনি; TikTok-এর পরামর্শ, ওটির সঙ্গে ইন্টারঅ্যাক্ট করে 24 থেকে 48 ঘণ্টা পর আবার চেষ্টা করা। প্রকাশের 365 দিন পর ডেটা আপডেট হওয়া বন্ধ হয়, এবং লঙ্ঘনের কারণে ফিল্টার হওয়া পোস্ট, যেমন মিউজিক কপিরাইট, ফেরত আসে না।

easyCoexistence কীভাবে একটি ভিডিওর মেট্রিক পড়ে?

get_social_insights দিয়ে: ভিডিওর item_id object_id হিসেবে এবং ফিল্ডের নামগুলো metrics হিসেবে দিন, তখন অ্যাকাউন্টের সাম্প্রতিক 20টি পোস্টের মধ্যে খুঁজে ওই পোস্টের ফিল্ডগুলো ফেরত দেয়। পুরোনো পোস্টের জন্য আপনার নিজের কোড fields ও filters.video_ids প্যারামিটার হিসেবে নিয়ে business/video/list/ কল করে, get_social_credentials থেকে পাওয়া টোকেন দিয়ে।

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 ছাড়া একাধিক ফিল্ড চাওয়া। TikTok-এর রেফারেন্স সতর্ক করে যে এমন অনুরোধ ব্যর্থ হতে পারে।
  • একটি পুরোনো, নীরব ভিডিওর জন্য রিচ আশা করা। 7 দিন ভিউ, লাইক, কমেন্ট বা শেয়ার না থাকলে TikTok রিচ, দেখার সময় ও ট্রাফিক উৎস খালি রেখে দিতে পারে।
  • পোস্টের মেট্রিককে দৈনিক অ্যাকাউন্ট মেট্রিকের সঙ্গে তুলনা করা। পোস্টের পরিসংখ্যান তার পুরো জীবনকাল ধরে, অথচ অ্যাকাউন্ট মেট্রিক আসে দিনভিত্তিক, 60 দিন পর্যন্ত।
EasyCoexistence দিয়ে এটি করা

পুরোনো পোস্টের জন্য get_social_credentials আপনার নিজের কোডকে অ্যাকাউন্টের টোকেন দেয়। প্রতি সংযোগ প্রতি মাসে US$ 9 থেকে US$ 0.75, সংযোগ যত বাড়ে তত কমে, প্রথম 3 দিন ফ্রি।

প্রায়শই জিজ্ঞাসিত প্রশ্ন

TikTok API কি প্রতি ভিডিওর দেখার সময় দেয়?

হ্যাঁ। total_time_watched ও average_time_watched /business/video/list/ থেকে সেকেন্ডে আসে, video.insights স্কোপের টোকেনের জন্য।

API-এর মাধ্যমে কীভাবে একটি TikTok ভিডিওর সম্পূর্ণ দেখার হার পাব?

/business/video/list/-এ fields-এ full_video_watched_rate অনুরোধ করুন। TikTok এটিকে সংজ্ঞায়িত করে ভিডিওটি শেষ পর্যন্ত দেখা দর্শকদের শতাংশ হিসেবে।

আমার TikTok ভিডিওর রিচ ও দেখার সময় খালি কেন?

শেষ 7 দিনে কোনো ভিউ, লাইক, কমেন্ট বা শেয়ার না থাকলে TikTok এগুলো বাদ দিতে পারে, আর সাম্প্রতিক ডেটা 24 থেকে 48 ঘণ্টা পিছিয়ে থাকে।

API কি একটি নির্দিষ্ট TikTok ভিডিওর মেট্রিক ফেরত দিতে পারে?

হ্যাঁ। এর ID filters.video_ids-এ দিন, সঙ্গে item_id ও যে মেট্রিক চান তা fields-এ।

আরও পড়ুন

API-এর মাধ্যমে TikTok-এর দর্শক ডেমোগ্রাফিক্সTikTok-এর API for Business যে ফলোয়ারদের বয়স, লিঙ্গ, দেশ, শহর ও ঘণ্টাভিত্তিক সক্রিয়তা দেয়, এবং 100-ফলোয়ারের নিয়ম।API দিয়ে TikTok অ্যাকাউন্টের ভিডিও তালিকাভুক্ত করাTikTok-এর API for Business কীভাবে অ্যাকাউন্টের পোস্ট তালিকাভুক্ত করে: /business/video/list/, ফিল্ড, কার্সর পেজিনেশন, প্রতি পেজে 20টি এবং ID দিয়ে ফিল্টার।TikTok অ্যানালিটিক্স API: অ্যাকাউন্টের ইনসাইট ও ভিডিও মেট্রিক্সTikTok API for Business থেকে পাওয়া মেট্রিক্স: অ্যাকাউন্টের ফলোয়ার, ভিউ ও লাইক দৈনিক হিসাবে, এবং প্রতি ভিডিওর ভিউ, লাইক, কমেন্ট ও শেয়ার।TikTok API for Business-এর স্কোপ: প্রতিটি অনুমতি কী খুলে দেয়TikTok Accounts API-এর অনুমতি, TikTok-এর নিজের নামে: প্রতিটি কী খুলে দেয়, প্রতি ফিল্ডের টোকেন স্কোপ এবং টোকেন যাচাইয়ের উপায়।কীভাবে API-এর মাধ্যমে TikTok-এ ভিডিও পোস্ট করবেনAPI for Business দিয়ে TikTok-এ ভিডিও পোস্ট করুন: প্রকাশ এন্ডপয়েন্ট, JSON বডি, share_id এবং স্ট্যাটাস কল, curl ও Python-এ।

দুই মিনিটে আপনার প্রথম চ্যানেল সংযুক্ত করুন।

প্ল্যাটফর্মের রিভিউয়ের জন্য অপেক্ষা করতে হবে না। WhatsApp, Instagram, TikTok বা অন্য কোনো চ্যানেল সংযুক্ত করুন, তারপর আপনার AI-কে পোস্ট করতে, রিপ্লাই দিতে বা রিপোর্ট দিতে বলুন, আর নিজের চোখে দেখুন কীভাবে কাজ করে।

  • 3 দিন ফ্রি
  • যেকোনো সময় বাতিল করুন
  • শুধুমাত্র অফিশিয়াল API
  • 24/7 পর্যবেক্ষণ

যাচাই করা হয়েছে