استيعاب المشاريع بحسب المنطقة أو المطوّر أو النوع
GET/market/absorption
الاستيعاب شهرًا بشهر مجمّعًا على المشاريع: لكل مدينة (الافتراضي) أو حي أو مطوّر أو نوع عقار أو نوع مشروع، الوحدات المعروضة في بداية كل شهر ونهايته، والوحدات الخارجة والمطروحة والعائدة، ومعدل الاستيعاب المجمّع والوسيط، وأشهر المخزون بوتيرة الشهر. سلسلة كل مشروع وقواعدها في GET /projects/{id}/absorption؛ ولا تُجمّع إلا الأشهر التي تكون فيها usable، وكل رقم null حين يقل عدد المشاريع التي لها شهر كهذا عن min_sample_size. وتعطي projects_observed وprojects_usable وflagged العينة وراء كل شهر.
هذا ليس سجل مبيعات. عدد الوحدات «المتاحة» في بوابة عقارية أو موقع مطوّر هو ما عرضته الصفحة في ذلك اليوم. تُعدّ الوحدة خارجة حين يتوقف المصدر عن عرضها، ويبدو ذلك من الخارج واحدًا سواء بيعت أو حُجزت أو أُجّرت أو سحبها المطوّر من الصفحة؛ والحجوزات قد تُلغى، والمطوّرون يحجبون وحدات. اقرأ الأرقام على أنها سرعة تقلّص العرض المعلن، وارجع إلى الصفقات المسجلة حين تحتاج المبيعات الفعلية.
أي المشاريع. لا يمكن القياس إلا من مصادر تنشر عددًا للمخزون: جداول وحدات بحالة لكل وحدة (أساس مكين ورسن؛ basis unit_status)، أو عدد متاح معلن (Mada؛ reported_available)، أو عدد الوحدات المدرجة في صفحة المشروع (وصلت وCompoundIn؛ listed_units). عدد الوحدات في بقية المصادر هو حجم المشروع ولا يتحرك مع البيع، فمعظم المشاريع قيمة reliability فيها no_inventory_signal. لا يذكر أي مصدر الوحدات المتاحة بحسب نوع الوحدة، فلا تقسيم بحسب النوع؛ ويفصل listing_type البيع عن الإيجار حيث يفصلهما المصدر. تُقرأ نسخ المشروع الواحد من عدة مصادر مرة واحدة، من المصدر ذي الأساس الأفضل. بدأت اللقطات في 2026-09-26. التغطية محدودة وغير متساوية: معظم المشاريع القابلة للقياس في الرياض، وقد لا يكون لمدينة أو مطوّر أي مشروع؛ راجع projects_tracked وprojects_usable قبل قراءة أي معدل.
تُحتسب المشاريع بآخر موقع ومطوّر لها، بما فيها المشاريع التي أصبحت غير نشطة (للأشهر التي كانت معروضة فيها).
- المصادقة
- أرسل مفتاح بيانات (dk_live_… أو dk_test_…) بصيغة Bearer.
- النطاق
projects- التكلفة
- 50 وحدة لكل طلب
المعاملات
| الاسم | الوصف |
|---|---|
cityالنوع: string · الاستعلام | احذفه لتضمين كل المدن. |
neighborhood_idالنوع: integer[] · الاستعلام | معرّفات الأحياء من GET /cities/{city}/neighborhoods. لا تطابق إلا المشاريع المعينة لحي. |
developerالنوع: string · الاستعلام | اسم المطور المطابق تمامًا كما يعيده GET /developers. |
property_typeالنوع: string · الاستعلام | المشاريع التي معظم وحداتها المدرجة في كايت من هذا النوع. إحدى القيم: |
project_typeالنوع: string · الاستعلام | إحدى القيم: |
listing_typeالنوع: string · الاستعلام | أي مخزون يُقرأ: وحدات البيع إحدى القيم: |
group_byالنوع: string · الاستعلام | مجموعة لكل مدينة (الافتراضي) أو حي أو مطوّر أو نوع عقار أو نوع مشروع. تُترك المشاريع التي لا قيمة لها في حقل التجميع، وتُعدّ في إحدى القيم: |
fromالنوع: string · الاستعلام | أول شهر ( |
toالنوع: string · الاستعلام | آخر شهر ( |
min_sample_sizeالنوع: integer · الاستعلام | تكون أرقام الشهر null حين يقل عدد المشاريع التي لها شهر صالح عن هذا العدد. |
الاستجابة
الحقل data كائن بهذه الحقول.
| الاسم | الوصف |
|---|---|
filtersمطلوبالنوع: object | |
listing_typeمطلوبالنوع: string | إحدى القيم: |
group_byمطلوبالنوع: string | إحدى القيم: |
fromمطلوبالنوع: string | |
toمطلوبالنوع: string | |
min_sample_sizeمطلوبالنوع: integer | |
projects_ungroupedمطلوبالنوع: integer | |
groupsمطلوبالنوع: object[] |
نقاط نهاية ذات صلة
- البحث في المشاريع العقارية
GET /projects - جلب مشروع عقاري
GET /projects/{id} - قائمة وحدات مشروع
GET /projects/{id}/units - توافر وحدات المشروع عبر الزمن
GET /projects/{id}/availability - البحث في وحدات المشاريع
GET /project-units - قائمة المطورين
GET /developers - عرض استيعاب المشروع شهرًا بشهر
GET /projects/{id}/absorption