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

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

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

الإعلانات

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

بيانات السوق

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

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

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

التحليلات

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

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

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

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

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

التصدير

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

الإدارة

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

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

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

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

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

الإعلانات

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

بيانات السوق

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

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

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

التحليلات

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

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

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

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

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

التصدير

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

الإدارة

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

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

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

عرض استيعاب المشروع شهرًا بشهر

GET/projects/{id}/absorption

مدى سرعة خروج الوحدات المعروضة في المشروع، لكل شهر تقويمي: الوحدات المعروضة في بداية الشهر ونهايته، والوحدات الخارجة، والوحدات العائدة والمطروحة، ومعدل الاستيعاب (الوحدات الخارجة ÷ وحدات البداية)، وأشهر المخزون المتبقية بهذه الوتيرة. لكل شهر reliability وflags التي تفسّرها؛ وللمشروع history_days وreliability عامة.

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

أي المشاريع. لا يمكن القياس إلا من مصادر تنشر عددًا للمخزون: جداول وحدات بحالة لكل وحدة (أساس مكين ورسن؛ basis unit_status)، أو عدد متاح معلن (Mada؛ reported_available)، أو عدد الوحدات المدرجة في صفحة المشروع (وصلت وCompoundIn؛ listed_units). عدد الوحدات في بقية المصادر هو حجم المشروع ولا يتحرك مع البيع، فمعظم المشاريع قيمة reliability فيها no_inventory_signal. لا يذكر أي مصدر الوحدات المتاحة بحسب نوع الوحدة، فلا تقسيم بحسب النوع؛ ويفصل listing_type البيع عن الإيجار حيث يفصلهما المصدر. تُقرأ نسخ المشروع الواحد من عدة مصادر مرة واحدة، من المصدر ذي الأساس الأفضل. بدأت اللقطات في 2026-09-26.

ما يُستبعد. تُستبعد من units_gone الحركة التي ليست من السوق، وتُسمّى في flags لكل شهر: قراءتان تفصل بينهما أكثر من 8 أيام (gap)، واختفاء المخزون كله دفعة واحدة دون تعليمه مباعًا أو محجوزًا (withdrawal)، ويوم تغيّر فيه 40% أو أكثر من مشاريع مصدر واحد (source_change)، وفي جداول الوحدات، الوحدات التي تخرج من الجدول دون تعليمها مباعة أو محجوزة (units_removed). خروج المشروع من النشاط أو إسقاط المصدر له ينهي سلسلته، ولا يُقرأ أبدًا على أنه نفاد. تُذكر الوحدات التي تظهر بوصفها units_released (مرحلة جديدة) أو units_re_added، ولا تُطرح أبدًا من الوحدات الخارجة.

تعيد 404 للمشاريع غير النشطة وللنسخ المدمجة في مشروع آخر؛ ويعرض GET /projects/{id}/availability اللقطات اليومية الخام.

المصادقة
أرسل مفتاح بيانات (dk_live_… أو dk_test_…) بصيغة Bearer.
النطاق
projects
التكلفة
10 وحدات لكل طلب

المعاملات

الاسمالوصف
idمطلوبالنوع: integer · المسار

معرّف المشروع.

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

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

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

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

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

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

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

الاستجابة

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

الاسمالوصف
project_idمطلوبالنوع: integer
listing_typeمطلوبالنوع: string

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

fromمطلوبالنوع: string
toمطلوبالنوع: string
basisمطلوبالنوع: string | null

ما يمثله عدد المخزون: unit_status (يعرض المصدر كل وحدة بحالتها)، reported_available (يذكر المصدر عددًا متاحًا)، listed_units (الوحدات المدرجة في صفحة المشروع). null حين لا يذكر أي مصدر لهذا المشروع مخزونًا.

basis_sourceمطلوبالنوع: string | null

المصدر الذي تُقرأ منه السلسلة.

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

usable: شهر واحد صالح على الأقل. short_history: توجد قراءات لكن لا شهر صالحًا بعد (مدة قصيرة أو فجوات أو لا شيء معروض). no_inventory_signal: لا يذكر أي مصدر لهذا المشروع عددًا للمخزون مع listing_type هذا.

إحدى القيم: usable, short_history, no_inventory_signal

history_daysمطلوبالنوع: integer

الأيام من أول قراءة في السلسلة إلى آخرها.

first_observedمطلوبالنوع: string | null
last_observedمطلوبالنوع: string | null
readingsمطلوبالنوع: integer

الأيام التي فيها قراءة للمخزون.

latest_availableمطلوبالنوع: integer | null

الوحدات المعروضة عند آخر قراءة.

usable_monthsمطلوبالنوع: integer
units_gone_per_monthمطلوبالنوع: number | null

الوتيرة في آخر ثلاثة أشهر صالحة (أو أقل)، بالوحدات في الشهر.

months_of_stockمطلوبالنوع: number | null

latest_available ÷ units_gone_per_month. null حين لم يخرج شيء.

monthsمطلوبالنوع: object[]

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

cURL
curl "https://api.kite.sa/v1/projects/4812/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.projects.absorption(4812);
Python (kite-sa)
from kite_sa import Kitekite = Kite()  # reads KITE_API_KEYresult = kite.projects.absorption(4812)

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

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

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

الأدلة

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

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

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

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

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