جوكر برايس
ابدأ التجربة المجانية
قائمة وثائق المطورين

بيانات الإيجار قصير الأجل عبر واجهة API

أدخل تقارير السوق والإشغال المستند إلى تتبّع التقويمات والعقارات وتقديرات الإيرادات التي يعمل بها جوكر برايس مباشرةً في نصوصك البرمجية وجداول بياناتك ولوحات معلوماتك ومساعدي الذكاء الاصطناعي. 8 نقاط وصول للقراءة فقط بصيغة JSON، ومفتاح API واحد.

ابدأ الآناستعرض نقاط الوصول

ما الذي يمكنك الاستعلام عنه

الأسواق

العرض، وأرباع السعر المعروض، ونطاقات الأسعار حسب عدد غرف النوم، وتوزيع أنواع العقارات، والتقييمات لكل وجهة تضم 20 عقارًا مجمّعًا على الأقل.

الأداء

الإشغال، ومتوسط السعر اليومي (ADR)، والإيراد لكل وحدة متاحة (RevPAR)، والإيراد لكل عقار، ونسبة الليالي المحجوزة مسبقًا من الفحص اليومي للتقويمات، لمدينة أو لمستطيل على الخريطة.

الاتجاهات

لقطة محفوظة واحدة لكل وجهة يوميًا، تُعرض سلسلةً زمنية للإشغال أو متوسط السعر اليومي أو الإيراد لكل وحدة متاحة أو السعر المعروض أو العرض.

العقارات

عقارات Airbnb وGathern وAgoda المجمّعة مع الموقع وعدد غرف النوم والنوع والسعر المعروض والتقييم والرابط، صفحةً بعد صفحة.

تقديرات الإيرادات

السعر الليلي المتوقع والإشغال والإيرادات لأي إحداثيات، مع العقارات المماثلة التي يستند إليها التقدير وعوائد استثمارية اختيارية.

طلب واحد

كل نقطة وصول طلب HTTPS عادي يحمل مفتاحك في ترويسة Authorization.

سطر الأوامر
curl -H "Authorization: Bearer $JOKERPRICE_API_KEY" \
  "https://jokerprice.com/api/v1/markets/riyadh"
الاستجابة (مختصرة، والقيم توضيحية)
{
  "market": {
    "slug": "riyadh",
    "name": "Riyadh",
    "listings": 9412,
    "nightly": {
      "median": 420,
      "p25": 300,
      "p75": 650
    },
    "tracker": {
      "maturity": "estimating",
      "occupancy": 0.47,
      "adr": 512.4,
      "monthlyRevenuePerListing": 7225
    }
  }
}

نقاط الوصول

نقطة الوصولما تُرجعه
GET/api/v1/marketsعرض الأسواق
GET/api/v1/markets/{slug}تقرير سوق واحد
GET/api/v1/metricsمؤشرات الأداء
GET/api/v1/trendsالاتجاهات اليومية
GET/api/v1/paceوتيرة الحجز في السوق
GET/api/v1/eventsالمناسبات والعطلات
GET/api/v1/listingsعرض العقارات
POST/api/v1/estimateتقدير الإيرادات

مشمولة في التجربة المجانية

يحصل كل حساب جديد على الواجهة ضمن تجربته المجانية لمدة 30 يومًا دون بطاقة: 120 طلبًا في الدقيقة و25,000 طلب في اليوم (بتوقيت UTC) للحساب خلال التجربة المجانية، وحتى 300 في الدقيقة و100,000 في اليوم في الخطط المدفوعة. مفاتيح API خلال التجربة: 5. وبعد التجربة تحتاج الواجهة إلى خطة، وتُرجع الطلبات 402 PLAN_REQUIRED حتى تختار واحدة. وتعرض أسعار API الخطط.

الخطوة التالية