مؤشر الشغور (GET /market/vacancy) — Kite API
Kiteالمنصة
الاستخداماتالتوثيقالأدلةالباقات
تصفح نقاط النهاية
كل نقاط النهاية

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

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

الإعلانات

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

بيانات السوق

  • ملخص السوق
  • توزيع الأسعار
  • توزيع المساحات
  • المعروض الجديد
  • مؤشر الشغور
  • الأسعار بحسب الحي
  • الإيجار التجاري للمتر المربع بحسب الحي

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

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

التحليلات

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

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

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

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

  • البحث في المشاريع العقارية
  • جلب مشروع عقاري
  • قائمة وحدات مشروع
  • البحث في وحدات المشاريع
  • قائمة المطورين

التصدير

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

الإدارة

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

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

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

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

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

الإعلانات

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

بيانات السوق

  • ملخص السوق
  • توزيع الأسعار
  • توزيع المساحات
  • المعروض الجديد
  • مؤشر الشغور
  • الأسعار بحسب الحي

بيانات السوق

مؤشر الشغور

GET/market/vacancy

مدة بقاء إعلانات العينة في السوق كمؤشر بديل للشغور؛ الإشغال الفعلي غير مرصود. تُعد الأيام من أول رصد في كايت، فتُقلّل مدة ما سبق ذلك أو سبق تغطية المصدر، ويبدأ الإعلان المنشور مجددًا بمعرّف جديد من الصفر. قارن بين الأحياء والأنواع وعبر الوقت بدل قراءة الأرقام كشغور مطلق.

تُحسب على عينة السوق: إعلانات نشطة منزوعة التكرار حُدّثت خلال آخر 30 يومًا (updated_at)، بعد تصفية القيم الشاذة نفسها المستخدمة في kite.sa: حدود سعر لكل شريحة من وسيط لوغاريتم السعر والانحراف المطلق الوسيط MAD، وفحوص معقولية الغرف والمساحة، وحد أدنى 30% من وسيط الحي. الأسعار هي أسعار العرض بالريال: إيجار سنوي مع listing_type=rent، بعد تحويل الشهري والأسبوعي واليومي، وسعر إجمالي مع listing_type=sale. تحقق من sample_size قبل الاعتماد على الرقم؛ العينات الصغيرة متقلبة.

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

المعاملات

الاسمالنوعالوصف
cityمطلوبالاستعلامstring

اسم المدينة المختصر من GET /cities. تُقبل بلدة داخل منطقة مغطاة وتُحوَّل إلى مدينتها (dammam وkhobar وdhahran وjubail وqatif إلى eastern_province؛ وburaydah وunaizah إلى qassim؛ و إلى )، وكذلك أسماء المدن بالعربية. يبين في الاستجابة وترويسة الاسم المختصر المستخدم.

Kite API

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

المنتج
  • مرجع API
  • تغطية البيانات
  • الباقات
  • فحوصات التقييم
  • سجل التحديثات
  • حالة الخدمة
الشركة
  • kite.sa
  • تواصل معنا
  • الأمان
الشؤون القانونية
  • الشروط
  • جهات المعالجة الفرعية
© Kite
الإيجار التجاري للمتر المربع بحسب الحي

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

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

التحليلات

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

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

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

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

  • البحث في المشاريع العقارية
  • جلب مشروع عقاري
  • قائمة وحدات مشروع
  • البحث في وحدات المشاريع
  • قائمة المطورين

التصدير

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

الإدارة

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

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

hofuf
al_ahsa
filters.city
X-Resolved-City
listing_typeمطلوبالاستعلامstring

rent لأسعار الإيجار السنوي، أو sale لأسعار البيع الإجمالية.

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

listing_categoryالاستعلامstring

الافتراضي residential عند حذف property_type كي لا تختلط المساكن والتجاري في وسيط واحد. مع property_type، احذفه لتضمين فئتي ذلك النوع.

إحدى القيم: residential, commercial

property_typeالاستعلامstring

نوع عقار واحد؛ راجع GET /enums.

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

bedsالاستعلامinteger

عدد غرف النوم المطابق تمامًا؛ 0 للاستوديو.

neighborhood_idالاستعلامinteger[]

حصر النتائج في حي أو أكثر بمعرّفات مفصولة بفواصل من GET /cities/{city}/neighborhoods. تعيد المعرّفات غير المعروفة 404.

الاستجابة

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

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

المرشّحات التي حُسبت لها الأرقام بعد تطبيق الافتراضيات.

sample_sizeمطلوبinteger
median_days_on_marketمطلوبinteger | null
on_market_over_30_daysمطلوبobject
on_market_over_60_daysمطلوبobject
on_market_over_90_daysمطلوبobject
windowمطلوبobject

نافذة الحداثة المستخدمة لكل أرقام السوق.

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

curl
curl "https://api.kite.sa/v1/market/vacancy?city=riyadh&listing_type=rent" \
  -H "Authorization: Bearer $KITE_API_KEY"
JavaScript (@kite-sa/sdk)
import { Kite } from "@kite-sa/sdk";

const kite = new Kite(); // reads KITE_API_KEY
const result = await kite.market.vacancy({ city: "riyadh", listing_type: "rent" });
Python (kite-sa)
from kite_sa import Kite

kite = Kite()  # reads KITE_API_KEY
result = kite.market.vacancy(city="riyadh", listing_type="rent")

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

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

  • ملخص السوق GET /market/summary
  • توزيع الأسعار GET /market/price-distribution
  • توزيع المساحات GET /market/area-distribution
  • المعروض الجديد GET /market/supply
  • الأسعار بحسب الحي GET /market/neighborhoods
  • الإيجار التجاري للمتر المربع بحسب الحي GET /market/commercial-rents

الأدلة

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