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

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

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

الإعلانات

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

بيانات السوق

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

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

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

التحليلات

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

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

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

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

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

التصدير

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

الإدارة

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

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

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

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

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

الإعلانات

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

بيانات السوق

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

التحليلات

اتجاهات الأسعار

GET/market/trends

أسعار العرض شهريًا خلال الأشهر الأخيرة، حتى 36، للمدينة أو حتى خمسة أحياء بسلسلة لكل منها: الوسيط والربيعات لمستوى السعر، ومؤشر أسعار بجودة ثابتة (price_index) للتغير عبر الزمن. الوسيط ليس مؤشر أسعار؛ راجع المنهجية.

يُحسب من سجل الإعلانات لا إعلانات اليوم: كل ما سجله كايت بما فيه المؤجر والمباع والمزال، وكل تغير سعري بسعره الساري وقتها لا سعره الحالي.

  • on_market الافتراضي: يُعد الإعلان إذا كان نشطًا في أي وقت من الشهر، برصد أول قبل نهايته وبقائه نشطًا أو آخر رصد عند بداية الشهر أو بعدها، بسعر نهاية الشهر أو آخر رصد إذا اختفى قبله.
  • new_listings: يُعد في شهر أول رصد لدى كايت بأول سعر مطلوب مسجل.

تُزال نسخ المصادر وتُطبق تصفية القيم الشاذة الحالية بحدود اليوم، لا نافذة الحداثة 30 يومًا التي لا تخص التاريخ. الأسعار مطلوبة بالريال، سنوية للإيجار بعد تحويل الشهري والأسبوعي واليومي وإجمالية للبيع. الوسطاء والربيعات null دون 5 إعلانات؛ تحقق من sample_size.

الوسيط ليس مؤشر أسعار. تتجمع أسعار العرض عند أرقام مدورة، فقد يبقى الوسيط الشهري على الرقم نفسه شهورًا بينما تتحرك الأسعار (شقق الإيجار في الرياض: 45,000 ريال في كل شهر من مارس إلى نوفمبر 2026)، ويتحرك حين يتغير مزيج المعروض وإن لم يتغير أي سعر. استخدم price_index للتغير عبر الزمن، والوسيط والربيعات لمستوى السعر.

price_index مؤشر بجودة ثابتة (السلة نفسها)، قيمته 100 في index_base_month، أول شهر في النافذة فيه بيانات كافية. تُجمع الإعلانات في خلايا: الحي × نوع العقار × عدد الغرف (0-4، أو 5+، أو غير مذكور). تُحتسب الخلية في الشهر إذا ضمت 5 إعلانات على الأقل، ومستواها المتوسط الهندسي لأسعارها. يُربط كل شهر بآخر شهر سابق له قيمة عبر الخلايا الموجودة في الاثنين، بوزن أصغر العددين لكل خلية، ثم تُضرب الروابط. دخول خلية أو خروجها لا يحرك المؤشر، فلا يُقرأ تغير المزيج تغيرًا في السعر. يحتاج الرابط 100 إعلان مطابق (index_sample_size)؛ دونها يكون price_index للشهر null ويُربط الشهر التالي بآخر شهر له قيمة. السلسلة التي لا يجتاز فيها أي رابط null بالكامل. الإعلانات بلا حي خارج المؤشر. لأنواع العقار بلا غرف (الأراضي ومعظم التجاري) الخلية هي الحي × نوع العقار، فقد يظهر في المؤشر تغير مساحات القطع أو الوحدات المعروضة داخل الحي. مع يُبنى مؤشر كل حي من خلاياه وحدها، وكثيرًا ما يكون null للأحياء الصغيرة. يستخدم المؤشر الإعلانات والأسعار والتصفية نفسها التي يستخدمها الوسيط، مع أي .

Kite API

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

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

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

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

التحليلات

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

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

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

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

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

التصدير

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

الإدارة

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

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

neighborhood_id
basis

يبدأ السجل في 2026-03-09 ولا يمكن إعادة بناء ما قبله. يمكنك طلب حتى 36 شهرًا، لكن ما قبل مارس 2026 فارغ مع coverage: "no_history". مارس نفسه history_start جزئي، وتعد new_listings كل المعروض الموجود في 2026-03-09 جديدًا في الشهر. أضاف كايت مصادر مع الوقت فتقل تغطية الأشهر الأولى وقد يعكس التغير التغطية والأسعار معًا. الحالي in_progress وpartial؛ يستخدم change_pct وindex_change_pct الأشهر complete فقط.

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

المعاملات

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

اسم المدينة المختصر من GET /cities. تُقبل بلدة داخل منطقة مغطاة وتُحوَّل إلى مدينتها (dammam وkhobar وdhahran وjubail وqatif إلى eastern_province؛ وburaydah وunaizah إلى qassim؛ و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[]

سلسلة لكل حي بمعرّفات مفصولة بفواصل حتى 5. احذفه لسلسلة المدينة. غير المعروف يعيد 404.

monthsالاستعلامinteger

أشهر تقويمية تنتهي بالحالي حتى 36؛ يبدأ السجل 2026-03-09، وما قبله يعود بـcoverage: "no_history".

basisالاستعلامstring

on_market للنشط خلال الشهر بسعره حينها. وnew_listings لأول رصد فيه بأول سعر مطلوب.

إحدى القيم: on_market, new_listings

الاستجابة

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

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

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

price_basisمطلوبstring

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

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

price_sourceمطلوبstring

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

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

basisمطلوبstring

إحدى القيم: on_market, new_listings

seriesمطلوبobject[]
historyمطلوبobject

بداية سجل الإعلانات المستخدم لهذه السلاسل.

methodologyمطلوبstring

كيفية حساب الأرقام.

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

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

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

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

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

  • جلب الإعلانات المقارنة GET /listings/{id}/comparables
  • موقع سعر الإعلان في السوق GET /listings/{id}/market-position
  • نطاق أسعار العرض القريبة لإعلان GET /listings/{id}/price-band
  • إعلانات أقل من أسعار السوق GET /market/below-market
  • إعلانات أقل من أسعار السوق (المسار القديم) GET /market/deals
  • العائد الإيجاري الإجمالي GET /market/rental-yield
  • مقارنة الأحياء GET /market/neighborhoods/compare

الأدلة

  • البدء السريع
  • ما هو الإعلان العقاري؟
  • التغطية وحداثة البيانات
  • الحدود والحصص
  • الأخطاء