حد Events API في TikTok: 1,000 طلب/ث (2026)
آخر تحقق في · المصادر مذكورة في أسفل هذه الصفحة
يحدّ TikTok معدل الطلبات لكل نقطة نهاية على حدة، ضمن نافذة منزلقة مدتها دقيقة واحدة. تسمح نقطة Direct Post بـ 6 طلبات في الدقيقة لكل رمز وصول مستخدم، وQuery Creator Info بـ 20، وGet Post Status بـ 30، ونقاط قراءة المستخدم والفيديو (/v2/user/info/، /v2/video/query/، /v2/video/list/) بـ 600 لكل منها. تجاوز الحد يعيد HTTP 429 مع رمز الخطأ rate_limit_exceeded. أما Events API فنظام منفصل على مضيف منفصل: 1,000 طلب في الثانية، بالرقم نفسه في كل مستويات التطبيقات، ويجيب بالرمز 40100 عند التقييد.
ما حد معدل الطلبات لكل نقطة نهاية في واجهة TikTok البرمجية؟
تُحدَّد الحدود وتُطبَّق لكل نقطة نهاية، لا كميزانية واحدة مشتركة. استنفاد Direct Post لا يبطئ Get Post Status، والعكس صحيح.
| نقطة النهاية | الحد | ماذا يعني عمليًا |
|---|---|---|
| Direct Post (/v2/post/publish/video/init/) | 6 طلبات / دقيقة لكل رمز وصول مستخدم | الحد الحاسم لكل من ينشر على عدة حسابات. إنه لكل رمز، أي لكل حساب متصل — عشرة حسابات لا تتقاسم ستة طلبات، بل لكل منها ستة. |
| Query Creator Info | 20 طلبًا / دقيقة لكل رمز وصول مستخدم | يُستدعى قبل كل منشور، لأن واجهة النشر يجب أن تعرض خيارات الخصوصية الحقيقية لصانع المحتوى. لهذا يكلّف مسار النشر استدعاءين على الأقل لا استدعاءً واحدًا. |
| Get Post Status | 30 طلبًا / دقيقة لكل رمز وصول مستخدم | الاستطلاع الدوري. ثلاثون في الدقيقة تبدو سخية حتى تستطلع عشرة حسابات كل ثانيتين — فذلك 300. |
| /v2/user/info/ | 600 طلب / دقيقة | قراءة الملفات الشخصية. |
| /v2/video/query/ | 600 طلب / دقيقة | مقاييس فيديوهات بعينها. |
| /v2/video/list/ | 600 طلب / دقيقة | قائمة مقسّمة إلى صفحات لفيديوهات صانع المحتوى. |
كيف تُحسب النافذة، وماذا يحدث عند تجاوزها؟
يستخدم الحساب نافذة منزلقة مدتها دقيقة واحدة، لا دقيقة ثابتة على الساعة. دفعة من ستة منشورات عند 10:00:59 لا تُصفَّر عند 10:01:00 — بل يستمر العدّ حتى 10:01:59.
فوق العتبة، تجيب الواجهة البرمجية بـ HTTP 429 مع رمز الخطأ rate_limit_exceeded. يذكر TikTok أن الحدود يمكن رفعها بطلب عبر صفحة الدعم، ويُدرس كل طلب على حدة.
النتيجة العملية لمن ينشر على عدة حسابات: إعادة المحاولة بعد 429 يجب أن تتراجع وتنتظر، لا أن تكرر فورًا. إعادة المحاولة الفورية تمدّد النافذة التي تحاول الإفلات منها.
ما حد معدل الطلبات في Events API لدى TikTok، بالطلبات في الثانية؟
ألف في الثانية، وهو الرقم نفسه لكل تطبيقات المطوّرين — هذا هو الموضع الوحيد الذي لا يطلب منك فيه TikTok التقدّم للحصول على المزيد.
هذه واجهة برمجية مختلفة عن كل نقاط النهاية أعلاه، وهنا يقع كثيرون في الخطأ. نقاط Content Posting موجودة على developers.tiktok.com وتُحتسب بالدقيقة، لكل رمز وصول مستخدم. أما Events API فجزء من Marketing API على business-api.tiktok.com، وتُحتسب بـ QPS وQPM وQPD مقابل تطبيقك المطوَّر. مضيفان، ونظامان، ورمزا خطأ: تجيب Marketing API بـ "code": 40100 حيث تجيب واجهة المطوّرين بـ HTTP 429.
يقع تطبيقك أيضًا في أحد أربعة مستويات عامة — Basic بـ 10 QPS، وAdvanced بـ 20، وPremium بـ 30، وUltimate بـ 50، وكل تطبيق يبدأ في Basic. نقاط Events مستثناة صراحةً من هذا السلّم: يذكر TikTok أنك لا تحتاج إلى طلب تغيير مستوى حد المعدل لـ Events API، لأن الحد واحد في كل المستويات. إذن الـ 1,000 QPS أدناه هي ما يحصل عليه تطبيق جديد تمامًا منذ يومه الأول.
| نقطة النهاية | الحد | ماذا يعني عمليًا |
|---|---|---|
| Web Events (/pixel/track/) و/pixel/batch/ | 1,000 / ثانية · 600,000 / دقيقة · 86,400,000 / يوم | تحويلات الويب من المتصفح ومن جهة الخادم. الرقم اليومي هو بالضبط 1,000 × 86,400، لذا فالحد في الثانية هو الوحيد الذي يمكنك بلوغه واقعيًا. |
| App Events (/app/track/) و/app/batch/ | 1,000 / ثانية · 600,000 / دقيقة · 86,400,000 / يوم | تحويلات تطبيقات الجوال. |
| Offline Events (/offline/track/) و/offline/batch/ | 1,000 / ثانية · 600,000 / دقيقة · 86,400,000 / يوم | تحويلات المتاجر الفعلية وCRM المُرسلة بعد وقوعها. |
| /event/track/ | 1,000 / ثانية · 600,000 / دقيقة · 86,400,000 / يوم | نقطة نهاية Events API 2.0. |
| Streaming API | 10,000 / ثانية في Basic، حتى 50,000 في Ultimate | الحد الوحيد في جانب الأحداث الذي يتبع سلّم المستويات فعلًا. |
لماذا لا يستغرق النشر على عشرة حسابات وقتًا أطول بعشر مرات؟
لأن كل حد أعلاه مرتبط برمز وصول مستخدم، والرمز الواحد يساوي حسابًا متصلًا واحدًا. عشرة حسابات تعني عشر حصص مستقلة من ستة منشورات في الدقيقة.
ما يتسلسل فعلًا هو بنيتك التحتية: ملف فيديو واحد يُرفع عشر مرات يعني عشر عمليات نقل. الحد الذي يضرب أولًا ليس حد TikTok في الغالب، بل عرض النطاق.
الأسئلة الشائعة
- هل حدود واجهة TikTok البرمجية لكل تطبيق أم لكل مستخدم؟
- نقاط Content Posting موثّقة لكل رمز وصول مستخدم — أي لكل حساب متصل. لا ينشر TikTok سقفًا منفصلًا على مستوى التطبيق لهذه النقاط، ويذكر أن الحدود تُحدَّد وتُطبَّق بشكل منفصل لكل واجهة.
- ما الخطأ الذي يعيده TikTok عند تجاوز حد المعدل؟
- رمز الحالة HTTP 429، مع رمز الخطأ rate_limit_exceeded في جسم الاستجابة.
- هل يمكن رفع حدود واجهة TikTok البرمجية؟
- نعم. تذكر وثائق TikTok أنه يمكن طلب حدود أعلى عبر صفحة الدعم، وأن كل طلب يُدرس.
- ما حد معدل Events API في TikTok في الثانية؟
- 1,000 طلب في الثانية، و600,000 في الدقيقة، و86,400,000 في اليوم، لكلٍّ من /event/track/ وWeb Events وApp Events وOffline Events. يطبّق TikTok الرقم نفسه في مستويات التطبيقات الأربعة، ويذكر أنك لا تحتاج إلى طلب زيادة لـ Events API.
- هل حد Events API هو نفسه حد Content Posting API؟
- لا، بل إنهما ليسا النظام نفسه أصلًا. Content Posting موثّقة على developers.tiktok.com، وتُحتسب بالدقيقة مقابل رمز وصول مستخدم، وتجيب بـ HTTP 429 مع rate_limit_exceeded. أما Events API فتتبع Marketing API على business-api.tiktok.com، وتُحتسب بالطلبات في الثانية والدقيقة واليوم مقابل تطبيقك المطوَّر، وتجيب بالرمز 40100.
- كم فيديو TikTok يمكنني نشره في الدقيقة عبر الواجهة البرمجية؟
- ستة لكل حساب متصل، لأن نقطة Direct Post تسمح بـ 6 طلبات في الدقيقة لكل رمز وصول مستخدم. على عشرة حسابات متصلة يصبح العدد ستين، لأن لكل حساب حدّه الخاص.
المصادر
- TikTok for Developers — Rate Limits on API Requests — رُوجع في .
- TikTok API for Business — Rate limits (Marketing API, incl. Events API) — رُوجع في .
- TikTok for Developers — Content Posting API, Direct Post — رُوجع في .
- TikTok for Developers — Query Creator Info — رُوجع في .
هذه الأرقام مأخوذة من وثائق شركة أخرى، وقد تتغيّر دون إشعار، ولا شيء هنا يتحقق منها تلقائيًا. لهذا يحمل كل مصدر تاريخ مراجعته. تُراجَع مصادر هذه الصفحة كل ثلاثة أشهر.
كيف أُعدّت هذه الصفحة: كُتبت بمساعدة الذكاء الاصطناعي اعتمادًا على المصادر المذكورة في هذه الصفحة، والتي رُوجعت في .