تتبّع السوق عبر الزمن

لقطة واحدة يوميًا

تخزّن جوكر برايس لقطة واحدة لكل وجهة يوميًا: العرض، ووسيط السعر المعروض، وحيث تُتتبَّع التقويمات: الإشغال ومتوسط السعر اليومي (ADR) والإيراد لكل وحدة متاحة (RevPAR) والليالي المحجوزة مسبقًا. وتُرجع GET /api/v1/trends هذه اللقطات على شكل سلسلة.

اطلب سلسلة

curl -H "Authorization: Bearer $JOKERPRICE_KEY" \
  "https://jokerprice.com/api/v1/trends?city=dubai&metric=asking&days=90"

• city معرّف وجهة من /api/v1/markets.
• metric إحدى القيم occupancy أو adr أو revpar أو asking أو listings أو tracked أو on_the_books.
• source قيمته all (الافتراضية) أو gathern أو airbnb.
• days من 7 إلى 1100، والقيمة الافتراضية 365.

اقرأ الاستجابة

تأتي السلسلة في trends.points، بإدخال واحد لكل يوم يتضمن day وvalue؛ وفي asking تحمل كل نقطة أيضًا المئين 25 والمئين 75. وتقارن trends.changes أحدث قيمة بالقيم قبل 7 و30 و90 يومًا حيث يتوفر سجل بهذا الطول، بينما تتبع trends.supply عدد العقارات.

تحقق من السجل أولًا

يبيّن trends.history.days وtrends.history.firstDay مقدار السجل المخزّن، ويشرح trends.notice بالكلمات متى تكون السلسلة قصيرة. ولا تظهر المقارنة السنوية في trends.yearOverYear إلا بعد تخزين عام كامل. لا تقارن سلسلة مدتها أسبوعان بنمط موسمي؛ انتظر حتى تكتمل.

اجمعها مع المؤشرات الحالية

للحصول على أحدث صورة للإشغال، بما فيها المهلة المسبقة للحجز وأنماط أيام الأسبوع، استدعِ GET /api/v1/metrics?city=riyadh وتحقق من الحقل maturity. استخدم الاتجاهات لمعرفة الاتجاه عبر الزمن، والمؤشرات لتفاصيل الفترة الحالية.