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

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

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

الإعلانات

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

بيانات السوق

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

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

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

التحليلات

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

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

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

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

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

التصدير

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

الإدارة

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

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

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

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

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

الإعلانات

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

بيانات السوق

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

التحليلات

العائد الإيجاري الإجمالي

GET/market/rental-yield

العائد الإيجاري الإجمالي، وسيط الإيجار السنوي المطلوب ÷ وسيط سعر البيع المطلوب، لنوع عقار واحد في المدينة أو الأحياء المطلوبة، ولكل حي، الأعلى عائدًا أولًا.

يأتي وسيطا الإيجار والبيع من المجموعة نفسها بحسب النوع والغرف إن حُددت وفي المنطقة نفسها. تُسرد الأحياء إذا بلغ الجانبان min_sample_size. يتجاهل العائد الإجمالي الشغور ورسوم الخدمات والصيانة وتكاليف الصفقة، ويقارن المطلوب لا المتحقق. استخدمه لترتيب المناطق لا تقييم عقار.

يستخدم الجانبان عينة السوق النشطة المنزوعة التكرار والمحدّثة خلال 30 يومًا (updated_at)، بعد تصفية kite.sa نفسها: حدود لوغاريتم السعر وMAD لكل شريحة وفحوص الغرف والمساحة وحد أدنى 30% من وسيط الحي.

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

المعاملات

الاسمالنوعالوصف
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
property_typeمطلوبالاستعلامstring

مطلوب حتى لا تختلط إيجارات وأسعار أنواع مختلفة.

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

bedsالاستعلامinteger

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

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

حصر النتائج في هذه الأحياء بمعرّفات مفصولة بفواصل. غير المعروف يعيد 404.

min_sample_sizeالاستعلامinteger

أقل عدد إعلانات بكل جانب لحساب العائد.

الاستجابة

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

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

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

overallمطلوبobject

المدينة أو الأحياء المطلوبة مجتمعة.

neighborhoodsمطلوبobject[]
price_sourceمطلوبstring

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

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

windowمطلوبobject

نافذة حداثة عينة السوق.

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

curl
curl "https://api.kite.sa/v1/market/rental-yield?city=riyadh&property_type=apartment" \
  -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.rentalYield({ city: "riyadh", property_type: "apartment" });
Python (kite-sa)
from kite_sa import Kite

kite = Kite()  # reads KITE_API_KEY
result = kite.analytics.rental_yield(city="riyadh", property_type="apartment")

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

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

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

الأدلة

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