API-এর মাধ্যমে TikTok-এর দর্শক ডেমোগ্রাফিক্স
TikTok-এর API for Business GET /business/get/ থেকে একটি TikTok অ্যাকাউন্টের ফলোয়ারদের ডেমোগ্রাফিক্স ফেরত দেয়: audience_ages, audience_genders, audience_countries ও audience_cities, যার প্রতিটি ফলোয়ারের অংশের একটি তালিকা, অন্তত 100 ফলোয়ারওয়ালা অ্যাকাউন্টের জন্য। প্রতি ঘণ্টায় ফলোয়ারদের সক্রিয়তা আসে audience_activity হিসেবে, প্রতিদিনের metrics-এ, যেসব অ্যাকাউন্টের Advanced Access বা Verified Business Accounts আছে এবং একই 100 ফলোয়ার আছে তাদের জন্য। সবগুলোর জন্য টোকেনে user.insights স্কোপ লাগে।
easyCoexistence Claude, ChatGPT বা নিজের কোড থেকে get_social_insights দিয়ে একটি TikTok অ্যাকাউন্টের ফলোয়ার ডেমোগ্রাফিক্স পড়ে: audience_ages, audience_genders, audience_countries, audience_cities বা audience_activity চান, আর এটি TikTok-এর তালিকাগুলো যেমন আছে তেমনই ফেরত দেয়।
TikTok বয়স, লিঙ্গ, দেশ ও শহরের বিভাজন ফেরত দেওয়ার আগে একটি অ্যাকাউন্টের যত ফলোয়ার থাকা দরকার।
audience_ages-এর বয়সের গ্রুপ: 18-24, 25-34, 35-44, 45-54 ও 55+।
audience_activity-এর সময় অঞ্চল, অর্থাৎ TikTok-এ সক্রিয় ফলোয়ারদের ঘণ্টাওয়ারি সংখ্যা।
audience_countries, audience_genders ও audience_activity-এর সাধারণ বিলম্ব, যা TikTok অফলাইনে গণনা করে।
কোন ডেমোগ্রাফিক্স অ্যাকাউন্ট এন্ডপয়েন্ট ফেরত দেয়?
GET /business/get/ এগুলো ফেরত দেয় যখন fields-এ এদের নাম দেওয়া হয়। চারটি বিভাজন data-এর শীর্ষে থাকে, প্রতি মাত্রার জন্য একটি তালিকা, আর ঘণ্টাভিত্তিক সক্রিয়তা থাকে metrics-এ, প্রতিদিনের জন্য এক সেট করে:
audience_ages: প্রতিটি বয়স গ্রুপে ফলোয়ারদের অংশ, 18-24, 25-34, 35-44, 45-54 ও 55+।audience_genders: লিঙ্গ অনুযায়ী ফলোয়ারদের অংশ: Female, Male বা Other।audience_countries: প্রতি দেশ বা অঞ্চলে ফলোয়ারদের অংশ, ISO 3166-1 alpha-2 কোডে।audience_cities: প্রতি শহরে ফলোয়ারদের অংশ,city_nameঅনুযায়ী।audience_activity: প্রতিদিন, প্রতি ঘণ্টায় সক্রিয় ফলোয়ারদের সংখ্যা, hour ও count হিসেবে।
কীভাবে এগুলো অনুরোধ করবেন?
fields-এ ফিল্ডের নামগুলো দিয়ে, একটি JSON অ্যারে হিসেবে, আর audience_activity আছে এমন প্রতিদিনের metrics-এর জন্য UTC-তে একটি তারিখের পরিসর। start_date ও end_date সর্বোচ্চ 60 দিন পিছনে যেতে পারে, আর এগুলো না দিলে TikTok অনুরোধের আগের দিন পর্যন্ত 7 দিন ফেরত দেয়:
curl -G 'https://business-api.tiktok.com/open_api/v1.3/business/get/' \
-H 'Access-Token: <ACCESS_TOKEN>' \
--data-urlencode 'business_id=<OPEN_ID>' \
--data-urlencode 'fields=["audience_ages","audience_genders","audience_countries","audience_cities","audience_activity"]' \
--data-urlencode 'start_date=2026-10-24' \
--data-urlencode 'end_date=2026-10-30'উত্তরটি কেমন দেখায়?
প্রতিটি বিভাজন এমন বস্তুর একটি তালিকা, যেখানে একটি গ্রুপকে তার শতাংশের সঙ্গে জোড়া দেওয়া হয়। metrics-এর প্রতিটি দিনে তার তারিখ এবং ঘণ্টার একটি audience_activity তালিকা থাকে। নিচের মানগুলো TikTok-এর নিজের উদাহরণ, যেখানে লিঙ্গের তালিকা ও কয়েকটি ঘণ্টা ছোট করা হয়েছে:
{
"code": 0,
"message": "OK",
"request_id": "<REQUEST_ID>",
"data": {
"audience_genders": [
{ "gender": "Female", "percentage": 0.7554470336505679 },
{ "gender": "Male", "percentage": 0.24455296634943213 }
],
"metrics": [
{
"date": "<DATE>",
"audience_activity": [
{ "hour": "20", "count": 1 },
{ "hour": "23", "count": 4 },
{ "hour": "7", "count": 4 }
]
}
]
}
}কোন অ্যাকাউন্ট কোন বিভাজন পায়?
বয়স, লিঙ্গ, দেশ ও শহরের অংশ আসে যখন অ্যাকাউন্টের অন্তত 100 ফলোয়ার থাকে; 13 ফলোয়ারের একটি অ্যাকাউন্টের জন্য TikTok-এর নিজের উদাহরণে এসব তালিকা খালি আসে। audience_activity-এরও 100 ফলোয়ার লাগে, এর ওপর আরও লাগে Advanced Access, যা একটি TikTok for Business অ্যাকাউন্টের সঙ্গে সংযুক্ত করলে বা যাচাই ছাড়া Business Center-এর মাধ্যমে আসে, অথবা একটি Verified Business Account। এই প্রতিটি ফিল্ডের জন্য টোকেনে user.insights স্কোপ লাগে।
ডেমোগ্রাফিক্স কতটা তাজা?
এক বা দুই দিন পিছিয়ে। TikTok audience_countries, audience_genders ও audience_activity-কে সেই ফিল্ডের তালিকায় রাখে যেগুলো সাধারণত 24 থেকে 48 ঘণ্টা পিছিয়ে থাকে, UTC-তে, এবং বয়স ও শহরের জন্যও একই আপডেটের সময় দেয়। তথ্যগুলো আসে TikTok Analytics থেকে, যা মালিক প্রথম ভিডিও প্রকাশের পর অ্যাপে চালু করেন, আর তার আগের ডেটা পাওয়া যায় না। TikTok ডেমোগ্রাফিক্স বেশ কয়েকটি উপাদানের ভিত্তিতে নির্ধারণ করে, যার মধ্যে ব্যবহারকারীরা তাদের প্রোফাইলে কী দিয়েছেন তাও আছে।
ফলোয়ারদের ডেমোগ্রাফিক্স একটি ভিডিওর দর্শকদের থেকে কীভাবে আলাদা?
এগুলো আলাদা মানুষকে বোঝায়। অ্যাকাউন্টের তালিকাগুলো ফলোয়ারদের নিয়ে। /business/video/list/ একটি পোস্ট যারা দেখেছে তাদের বিভাজন ফেরত দেয়: audience_genders, audience_countries ও audience_cities, প্রতিটিতে সর্বোচ্চ 10টি করে আইটেম, এবং audience_types, যা দর্শকদের ভাগ করে নতুন ও ফিরে আসা, ফলোয়ার ও নন-ফলোয়ার। এগুলোর জন্য user.insights-এর বদলে video.insights স্কোপ লাগে।
easyCoexistence এগুলো কীভাবে পড়ে?
অ্যাকাউন্টের উপর get_social_insights দিয়ে: object_id বাদ দিন, ফিল্ডের নামগুলো metrics হিসেবে তালিকাভুক্ত করুন, আর নির্দিষ্ট দিনের audience_activity চাইলে params-এ start_date ও end_date দিন। এটি TikTok-এর তালিকাগুলো যেমন আছে তেমনই ফেরত দেয়, তাই অংশ ও ঘণ্টাগুলো ঠিক উপরে যেভাবে লেখা আছে সেভাবেই পড়া যায়।
get_social_insights {
"account_id": "<ACCOUNT_ID>",
"metrics": ["audience_ages", "audience_genders", "audience_countries", "audience_cities", "audience_activity"],
"params": { "start_date": "2026-10-24", "end_date": "2026-10-30" }
}সাধারণ ভুলগুলো
- ছোট অ্যাকাউন্ট থেকে বিভাজন আশা করা। TikTok 100 ফলোয়ার থেকে বয়স, লিঙ্গ, দেশ ও শহরের অংশ ফেরত দেয়, আর 13 ফলোয়ারের অ্যাকাউন্টের উদাহরণে তালিকাগুলো খালি দেখায়।
- audience_activity-এর ঘণ্টাকে স্থানীয় সময় ধরা। TikTok এগুলো UTC+0-তে জানায়, তাই পোস্ট পরিকল্পনার আগে দর্শকের টাইম জোনে সেগুলো সরিয়ে নিন।
- ফলোয়ারের ডেমোগ্রাফিক্সকে দর্শকের ডেমোগ্রাফিক্স ধরা। অ্যাকাউন্টের তালিকাগুলো ফলোয়ারদের বর্ণনা করে; একটি ভিডিওর audience_countries বর্ণনা করে যারা সেটি দেখেছে তাদের।
- ব্যক্তিগত অ্যাকাউন্টে audience_activity আশা করা। TikTok এটি ফেরত দেয় শুধু সেই অ্যাকাউন্টের জন্য যাদের Advanced Access বা Verified Business Accounts আছে এবং অন্তত 100 ফলোয়ার রয়েছে।
প্রতি সংযোগে প্রতি মাসে US$ 9 থেকে US$ 0.75, সংযোগ যোগ করার সঙ্গে কমে, প্রথম 3 দিন ফ্রি ট্রায়াল।
প্রায়শই জিজ্ঞাসিত প্রশ্ন
TikTok API কি আমার ফলোয়ারদের বয়স ও লিঙ্গ দেখাতে পারে?
হ্যাঁ। /business/get/ audience_ages ও audience_genders ফেরত দেয়, প্রতি গ্রুপে ফলোয়ারদের অংশ হিসেবে, যখন অ্যাকাউন্টের অন্তত 100 ফলোয়ার থাকে এবং টোকেনে user.insights থাকে।
TikTok API কোন বয়সের গ্রুপ ব্যবহার করে?
18-24, 25-34, 35-44, 45-54 ও 55+, প্রতিটিতে তার মধ্যে ফলোয়ারদের অংশ সহ।
TikTok API কি বলে আমার ফলোয়াররা কখন অনলাইন থাকে?
audience_activity প্রতি ঘণ্টায় TikTok-এ সক্রিয় ফলোয়ারদের সংখ্যা দেয়, UTC+0-তে, প্রতিদিনের metrics-এর ভেতরে, Advanced Access বা Verified Business Accounts এবং 100 বা তার বেশি ফলোয়ারওয়ালা অ্যাকাউন্টের জন্য।
TikTok API কীভাবে ফলোয়ারদের দেশ দেয়?
audience_countries-এ ISO 3166-1 alpha-2 দেশ বা অঞ্চলের কোড হিসেবে, প্রতিটির সঙ্গে সেখান থেকে আসা ফলোয়ারদের অংশ।
আরও পড়ুন
দুই মিনিটে আপনার প্রথম চ্যানেল সংযুক্ত করুন।
প্ল্যাটফর্মের রিভিউয়ের জন্য অপেক্ষা করতে হবে না। WhatsApp, Instagram, TikTok বা অন্য কোনো চ্যানেল সংযুক্ত করুন, তারপর আপনার AI-কে পোস্ট করতে, রিপ্লাই দিতে বা রিপোর্ট দিতে বলুন, আর নিজের চোখে দেখুন কীভাবে কাজ করে।
- 3 দিন ফ্রি
- যেকোনো সময় বাতিল করুন
- শুধুমাত্র অফিশিয়াল API
- 24/7 পর্যবেক্ষণ
যাচাই করা হয়েছে