الحدود والحصص
يكلف كل طلب وحدات تظهر في X-Request-Units، وفي x-units لكل نقطة نهاية في المرجع:
- نقاط القوائم، كبحث الإعلانات وقوائم المشاريع: وحدة لكل 10 نتائج مطلوبة بـ
limit، حتى حجم صفحة خطتك. صفحة 100 نتيجة تكلف 10. - الجلب الدفعي للإعلانات: وحدة لكل 10 معرّفات.
- الموارد المفردة والبيانات المرجعية وبيانات السوق: وحدة واحدة.
- التحليلات: 10 لوضع السوق ونطاق السعر، أو 15 للمقارنات والعائد الإيجاري ومقارنة الأحياء والاتجاهات، أو وحدتان لكل 10 نتائج للفرص.
تحدد خطتك:
- حد المعدل: وحدات في الدقيقة. الترويسات:
RateLimit-LimitوRateLimit-RemainingوRateLimit-Resetبالثواني. - الحصة الشهرية: وحدات في الشهر التقويمي بتوقيت UTC. الترويسات:
X-Quota-LimitوX-Quota-RemainingوX-Quota-Reset. - حجم الصفحة: أكبر
limitيمكنك طلبه. - عمق التصفح: عدد النتائج الممكن تصفحها في استعلام واحد. بعده تحصل على
result_window_exceeded؛ ضيّق الاستعلام أو زامن بـupdated_since.
| الخطة | وحدات / دقيقة | وحدات / شهر | حجم الصفحة | عمق التصفح | المفاتيح النشطة |
|---|---|---|---|---|---|
| Free | 30 | 250 | 25 | 500 | 5 |
| Starter | 60 | 50,000 | 50 | 5,000 | 25 |
| Growth | 150 | 200,000 | 100 | 5,000 | 25 |
| Pro | 300 | 750,000 | 100 | 20,000 | 25 |
تحدد خطط Enterprise هذه الحدود حسب الاتفاق. تجد حدودك في صفحة الخطة بلوحة التحكم، ويعيدها GET /limits للمفتاح الذي يطلبها دون وحدات. اقرأها عند بدء التشغيل بدل تثبيت حجم صفحة في الكود، ليعمل الكود نفسه مع كل خطة.
الاستخدام الإضافي. في أي اشتراك مدفوع، Starter أو Growth أو Pro، تستمر الطلبات بعد الحصة الشهرية وتُفوتر لكل 1,000 وحدة في نهاية دورة الفوترة حتى سقف الإنفاق الشهري الذي يحدده المالك في صفحة الفوترة. عند السقف تحصل على 429 spend_cap_reached حتى تجدد الحصة. مع سقف 0 تصبح الحصة حدًا صارمًا (429 monthly_quota_exceeded).
عند تجاوز حد تحصل على 429 وترويسة Retry-After. انتظر عدد الثواني المحدد ثم أعد المحاولة. لا تُحتسب الطلبات الفاشلة، 4xx و5xx و429، على حصتك الشهرية.