تحقق من السعر المطلوب لأي منزل (GET /valuations/asking-range) — Kite API
تخطَّ إلى المحتوى
Kiteالمنصة
الباقات
تصفح نقاط النهاية
كل نقاط النهاية

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

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

الإعلانات

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

بيانات السوق

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

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

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

التحليلات

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

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

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

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

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

التصدير

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

الإدارة

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

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

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

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

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

الإعلانات

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

بيانات السوق

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

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

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

التحليلات

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

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

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

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

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

التصدير

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

الإدارة

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

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

التحليلات

تحقق من السعر المطلوب لأي منزل

GET/valuations/asking-range

نطاق السعر المطلوب لمنزل تصفه أنت، من الأسعار المطلوبة لمنازل مشابهة قريبة منه: مثل المقارنات التي يعتمدها المقيّم، لكن لأي وحدة، لا لإعلان منشور على كايت فقط. هذه الأرقام أسعار مطلوبة معلنة لمنازل مشابهة قريبة، وليست إيجارات أو أسعار بيع متحققة، وليست تقييمًا. وعادةً ما تكون الأسعار المطلوبة أعلى مما يُتفق عليه في النهاية.

الإجابات. دائمًا HTTP 200، مع status:

  • estimate: range.low وrange.mid وrange.high (المئين الخامس والعشرون والوسيط والمئين الخامس والسبعون لسعر المتر المطلوب في المقارنات، مضروبة في area_sqm)، وconfidence إما high أو medium.
  • range_only: range.low وrange.high بلا قيمة وسطى، وconfidence هي low. استخدمه نطاقًا لا رقمًا.
  • insufficient_evidence: لا نطاق. ويبقى cohort وcomparables يبيّنان ما وُجد.

تسرد reasons كل رمز ينطبق:

  • location_unresolved: ليس للحي مركز يُبحث منه (أرسل lat/lng).
  • insufficient_comparables: عدد الوحدات المختلفة أو مجموعات الأدلة أقل من الحد الأدنى المعايَر للفئة.
  • dispersion_too_high: أسعار المتر المطلوبة متفاوتة جدًا بحيث لا تحصر الوحدة (معامل التشتت أعلى من 35%).
  • uncalibrated_cohort: لا معايرة منشورة تغطي هذه المدينة ونوع العقار وعدد الغرف ونوع الإعلان، فاستُخدمت إعدادات البحث الافتراضية.
  • neighborhood_only_location: لم تُرسل نقطة، فبُحث في الحي كله.
  • listing_type_not_calibrated: لا يعيد estimate حاليًا إلا rent.
  • median_interval_unavailable وmedian_interval_too_wide: الوسيط غير مستقر بما يكفي لذكره.

الأدلة. للمقارنات المدينة ونوع الإعلان ونوع العقار وعدد الغرف نفسها، ومساحة ضمن نطاق السماح للفئة، وقد اجتازت فحوص كايت للسعر وعدد الغرف والمساحة والنوع والموقع. وكانت معروضة أو رُصدت ضمن فترة الرجوع، وتُحتسب كل وحدة معروضة مرة واحدة (تُدمج المكررات عبر المنصات). مع lat/lng يكون البحث ضمن نصف قطر معايَر حول النقطة؛ ومع neighborhood_id وحده يكون في إعلانات الحي نفسه. يحصر furnished الإيجارات في الإعلانات المفروشة (true) أو يستبعدها (false). وmedian_interval فاصل bootstrap بنسبة 95% لوسيط سعر المتر المطلوب، مضروبًا في area_sqm، يعيد اعتيان مجموعات الأدلة (المشاريع أو خلايا بنحو 100 م) لا الإعلانات المفردة. وrange وmedian_interval وclaimed_price_position كلها على هذا الأساس الواحد.

غير مستخدم. يُقبل age_years وfloor ويُدرجان في inputs_ignored، وكذلك furnished للبيع. الإيجارات المسجّلة للحي مجانية في GET /market/registered-rents (see_also.registered_rents)، ولا تُخلط بهذه الإجابة.

مستويات الثقة مؤقتة (ينتهي methodology_version بـ-provisional) إلى أن تُثبَّت على اختبار مستقبلي منشور على بيانات محجوزة.

تكلفة الاستدعاء 250 وحدة، أيًا كانت status.

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

المعاملات

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

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

neighborhood_idالنوع: integer · الاستعلام

معرّف الحي من GET /cities/{city}/neighborhoods. أرسله، أو lat وlng، أو كليهما. المعرّفات غير المعروفة تعيد 404.

latالنوع: number · الاستعلام

خط عرض المنزل (WGS 84). أرسله مع lng.

lngالنوع: number · الاستعلام

خط طول المنزل (WGS 84). أرسله مع lat.

property_typeمطلوبالنوع: string · الاستعلام

نوع عقار المنزل.

إحدى القيم: apartment, villa, floor, duplex

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

rent (إيجار سنوي) أو sale.

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

bedroomsمطلوبالنوع: integer · الاستعلام

عدد غرف النوم؛ يجب أن يطابقه عدد غرف المقارنات تمامًا.

area_sqmمطلوبالنوع: number · الاستعلام

المساحة المبنية للمنزل بالمتر المربع.

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

للإيجار: true يقارن بالإعلانات المفروشة فقط، وfalse يستبعد الإعلانات المفروشة. يُتجاهل للبيع.

إحدى القيم: true, false

age_yearsالنوع: integer · الاستعلام

عمر المبنى بالسنوات. يُقبل ولا يُستخدم بعد (راجع inputs_ignored).

floorالنوع: integer · الاستعلام

الطابق الذي تقع فيه الوحدة (0 = الأرضي). يُقبل ولا يُستخدم بعد.

claimed_priceالنوع: integer · الاستعلام

سعر يُحدَّد موضعه بين المقارنات (المطلوب أو المعروض أو المتقدَّم به): بالريال سنويًا للإيجار، وبالريال إجمالًا للبيع.

الاستجابة

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

الاسمالوصف
statusمطلوبالنوع: string

estimate أو range_only أو insufficient_evidence. راجع وصف نقطة النهاية.

إحدى القيم: estimate, range_only, insufficient_evidence

reasonsمطلوبالنوع: string[]

لماذا ليست الإجابة في مستوى أعلى؛ فارغة للتقدير غير المقيَّد.

إحدى القيم: location_unresolved, insufficient_comparables, dispersion_too_high, uncalibrated_cohort, neighborhood_only_location, listing_type_not_calibrated, median_interval_unavailable, median_interval_too_wide

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

كل رقم مبني على أسعار مطلوبة معلنة.

إحدى القيم: asking_prices

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

اعرض هذا أينما عرضت الأرقام.

إحدى القيم: These figures are advertised asking prices of similar homes nearby, not achieved rents or sale prices, and not a valuation. Asking prices usually sit above what is finally agreed.

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

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

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

rangeمطلوبالنوع: object | null

مئينات سعر المتر المطلوب في المقارنات مضروبة في area_sqm. null عند insufficient_evidence.

median_intervalمطلوبالنوع: object | null

فاصل cluster-bootstrap بنسبة 95% لوسيط سعر المتر المطلوب في المقارنات، مضروبًا في area_sqm (أساس range). null حين لا نطاق.

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

high أو medium مع التقدير، وlow مع range_only، وnull في غير ذلك.

claimed_price_positionمطلوبالنوع: object | null

null بلا claimed_price أو بلا نطاق.

locationمطلوبالنوع: object | null

null حين تعذّر تحديد الموقع.

cohortمطلوبالنوع: object | null

ما بُحث فيه وما وُجد. null حين يتعذّر تحديد الموقع.

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

حتى 15 مقارنة، الأقرب أولًا.

inputs_ignoredمطلوبالنوع: string[]

مدخلات أرسلتها لم تؤثر في هذه الإجابة.

إحدى القيم: age_years, floor, furnished

methodology_versionمطلوبالنوع: string
see_alsoمطلوبالنوع: object

بيانات مجانية ذات صلة، ليست جزءًا من هذه الإجابة.

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

cURL
curl "https://api.kite.sa/v1/valuations/asking-range?city=riyadh&property_type=apartment&listing_type=rent&bedrooms=3&area_sqm=150" \  -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.valuations.askingRange({ city: "riyadh", property_type: "apartment", listing_type: "rent", bedrooms: 3, area_sqm: 150 });
Python (kite-sa)
from kite_sa import Kitekite = Kite()  # reads KITE_API_KEYresult = kite.valuations.asking_range(city="riyadh", property_type="apartment", listing_type="rent", bedrooms=3, area_sqm=150)

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

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

  • جلب الإعلانات المقارنة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/trends
  • مقارنة الأحياءGET /market/neighborhoods/compare
  • المعلنون بحسب الإعلانات المطابقةGET /advertisers

الأدلة

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

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

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

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

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