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

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

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

الإعلانات

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

بيانات السوق

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

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

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

التحليلات

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

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

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

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

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

التصدير

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

الإدارة

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

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

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

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

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

الإعلانات

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

بيانات السوق

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

بيانات السوق

ملخص السوق

GET/market/summary

أرقام المدينة أو الأحياء الأساسية: عدد الإعلانات ووسيط السعر وربيعاه ووسيط المساحة والسعر لكل م² وحداثة الإعلانات، والتوزيع حسب نوع العقار وأكثر الأحياء معروضًا والمصدر.

تُحسب على عينة السوق: إعلانات نشطة منزوعة التكرار حُدّثت خلال آخر 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؛ وhofuf إلى al_ahsa)، وكذلك أسماء المدن بالعربية. يبين في الاستجابة وترويسة الاسم المختصر المستخدم.

Kite API

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

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

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

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

التحليلات

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

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

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

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

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

التصدير

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

الإدارة

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

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

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

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

price_basisمطلوبstring

معنى حقول السعر *_sar: yearly_rent بالريال سنويًا للإيجار، وsale_price إجمالي الريال للبيع.

إحدى القيم: yearly_rent, sale_price

price_sourceمطلوبstring

مصدر السعر: asking للأسعار المطلوبة في الإعلانات، وregistered للصفقات أو عقود الإيجار المسجلة. عادة تتجاوز أسعار العرض السعر النهائي المتفق عليه.

إحدى القيم: asking, registered

sample_sizeمطلوبinteger

الإعلانات في العينة.

median_price_sarمطلوبinteger | null

وسيط السعر.

p25_price_sarمطلوبinteger | null

المئين 25 للسعر.

p75_price_sarمطلوبinteger | null

المئين 75 للسعر.

median_area_sqmمطلوبinteger | null

وسيط المساحة بالمتر المربع بين الإعلانات التي تحدد مساحة.

median_price_per_sqm_sarمطلوبinteger | null

وسيط سعر كل إعلان مقسومًا على مساحته.

area_sample_sizeمطلوبinteger

الإعلانات ذات المساحة المعلنة، أساس حساب وسطاء المساحة.

updated_last_3_daysمطلوبinteger
updated_last_7_daysمطلوبinteger
by_property_typeمطلوبobject[]
top_neighborhoodsمطلوبobject[]

حتى 10 أحياء بأكثر إعلانات في العينة.

sourcesمطلوبobject[]

إعلانات العينة بحسب المصدر بعد إزالة التكرار.

windowمطلوبobject

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

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

curl
curl "https://api.kite.sa/v1/market/summary?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.summary({ city: "riyadh", listing_type: "rent" });
Python (kite-sa)
from kite_sa import Kite

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

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

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

  • توزيع الأسعار GET /market/price-distribution
  • توزيع المساحات GET /market/area-distribution
  • المعروض الجديد GET /market/supply
  • مؤشر الشغور GET /market/vacancy
  • الأسعار بحسب الحي GET /market/neighborhoods
  • الإيجار التجاري للمتر المربع بحسب الحي GET /market/commercial-rents

الأدلة

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