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

حدود معدل TikTok API: الطلبات لكل حساب وتطبيق ونقطة نهاية

تفرض TikTok API for Business، وهي واجهة برمجة التطبيقات (API) الخاصة بمنصة TikTok، حدوداً على ثلاثة مستويات في وقت واحد: 40 طلباً في الدقيقة لكل حساب مصرّح به على كل نقطة نهاية (endpoint) في Accounts API، وميزانية مشتركة لواجهة Accounts API لكل تطبيق مطوّر قدرها 600 في الدقيقة في المستوى Basic و1,000 فوقه، وحدود لكل نقطة نهاية على مستوى التطبيق قدرها 10 في الثانية و600 في الدقيقة و864,000 في اليوم في Basic، وترتفع إلى 50 في الثانية في Ultimate.

يقوم easyCoexistence بنشر المنشورات وقراءة التحليلات والرد على التعليقات على TikTok لصالح Claude وChatGPT أو الكود الخاص بك عبر TikTok API for Business، ويعيد رمز TikTok ورسالته عند تقييد استدعاء، ويتابع كل منشور حتى تكمل TikTok نشره أو تفشله.

40 QPM

طلبات في الدقيقة لكل حساب TikTok مصرّح به على كل نقطة نهاية في Accounts API، برقم واحد مستقل عن مستوى التطبيق.

1,000 QPM

الميزانية المشتركة لجميع نقاط نهاية Accounts API لكل تطبيق مطوّر في Advanced وPremium وUltimate، أما Basic فيحصل على 600.

50 QPS

الحد لكل نقطة نهاية في Ultimate، أعلى مستوى للتطبيق، إلى جانب 3,000 طلب في الدقيقة و4,320,000 في اليوم.

HTTP 200

الحالة التي تعيدها TikTok مع رموز الاستجابة، ومنها الرموز 4xxxx مثل 40100، والنجاح يعني الرمز 0 فقط.

10 QPS

حد المعدل لكل نقطة نهاية في Discovery API لكل تطبيق مطوّر.

00:00 UTC

متى تُعاد ضبط الحدود اليومية، وبعد حد الدقيقة تطلب TikTok توقفاً مدته 5 دقائق بدلاً من ذلك.

أي الحدود تنطبق على استدعاء TikTok API؟

تتحرك مع كل استدعاء لـ Accounts API ما يصل إلى ثلاثة عدادات، وقد تحتفظ بعض المنتجات والإجراءات بعدادات خاصة بها. تُبقي TikTok عدادات نقاط النهاية مستقلة، فقد تُقيَّد نقطة نهاية واحدة بينما تستمر نقاط التطبيق الأخرى في الرد:

Per account and endpoint40 queries a minute for each authorized TikTok account on each Accounts API endpoint
Per app, Accounts API combined600 queries a minute at Basic, and 1,000 at Advanced, Premium and Ultimate
Per app and endpointQueries a second, a minute and a day, set by the app's level
PublishingSix posts a minute and 15 a day per account, on the video and on the photo endpoint
Mentions APIThe app's global limits, with TikTok advising one call per endpoint and account a day
Discovery API10 queries a second on each endpoint, per developer app

ماذا تتيح المستويات الأربعة للتطبيق؟

تبدأ جميع تطبيقات المطورين من مستوى Basic، وتنقله TikTok مستوى واحداً في كل مرة عند الطلب عبر My Apps، ثم App Detail، ثم Authorization، مع ذكر السبب. يحدد كل مستوى ما يمكن أن تستهلكه نقطة نهاية واحدة من التطبيق، إلى جانب الميزانية المجمعة لاستدعاءات Accounts API:

Basic10 a second, 600 a minute, 864,000 a day; Accounts API combined: 600 a minute
Advanced20 a second, 1,200 a minute, 1,728,000 a day; Accounts API combined: 1,000 a minute
Premium30 a second, 1,800 a minute, 2,592,000 a day; Accounts API combined: 1,000 a minute
Ultimate50 a second, 3,000 a minute, 4,320,000 a day; Accounts API combined: 1,000 a minute

هل يرفع المستوى الأعلى ميزانية Accounts API؟

مرة واحدة فقط. فالانتقال من Basic إلى Advanced يرفع الميزانية المجمعة لـ Accounts API من 600 إلى 1,000 طلب في الدقيقة، وتبقى عند 1,000 حتى Premium وUltimate، بينما تستمر حدود نقطة النهاية في الثانية واليوم بالارتفاع. ولا يتغير الحد البالغ 40 في الدقيقة لكل حساب ونقطة نهاية مع المستوى إطلاقاً، لذلك يُقيَّد حساب واحد مزدحم عند 40 استدعاء في الدقيقة على نقطة نهاية، أياً كان المستوى الذي يملكه التطبيق.

كيف تتراكم الحدود عبر حسابات كثيرة؟

يتضاعف حد الحساب مع كل حساب، أما ميزانية التطبيق فلا تتضاعف. يستطيع عشرة حسابات أن يجري كل منها 40 استدعاء في الدقيقة إلى /business/comment/list/، أي 400 في المجموع، لكن عشرين حساباً تفعل الشيء نفسه تحتاج إلى 800، وهذا يتجاوز 600 التي يملكها تطبيق Basic لاستدعاءات Accounts API مجتمعة قبل احتساب أي نقطة نهاية أخرى. وفوق Basic تتوقف تلك الميزانية المشتركة عند 1,000 في الدقيقة.

ماذا يحدث عند تجاوز الحد في استدعاء؟

تقيّد TikTok نقطة النهاية تلك. ويذكر دليل حدود المعدل الخاص بها الرمز 40100 للاستدعاء المقيّد، ويأتي في نص استجابة HTTP 200، وتبقى نقطة النهاية مغلقة لمدة 5 دقائق بعد حد الدقيقة، أو حتى تُعاد ضبط العدادات اليومية عند 00:00 UTC بعد حد يومي، بينما تستمر نقاط التطبيق الأخرى في الرد. أما اكتشافه برمجياً وإعادة المحاولة بشكل سليم فيتعلقان بالخطأ 40100.

هل حدود النشر حدود معدل؟

لا، فهي تحسب المنشورات لا الاستدعاءات، ولها صفحة خاصة بها. تتيح TikTok لحساب نشر ستة منشورات في الدقيقة و15 في اليوم عبر /business/video/publish/، والحد نفسه عبر /business/photo/publish/. ويفشل المنشور الذي يتجاوز هذا العدد مع spam_risk_too_many_posts في حالة النشر الخاصة به، بينما يرفض حد الطلبات الاستدعاء نفسه.

ما العادات التي تستنزف الحدود أسرع؟

الاستطلاع المتكرر. فالتحقق من حالة النشر أو قائمة التعليقات على مؤقت يستهلك 40 استدعاء في الدقيقة من حساب على تلك نقطة النهاية، سواء تغيّر شيء أم لا. وقد وُجدت خطافات الويب (webhooks) في TikTok لتحل محل ذلك: تُبلغ أحداث نشر المنشورات عن كل مرحلة من مراحل المنشور، ويُبلغ comment.update عن تعليق جديد خلال خمس دقائق. أما القراءة صفحة بصفحة، بواقع 20 منشوراً أو 30 تعليقاً في الاستدعاء، وسحب بيانات Mentions مرة واحدة يومياً، فتُبقي الباقي منخفضاً.

كيف يتعامل easyCoexistence مع استدعاء TikTok مقيّد؟

يمرّر الجواب من TikTok كما هو بدلاً من إخفائه. فاستدعاء الأداة الذي تقيّده TikTok، مثل list_social_comments أو reply_to_comment أو get_tiktok_publish_status، يعود إلى الذكاء الاصطناعي كخطأ يذكر الرمز 40100 مع رسالة TikTok، ولا يُكرر تلقائياً. أما المنشورات فتسلك مساراً مختلفاً، إذ يسلّم publish_tiktok_post كل منشور إلى قائمة الانتظار في easyCoexistence، فينشر فوراً أو في وقت محدد:

  • تنتظر قائمة الانتظار وتعيد المحاولة بعد 5 دقائق و30 دقيقة وساعتين عندما يعود الرد بـ HTTP 429.
  • ترسل TikTok الرمز 40100 داخل استجابة HTTP 200، لذلك يفشل نشر TikTok المقيّد برسالة TikTok ويبقى تحت Needs attention بانتظار Retry.
  • ويفشل المنشور أيضاً إذا ظهر الرمز 40100 في إحدى فحوص الحالة في قائمة الانتظار، مع أن TikTok ربما نشرته بالفعل، لذا تحقق من أحدث منشورات الحساب قبل Retry.
  • يرسل المنشور الذي يفشل في الخلفية بريداً إلكترونياً إلى المالك، مرة واحدة كحد أقصى لكل قناة كل 3 ساعات.

ما استدعاءات TikTok التي ينفذها easyCoexistence لحساب ما؟

عدد قليل منها، وهي تُحتسب ضمن حدود الحساب تماماً كاستدعاءاتك أنت:

  • /business/get/ تقريباً كل 6 ساعات، للتأكد من أن الحساب ما زال يستجيب.
  • استدعاء نشر واحد لكل منشور، ثم /business/publish/status/ تقريباً كل 20 ثانية إلى أن تُكمل TikTok المنشور أو تُفشله، لمدة تصل إلى ساعتين.
  • عند تفعيل قواعد التعليقات أو الأتمتة، استدعاء واحد لـ /business/comment/list/ لكل تعليق جديد من المستوى الأعلى لقراءة كاتبه، واستدعاء واحد لكل رد يُنشر.
  • استدعاءات الأدوات تُنفَّذ فقط عندما يطلبها الذكاء الاصطناعي أو الكود الخاص بك، بواقع 20 منشوراً أو 30 تعليقاً لكل قراءة.

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

  • اكتشاف التقييد من حالة HTTP. ترد TikTok بالرمز 40100 مع HTTP 200، لذلك فإن الفحص على res.ok أو على 429 يغفله، فاقرأ الرمز من نص الاستجابة.
  • رفع مستوى التطبيق لإصلاح حساب واحد مزدحم. يبقى 40 استدعاء في الدقيقة لكل حساب ونقطة نهاية كما هو في المستويات الأربعة جميعها، لذا وزّع استدعاءات ذلك الحساب على فترات زمنية.
  • سحب بيانات Mentions عدة مرات في اليوم. تحدّثها TikTok مرة واحدة، بين منتصف الليل و7 صباحاً بتوقيت UTC، وتوصي باستدعاء واحد لكل نقطة نهاية وحساب في اليوم.
إنجاز ذلك باستخدام EasyCoexistence

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

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

ما حد معدل TikTok API لكل حساب؟

40 طلباً في الدقيقة على كل نقطة نهاية في Accounts API لكل حساب TikTok مصرّح به، ضمن الميزانية المجمعة للتطبيق المطوّر البالغة 600 في الدقيقة في Basic أو 1,000 فوقه.

هل تُحسب حدود TikTok لكل نقطة نهاية؟

نعم. يقول دليل TikTok إن الحدود الخاصة بنقاط النهاية مستقلة، فبلوغ حد نقطة نهاية واحدة لا يوقف الاستدعاءات إلى نقطة أخرى.

كيف أرفع حد معدل TikTok API الخاص بي؟

قدّم طلباً عبر My Apps ثم App Detail ثم Authorization مع ذكر السبب. ترتفع المستويات خطوة واحدة في كل مرة، من Basic إلى Advanced ثم Premium ثم Ultimate.

هل تُحتسب الاستدعاءات عبر easyCoexistence ضمن حدود TikTok؟

نعم. تعمل بصفتها الحساب المتصل برمز الوصول (token) الخاص به، لذلك تُحتسب ضمن 40 استدعاء في الدقيقة لكل نقطة نهاية لذلك الحساب، شأنها شأن أي استدعاء آخر له.

تابع القراءة

خطأ TikTok 40100: طلبات مرسلة بتكرار مفرطخطأ TikTok 40100 يعني أن الطلب تعرض لتقييد بسبب حد المعدل. كيف تكتشفه في استجابة HTTP 200، ومدة الانتظار، وكيف تبقى ضمن الحد.حدود نشر منشورات TikTok عبر واجهة برمجة التطبيقات (API): عدد المنشورات في اليومعدد المنشورات التي تنشرها واجهة TikTok لكل حساب: ستة في الدقيقة و15 في اليوم، وما يحدث عند تجاوز الحد.التحقق من خطاف الويب (webhook) في TikTok: ترويسة التوقيع وطريقة فحصهاالتحقق من webhook في TikTok API for Business: ترويسة Tiktok-Signature وHMAC-SHA256 مع مثال Node.js.الإشارات على TikTok عبر واجهة برمجة التطبيقات (API): العثور على المنشورات والتعليقات التي تشير إلى حسابواجهة Mentions في TikTok: منشورات وتعليقات عامة تشير إلى الحساب بـ@، مع النطاق والتأخير ونقاط النهاية (endpoints) وخطاف الويب (webhook).أسباب فشل النشر في TikTok: spam_risk_too_many_posts وpicture_size_check_failed وغيرهامعنى أسباب فشل النشر في TikTok وكيفية إصلاح كل سبب، مثل spam_risk_too_many_posts وpicture_size_check_failed وvideo_pull_failed وغيرها.TikTok API for Business مقابل Content Posting APIلماذا TikTok API for Business بدلًا من developers.tiktok.com: التعليقات والتحليلات وتجديد رموز الوصول.

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

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

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

تم التحقق في