تسجيل الدخولابدأ الفترة التجريبية المجانية
easyCoexistence واجهات API الرسمية

ديموغرافيا الجمهور في TikTok عبر واجهة برمجة التطبيقات (API)

تعيد واجهة TikTok للأعمال ديموغرافيا متابعي الحساب من GET /business/get/: audience_ages وaudience_genders وaudience_countries وaudience_cities، وكلها قوائم بنِسَب المتابعين، وذلك للحسابات التي لديها 100 متابع على الأقل. ويأتي النشاط الساعي للمتابعين باسم audience_activity ضمن مقاييس كل يوم، للحسابات ذات الوصول المتقدم أو حسابات الأعمال الموثّقة وبالشرط نفسه من 100 متابع. وتحتاج كل هذه الحقول إلى النطاق user.insights.

يقرأ easyCoexistence ديموغرافيا متابعي حساب TikTok عبر get_social_insights من Claude أو ChatGPT أو من كودك الخاص: اطلب audience_ages أو audience_genders أو audience_countries أو audience_cities أو audience_activity، فيعيد القوائم كما هي من TikTok.

100

عدد المتابعين الذي يحتاجه الحساب قبل أن يعيد TikTok تفصيلات العمر والجنس والدولة والمدينة.

5 groups

فئات العمر في audience_ages: 18-24 و25-34 و35-44 و45-54 و55+.

UTC+0

المنطقة الزمنية لـ audience_activity، وهو عدد المتابعين النشطين على TikTok في كل ساعة.

24 to 48 h

التأخير المعتاد لـ audience_countries وaudience_genders وaudience_activity، وهي حقول يحسبها TikTok دون اتصال.

أي ديموغرافيا تعيدها نقطة النهاية (endpoint) الخاصة بالحساب؟

يعيدها 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، ونطاق تاريخ بالتوقيت العالمي UTC للمقاييس اليومية التي تحمل audience_activity. يمكن أن يمتد start_date وend_date إلى 60 يوماً إلى الخلف، وفي غيابهما يعيد TikTok آخر 7 أيام حتى اليوم السابق للطلب:

Follower demographics for a TikTok account
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 نفسه، مختصرة إلى قائمة الجنس وبضع ساعات:

Demographics in the /business/get/ response
{
  "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 متابع على الأقل، ومثال TikTok لحساب من 13 متابعاً يعيد هذه القوائم فارغة. ويحتاج audience_activity أيضاً إلى 100 متابع، وفوق ذلك حساب ذو وصول متقدم، وهو ما يأتي من ربطه بحساب TikTok للأعمال أو بمركز أعمال غير موثّق في TikTok، أو من حساب أعمال موثّق. وتحتاج كل هذه الحقول إلى النطاق user.insights على رمز الوصول (token).

ما مدى حداثة الديموغرافيا؟

متأخرة بيوم أو يومين. يدرج TikTok audience_countries وaudience_genders وaudience_activity ضمن الحقول التي تتأخر عادةً من 24 إلى 48 ساعة، بالتوقيت العالمي UTC، ويعطي موعد التحديث نفسه للعمر والمدن. وتأتي الأرقام من تحليلات TikTok، التي يفعّلها مالك الحساب في التطبيق بعد نشر أول فيديو، ولا تتوفر بيانات قبل ذلك. ويبني TikTok الديموغرافيا على عدة عوامل، منها ما يضعه المستخدمون في ملفاتهم الشخصية.

كيف تختلف ديموغرافيا المتابعين عن ديموغرافيا مشاهدي الفيديو؟

إنهما يصفان أشخاصاً مختلفين. تغطي قوائم الحساب المتابعين، بينما تعيد /business/video/list/ تفصيلات من شاهدوا منشوراً واحداً: audience_genders وaudience_countries وaudience_cities بحد أقصى 10 عناصر لكل منها، وaudience_types الذي يقسم المشاهدين إلى جدد وعائدين، ومتابعين وغير متابعين. وتحتاج هذه إلى النطاق video.insights بدلاً من user.insights.

كيف يقرأها easyCoexistence؟

بواسطة get_social_insights على الحساب: احذف object_id، واذكر أسماء الحقول في metrics، ومرّر start_date وend_date في params متى أردت audience_activity لأيام بعينها. ويعيد القوائم كما هي من TikTok، فتُقرأ النسب والساعات تماماً كما ورد أعلاه.

Follower demographics through MCP
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 للحسابات ذات الوصول المتقدم أو حسابات الأعمال الموثّقة التي لديها 100 متابع على الأقل.
إنجاز ذلك باستخدام EasyCoexistence

من 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، ضمن مقاييس كل يوم، للحسابات ذات الوصول المتقدم أو حسابات الأعمال الموثّقة التي لديها 100 متابع أو أكثر.

كيف تعطي واجهة TikTok API دول المتابعين؟

في audience_countries على هيئة رموز الدول أو المناطق وفق ISO 3166-1 alpha-2، ولكل دولة نسبة المتابعين القادمين منها.

تابع القراءة

مقاييس فيديو TikTok عبر واجهة برمجة التطبيقات (API): المشاهدات ووقت المشاهدة والإكمالمقاييس كل فيديو تعيدها واجهة TikTok للأعمال: المشاهدات والوصول ووقت المشاهدة ونسبة الإكمال والاحتفاظ ومصادر الظهور وبلدان المشاهدين.واجهة TikTok Analytics API: مؤشرات الحساب ومقاييس الفيديومقاييس TikTok التي تعيدها واجهة API الخاصة بالأعمال: المتابعون والمشاهدات والإعجابات يوميًا للحساب، والمشاهدات والإعجابات والتعليقات والمشاركات لكل فيديو.نطاقات TikTok API for Business: ما يفتحه كل إذنالأذونات التي تعمل بها TikTok Accounts API بأسمائها الرسمية: ما تفتحه كل منها، ونطاقات الرمز لكل حقل، وكيفية التحقق من الرمز.عرض فيديوهات حساب TikTok عبر واجهة برمجة التطبيقات (API)كيف تعرض واجهة TikTok للأعمال منشورات الحساب عبر /business/video/list/، مع حقوله والتصفح بالمؤشر و20 منشورا في الصفحة والتصفية بالمعرّف.TikTok API for Business مقابل Content Posting APIلماذا TikTok API for Business بدلًا من developers.tiktok.com: التعليقات والتحليلات وتجديد رموز الوصول.

اربط قناتك الأولى في دقيقتين.

لا حاجة لانتظار مراجعات المنصات. اربط WhatsApp أو Instagram أو TikTok أو أي قناة أخرى، ثم اطلب من الذكاء الاصطناعي النشر أو الرد أو إعداد التقارير، وشاهده يعمل.

  • 3 أيام مجانًا
  • إلغاء في أي وقت
  • واجهات API الرسمية فقط
  • مراقبة على مدار الساعة 24/7

تم التحقق في