API کے ذریعے TikTok فالوورز کی ڈیموگرافکس
TikTok کی API for Business GET /business/get/ سے کسی TikTok اکاؤنٹ کے فالوورز کی ڈیموگرافکس واپس کرتی ہے: audience_ages، audience_genders، audience_countries اور audience_cities، ہر ایک فالوورز کے حصوں کی فہرست کے طور پر، ان اکاؤنٹس کے لیے جن کے کم از کم 100 فالوورز ہوں۔ ہر دن کے metrics میں audience_activity کے طور پر ہر گھنٹے کی فالوورز کی سرگرمی آتی ہے، ان اکاؤنٹس کے لیے جن کے پاس 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: ہر دن کے لیے، ہر گھنٹے میں TikTok پر فعال فالوورز، hour اور count کی صورت میں۔
ان کی درخواست کیسے کریں؟
fields میں فیلڈ کے نام JSON array کی صورت میں دیں، اور 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'جواب کیسا دکھتا ہے؟
ہر تقسیم ایسے objects کی فہرست ہے جو ایک گروپ کو اس کے حصے کے ساتھ جوڑتی ہے، اور 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 مجھے میرے فالوورز کی عمر اور جنس دکھا سکتی ہے؟
ہاں۔ GET /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 نگرانی
تصدیق شدہ تاریخ