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

واجهة TikTok Analytics API: مؤشرات الحساب ومقاييس الفيديو

تعيد واجهة برمجة API الخاصة بالأعمال من TikTok مقاييس الحساب يومًا بيوم، مثل المتابعين ومشاهدات الفيديو ومشاهدات الملف الشخصي والإعجابات والتعليقات والمشاركات، لآخر 60 يومًا كحد أقصى. وتعيد لكل فيديو أرقامه التراكمية منذ نشره، مثل المشاهدات والإعجابات والتعليقات والمشاركات. تصل معظم الأرقام متأخرة من 24 إلى 48 ساعة، وتعتمد على تفعيل TikTok Analytics في التطبيق.

يقرأ easyCoexistence مؤشرات TikTok عبر get_social_insights من Claude أو ChatGPT أو من كودك الخاص: متابعو الحساب ومشاهداته وإعجاباته يومًا بيوم، أو مشاهدات فيديو وإعجاباته وتعليقاته ومشاركاته.

60 days

أطول فترة رجوع للخلف لمقاييس الحساب اليومية؛ وبدون تواريخ تعيد الواجهة آخر 7 أيام.

24 to 48 h

التأخير المعتاد قبل توفر المقاييس اليومية وأرقام كل منشور مثل الإعجابات والمشاهدات والمشاركات.

365 days

المدة بعد النشر التي تتوقف بعدها بيانات المنشور عن التحديث.

100

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

ما مقاييس الحساب المتوفرة؟

تعيد GET /business/get/ ملف الحساب، وقائمة مقاييس تتضمن إدخالًا لكل يوم في الفترة المطلوبة، بالتوقيت العالمي المنسق (UTC) وفق التالي:

  • followers_count: الإجمالي الحالي، والإجمالي في كل يوم.
  • video_views، profile_views، likes، comments، shares: أرقام يومية عبر فيديوهات الحساب.
  • unique_video_views، daily_new_followers، daily_lost_followers، engaged_audience: يومية، لحسابات Advanced Access أو حسابات الأعمال الموثّقة.
  • audience_ages، audience_genders، audience_countries، audience_cities: تفصيل للمتابعين، لحسابات تضم 100 متابع على الأقل.

ما مقاييس الفيديو المتوفرة؟

تعيد GET /business/video/list/ منشورات الحساب العامة مع أرقامها التراكمية، دون التقيد بنافذة الـ 60 يومًا: video_views، likes، comments، shares، favorites، إضافة إلى الوصول ومدة المشاهدة الإجمالية والمتوسطة ونسبة المشاهدة الكاملة والمتابعين الجدد ومصادر الزيارة. تعيد حتى 20 منشورًا في الصفحة الواحدة، ويحدد filters.video_ids منشورات بعينها.

ما مدى حداثة البيانات؟

تكون حقول الملف الشخصي، مثل اسم المستخدم وإجمالي المتابعين الحالي، فورية. أما المقاييس اليومية للحساب وأرقام المنشورات، مثل المشاهدات والإعجابات والتعليقات والمشاركات، فتتأخر عادة من 24 إلى 48 ساعة بالتوقيت العالمي (UTC)، ويتوقف تحديث بيانات المنشور بعد 365 يومًا من نشره. وقد تغيب مقاييس الوصول ومدة المشاهدة ومصادر الزيارة عن فيديو لم يحظ بمشاهدة أو إعجاب أو تعليق أو مشاركة منذ أكثر من 7 أيام.

لماذا قد تغيب المقاييس؟

تعيد الواجهة ما تملكه TikTok Analytics. يجب أن ينشر صاحب الحساب فيديو واحدًا على الأقل وأن يفعّل Analytics في تطبيق TikTok، ولا تتوفر البيانات التي سبقت تفعيله. وتحتاج بعض المقاييس إلى شروط أكثر: يأتي الوصول إلى الجمهور والمتابعون الجدد والمفقودون فقط للحسابات التي تملك Advanced Access أو حسابات الأعمال الموثّقة، وتبدأ تفاصيل المتابعين من 100 متابع.

لماذا قد تختلف الأرقام عن تطبيق TikTok؟

بسبب ما تشمله. تجمع video_views المشاهدات العضوية والمدفوعة معًا، وتحسب shares المشاركات خارج TikTok والإرسال إلى الأصدقاء داخل التطبيق، لذلك قد يظهر الرقم أعلى من عدد المشاركات على موقع TikTok. ولا يخصم رقم الإعجابات اليومي الإعجابات التي سُحبت لاحقًا.

كيف يقرأها easyCoexistence؟

عبر get_social_insights. بالنسبة للحساب، اطلب مقاييس مثل followers_count، video_views، likes، مع تاريخي البداية والنهاية (start_date و end_date)، فيعيد صفوف TikTok اليومية. ولفيديو واحد، مرّر item_id في object_id فيعيد المشاهدات والإعجابات والتعليقات والمشاركات، ويبحث بين آخر 20 فيديو للحساب. أما الفيديو الأقدم، فيستدعي كودك الخاص المسار business/video/list/ مع filters.video_ids، مستخدمًا الرمز من get_social_credentials.

الأخطاء الشائعة

  • اعتبار أرقام الأمس نهائية. قد تتأخر المقاييس اليومية من 24 إلى 48 ساعة، لذا قد تكون الأيام الأخيرة ما زالت تكتمل.
  • طلب أكثر من 60 يومًا من مقاييس الحساب. تتوقف نافذة الرجوع عند هذا الحد، لذا احفظ الأرقام إن احتجت إلى سجل أطول.
  • البحث عن فيديو قديم بـ object_id. يبحث get_social_insights في آخر 20 فيديو فقط، وللمنشورات الأقدم صفِّ النتائج بـ video_ids من كودك الخاص، بالرمز من get_social_credentials.
  • مقارنة مشاركات الواجهة بعدد موقع TikTok. تحسب الواجهة الإرسال إلى الأصدقاء داخل TikTok أيضًا، لذلك يكون رقمها أعلى.
إنجاز ذلك باستخدام EasyCoexistence

أما لحقول مؤشرات TikTok الأخرى، فيمنح get_social_credentials كودك الخاص رمز الحساب. من US$ 9 إلى US$ 0.75 لكل اتصال شهريًا، ويقل السعر كلما أضفت اتصالات، مع فترة تجريبية مجانية مدتها 3 أيام.

الأسئلة الشائعة

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

نعم، كحقل daily_lost_followers إلى جانب daily_new_followers، للحسابات التي تملك Advanced Access أو حسابات الأعمال الموثّقة.

إلى أي مدى تمتد مؤشرات حساب TikTok؟

60 يومًا. وبدون تواريخ تعيد الواجهة آخر 7 أيام حتى اليوم السابق للطلب، بالتوقيت العالمي (UTC).

متى تتوقف بيانات فيديو TikTok عن التحديث؟

بعد 365 يومًا من نشر الفيديو. وحتى ذلك الحين تستمر أرقامه التراكمية في التحديث، وعادة بتأخر من 24 إلى 48 ساعة.

هل تشمل مشاهدات فيديو TikTok المشاهدات المدفوعة؟

نعم. يجمع الرقم video_views الذي تعيده TikTok النشاط العضوي والمدفوع معًا.

تابع القراءة

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

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

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

تم التحقق في