استيعاب المشاريع بحسب المنطقة أو المطوّر أو النوع (GET /market/absorption) — Kite API
تخطَّ إلى المحتوى
Kiteالمنصة
الباقات
تصفح نقاط النهاية
كل نقاط النهاية

البيانات المرجعية

  • قائمة المدن
  • قائمة الأحياء
  • قائمة جهات المدينة
  • قائمة قيم التعداد
  • حدود هذا المفتاح
  • ما يغطيه API

الإعلانات

  • البحث عن الإعلانات
  • عدّ الإعلانات
  • جلب الإعلانات بالمعرّف
  • جلب إعلان
  • سجل سعر إعلان
  • جلب بيانات التواصل مع معلن الإعلان

بيانات السوق

  • ملخص السوق
  • توزيع الأسعار
  • توزيع المساحات
  • المعروض الجديد
  • مؤشر الشغور
  • الأسعار بحسب الحي
  • الإيجار التجاري للمتر المربع بحسب الحي
  • القطع المعروضة للبيع مقارنة بآخر صفقة مسجلة عليها
  • سعر البيع المسجل مقابل السعر المطلوب
  • الأماكن والسكان والمعالم حول نقطة أو في حي

البيانات الرسمية

  • الإيجارات المسجلة لدى الهيئة العامة للعقار
  • مؤشر كايت العقاري

التحليلات

  • جلب الإعلانات المقارنة
  • موقع سعر الإعلان في السوق
  • نطاق أسعار العرض القريبة لإعلان
  • إعلانات أقل من أسعار السوق
  • إعلانات أقل من أسعار السوق (المسار القديم)
  • العائد الإيجاري الإجمالي
  • اتجاهات الأسعار
  • مقارنة الأحياء
  • المعلنون بحسب الإعلانات المطابقة
  • تحقق من السعر المطلوب لأي منزل

الصفقات المسجلة

  • البحث في الصفقات المسجلة
  • إحصاءات الصفقات المسجلة
  • أسعار الأراضي لكل م²

المشاريع على الخارطة

  • البحث في المشاريع العقارية
  • جلب مشروع عقاري
  • قائمة وحدات مشروع
  • توافر وحدات المشروع عبر الزمن
  • البحث في وحدات المشاريع
  • قائمة المطورين
  • عرض استيعاب المشروع شهرًا بشهر
  • استيعاب المشاريع بحسب المنطقة أو المطوّر أو النوع

التصدير

  • إنشاء تصدير
  • قائمة الصادرات
  • جلب تصدير

الإدارة

  • جلب مؤسستك
  • قائمة مفاتيح البيانات
  • إنشاء مفتاح بيانات
  • إلغاء مفتاح
  • قائمة مشاريع المؤسسة
  • الاستخدام اليومي
  • قائمة الأعضاء والدعوات
  • قائمة أحداث التدقيق
  • قائمة سجلات الطلبات
  • إنشاء نقطة Webhook
  • قائمة نقاط Webhook
  • تحديث نقطة Webhook
  • إعادة تفعيل نقطة Webhook
  • تدوير سر توقيع Webhook
  • حذف نقطة Webhook
  • قائمة عمليات التسليم
  • إعادة تشغيل تسليم

المرجع التفاعلي

كل نقاط النهاية

البيانات المرجعية

  • قائمة المدن
  • قائمة الأحياء
  • قائمة جهات المدينة
  • قائمة قيم التعداد
  • حدود هذا المفتاح
  • ما يغطيه API

الإعلانات

  • البحث عن الإعلانات
  • عدّ الإعلانات
  • جلب الإعلانات بالمعرّف
  • جلب إعلان
  • سجل سعر إعلان
  • جلب بيانات التواصل مع معلن الإعلان

بيانات السوق

  • ملخص السوق
  • توزيع الأسعار
  • توزيع المساحات
  • المعروض الجديد
  • مؤشر الشغور
  • الأسعار بحسب الحي
  • الإيجار التجاري للمتر المربع بحسب الحي
  • القطع المعروضة للبيع مقارنة بآخر صفقة مسجلة عليها
  • سعر البيع المسجل مقابل السعر المطلوب
  • الأماكن والسكان والمعالم حول نقطة أو في حي

البيانات الرسمية

  • الإيجارات المسجلة لدى الهيئة العامة للعقار
  • مؤشر كايت العقاري

التحليلات

  • جلب الإعلانات المقارنة
  • موقع سعر الإعلان في السوق
  • نطاق أسعار العرض القريبة لإعلان
  • إعلانات أقل من أسعار السوق
  • إعلانات أقل من أسعار السوق (المسار القديم)
  • العائد الإيجاري الإجمالي
  • اتجاهات الأسعار
  • مقارنة الأحياء
  • المعلنون بحسب الإعلانات المطابقة
  • تحقق من السعر المطلوب لأي منزل

الصفقات المسجلة

  • البحث في الصفقات المسجلة
  • إحصاءات الصفقات المسجلة
  • أسعار الأراضي لكل م²

المشاريع على الخارطة

  • البحث في المشاريع العقارية
  • جلب مشروع عقاري
  • قائمة وحدات مشروع
  • توافر وحدات المشروع عبر الزمن
  • البحث في وحدات المشاريع
  • قائمة المطورين
  • عرض استيعاب المشروع شهرًا بشهر
  • استيعاب المشاريع بحسب المنطقة أو المطوّر أو النوع

التصدير

  • إنشاء تصدير
  • قائمة الصادرات
  • جلب تصدير

الإدارة

  • جلب مؤسستك
  • قائمة مفاتيح البيانات
  • إنشاء مفتاح بيانات
  • إلغاء مفتاح
  • قائمة مشاريع المؤسسة
  • الاستخدام اليومي
  • قائمة الأعضاء والدعوات
  • قائمة أحداث التدقيق
  • قائمة سجلات الطلبات
  • إنشاء نقطة Webhook
  • قائمة نقاط Webhook
  • تحديث نقطة Webhook
  • إعادة تفعيل نقطة Webhook
  • تدوير سر توقيع Webhook
  • حذف نقطة Webhook
  • قائمة عمليات التسليم
  • إعادة تشغيل تسليم

المرجع التفاعلي

المشاريع على الخارطة

استيعاب المشاريع بحسب المنطقة أو المطوّر أو النوع

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 · الاستعلام

المشاريع التي معظم وحداتها المدرجة في كايت من هذا النوع.

إحدى القيم: apartment, villa, floor, duplex, land, building, office, shop

project_typeالنوع: string · الاستعلام

إحدى القيم: off_plan, ready

listing_typeالنوع: string · الاستعلام

أي مخزون يُقرأ: وحدات البيع sale (الافتراضي) أو الإيجار rent حيث يفصل المصدر بينهما، أو all للاثنين معًا. يذكر Rasan وMada وحدات البيع فقط، وCompoundIn الإيجار فقط؛ ويذكر Asas Makeen وWasalt الاثنين.

إحدى القيم: sale, rent, all

group_byالنوع: string · الاستعلام

مجموعة لكل مدينة (الافتراضي) أو حي أو مطوّر أو نوع عقار أو نوع مشروع. تُترك المشاريع التي لا قيمة لها في حقل التجميع، وتُعدّ في projects_ungrouped.

إحدى القيم: city, neighborhood, developer, property_type, project_type

fromالنوع: string · الاستعلام

أول شهر (YYYY-MM). الافتراضي 2026-09، شهر بدء اللقطات (2026-09-26).

toالنوع: string · الاستعلام

آخر شهر (YYYY-MM). الافتراضي الشهر الحالي. 24 شهرًا على الأكثر.

min_sample_sizeالنوع: integer · الاستعلام

تكون أرقام الشهر null حين يقل عدد المشاريع التي لها شهر صالح عن هذا العدد.

الاستجابة

الحقل data كائن بهذه الحقول.

الاسمالوصف
filtersمطلوبالنوع: object
listing_typeمطلوبالنوع: string

إحدى القيم: sale, rent, all

group_byمطلوبالنوع: string

إحدى القيم: city, neighborhood, developer, property_type, project_type

fromمطلوبالنوع: string
toمطلوبالنوع: string
min_sample_sizeمطلوبالنوع: integer
projects_ungroupedمطلوبالنوع: integer
groupsمطلوبالنوع: object[]

مثال على الطلب

cURL
curl "https://api.kite.sa/v1/market/absorption" \  -H "Authorization: Bearer $KITE_API_KEY"
JavaScript (@kite-sa/sdk)
import { Kite } from "@kite-sa/sdk";const kite = new Kite(); // reads KITE_API_KEYconst result = await kite.market.absorption();
Python (kite-sa)
from kite_sa import Kitekite = Kite()  # reads KITE_API_KEYresult = kite.market.absorption()

افتح في المرجع التفاعلي

نقاط نهاية ذات صلة

  • البحث في المشاريع العقاريةGET /projects
  • جلب مشروع عقاريGET /projects/{id}
  • قائمة وحدات مشروعGET /projects/{id}/units
  • توافر وحدات المشروع عبر الزمنGET /projects/{id}/availability
  • البحث في وحدات المشاريعGET /project-units
  • قائمة المطورينGET /developers
  • عرض استيعاب المشروع شهرًا بشهرGET /projects/{id}/absorption

الأدلة

  • البدء السريع
  • البحث والتصفية
  • الحدود والحصص
  • تصفح الصفحات
  • الأخطاء

جاهز لإرسال أول طلب؟ خطة Sandbox مجانية. للأحجام الكبيرة أو الترخيص، تواصل معنا.

احصل على مفتاح APIتواصل معنا
Kite API

بيانات العقارات السعودية للمطوّرين.

المنتج
  • تغطية البيانات
  • الباقات
  • المستثمرون والمطورون
  • فحوصات التقييم
  • التقنية العقارية والتطبيقات
المطورون
  • البدء السريع
  • الأدلة
  • مرجع API
  • خادم MCP
  • مكتبة JavaScript (npm)
  • مكتبة Python (PyPI)
  • سجل التحديثات
  • حالة الخدمة
الشركة
  • kite.sa
  • المدونة
  • تواصل معنا
  • الأمان
الشؤون القانونية
  • الشروط
  • المصادر وحقوق البيانات
  • الخصوصية
  • ملحق معالجة البيانات
  • جهات المعالجة الفرعية
© Kite