قائمة وثائق المطورين

أسعار واجهة API

ابدأ بتجربة مجانية لمدة 30 يومًا دون بطاقة، ثم اختر خطة شهرية أو سنوية بالريال، عبر Polar.

الخطط

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

الخطةالسعرطلبات الحسابمفاتيح API
التجربة المجانيةمجانية لمدة 30 يومًا دون بطاقة25,000 طلب يوميًا، و120 في الدقيقة5
مطوّر API‏99 ر.س.‏ شهريًا أو ‏990 ر.س.‏ سنويًا25,000 طلب يوميًا، و120 في الدقيقة5
أعمال API‏349 ر.س.‏ شهريًا أو ‏3,490 ر.س.‏ سنويًا100,000 طلب يوميًا، و300 في الدقيقة10

تُسعَّر خطة مضيف لكل عقار، وتشمل طلبات API أيضًا:

الخطةالسعرطلبات الحسابمفاتيح API
مضيف‏49 ر.س.‏ لكل عقار شهريًا، وينخفض حتى ‏24 ر.س.‏5,000 طلب يوميًا، و60 في الدقيقة2

خطة مضيف متدرجة مثل شرائح الضريبة: ‏49 ر.س.‏ لكل عقار من 1 إلى 5، ‏39 ر.س.‏ لكل عقار من 6 إلى 20، ‏29 ر.س.‏ لكل عقار من 21 إلى 50 و‏24 ر.س.‏ لكل عقار من 51 إلى 100. ولا يسري كل سعر إلا على العقارات الواقعة في شريحته، فمثلًا تكلّف 10 عقارات ‏440 ر.س.‏ شهريًا. والسنة بسعر عشرة أشهر. ولأكثر من 100 عقار تواصل معنا.

يأتي ترخيص تجاري لبيانات الواجهة في المنتجات والخدمات التي تبيعها مع خطة أعمال API، وتوضح الشروط ما تغطيه كل خطة.

  • جميع نقاط الوصول في /api/v1، وعددها 8
  • خادم MCP لمساعدي الذكاء الاصطناعي، بالمفاتيح نفسها
  • استخدام كل مفتاح في صفحة البيانات وواجهة API

الحسابات التي أُنشئت قبل الخطط المدفوعة

حتى نهاية 15 ديسمبر 2026 تحتفظ الحسابات التي أُنشئت قبل الخطط المدفوعة بالحصة السابقة: حتى 5 مفاتيح بحد 60 طلبًا في الدقيقة و5,000 طلب يوميًا لكل مفتاح. وتستمر تجربتها المجانية حتى ذلك الموعد، أو 30 يومًا من التسجيل إن كانت تنتهي بعده. وبعد التجربة تحتاج الواجهة إلى خطة، ولا يُحتسب أي مبلغ ما لم تختر خطة.

كيف تُحتسب الطلبات

  • يُحتسب كل طلب موثّق مرة واحدة على الحساب، أيًّا كان المفتاح الذي أرسله، بما في ذلك الطلبات التي تُرجع خطأً بعد قبول المفتاح.
  • تتقاسم جميع مفاتيح الحساب حدَّيه اليومي والدقيقي، وتبقى طلبات المفتاح الملغى محتسبة لذلك اليوم.
  • كل صفحة من /api/v1/listings طلب واحد؛ فالمدينة التي فيها 2,000 وحدة تحتاج إلى 4 طلبات عند limit=500.
  • كل استدعاء لأداة MCP طلب API واحد، على الخادم المستضاف والخادم المحلي كليهما. ولا يُحتسب الاتصال بالخادم المستضاف ولا عرض أدواته.
  • تُصفَّر العدادات كل دقيقة وعند الساعة 00:00 بتوقيت UTC. وتتضمن الاستجابة 429 الترويسة Retry-After.

أسئلة شائعة

هل أحتاج إلى بطاقة للبدء؟

لا. يبدأ كل حساب جديد بتجربة مجانية لمدة 30 يومًا تشمل الواجهة، فأنشئ حسابًا ومفتاحًا. ولا تدفع إلا حين تختار خطة، عند إتمام الشراء على Polar التي تتولى ضريبة القيمة المضافة والإيصالات بصفتها التاجر المسجّل.

ماذا يحدث عند انتهاء التجربة المجانية؟

إذا لم تختر خطة، تُرجع طلبات API وMCP الرمز 402 PLAN_REQUIRED مع رسالة واضحة. وتبقى مفاتيحك صالحة وتعمل من جديد فور اختيار خطة. وتبقى مساحة عملك متاحة للعرض مع نسخ الاسترداد، ولا يُحذف شيء.

ماذا يحدث عند بلوغ الحد اليومي؟

تُرجع الطلبات 429 DAILY_LIMIT حتى اليوم التالي بتوقيت UTC، ولا يُحتسب أي مبلغ على الطلبات.

هل يمكنني استخدام البيانات تجاريًا؟

تشمل خطة أعمال API ترخيصًا تجاريًا لبيانات الواجهة في المنتجات والخدمات التي تبيعها، وتغطي الخطط الأخرى والتجربة المجانية نشاطك وأدواتك الخاصة، وتفصّل الشروط الحالتين. والأرقام تقديرات من بيانات عامة، وجوكر برايس غير تابعة لـ Airbnb أو Gathern أو Agoda.

كيف ألغي الاشتراك؟

افتح «إدارة الفوترة» في صفحة حسابك. تستمر الخطة حتى نهاية المدة التي دفعت عنها. وبعدها، متى انتهت التجربة المجانية أيضًا، تُرجع الواجهة 402 PLAN_REQUIRED وتصبح مساحة العمل للعرض فقط حتى تختار خطة من جديد.