تحقق من السعر المطلوب لأي منزل
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. تُقبل بلدة داخل منطقة مغطاة وتُحوَّل إلى مدينتها ( |
neighborhood_idالنوع: integer · الاستعلام | معرّف الحي من GET /cities/{city}/neighborhoods. أرسله، أو |
latالنوع: number · الاستعلام | خط عرض المنزل (WGS 84). أرسله مع |
lngالنوع: number · الاستعلام | خط طول المنزل (WGS 84). أرسله مع |
property_typeمطلوبالنوع: string · الاستعلام | نوع عقار المنزل. إحدى القيم: |
listing_typeمطلوبالنوع: string · الاستعلام |
إحدى القيم: |
bedroomsمطلوبالنوع: integer · الاستعلام | عدد غرف النوم؛ يجب أن يطابقه عدد غرف المقارنات تمامًا. |
area_sqmمطلوبالنوع: number · الاستعلام | المساحة المبنية للمنزل بالمتر المربع. |
furnishedالنوع: string · الاستعلام | للإيجار: إحدى القيم: |
age_yearsالنوع: integer · الاستعلام | عمر المبنى بالسنوات. يُقبل ولا يُستخدم بعد (راجع |
floorالنوع: integer · الاستعلام | الطابق الذي تقع فيه الوحدة (0 = الأرضي). يُقبل ولا يُستخدم بعد. |
claimed_priceالنوع: integer · الاستعلام | سعر يُحدَّد موضعه بين المقارنات (المطلوب أو المعروض أو المتقدَّم به): بالريال سنويًا للإيجار، وبالريال إجمالًا للبيع. |
الاستجابة
الحقل data كائن بهذه الحقول.
| الاسم | الوصف |
|---|---|
statusمطلوبالنوع: string |
إحدى القيم: |
reasonsمطلوبالنوع: string[] | لماذا ليست الإجابة في مستوى أعلى؛ فارغة للتقدير غير المقيَّد. إحدى القيم: |
basisمطلوبالنوع: string | كل رقم مبني على أسعار مطلوبة معلنة. إحدى القيم: |
noticeمطلوبالنوع: string | اعرض هذا أينما عرضت الأرقام. إحدى القيم: |
price_basisمطلوبالنوع: string | معنى حقول السعر إحدى القيم: |
rangeمطلوبالنوع: object | null | مئينات سعر المتر المطلوب في المقارنات مضروبة في |
median_intervalمطلوبالنوع: object | null | فاصل cluster-bootstrap بنسبة 95% لوسيط سعر المتر المطلوب في المقارنات، مضروبًا في |
confidenceمطلوبالنوع: string | null |
|
claimed_price_positionمطلوبالنوع: object | null | null بلا |
locationمطلوبالنوع: object | null | null حين تعذّر تحديد الموقع. |
cohortمطلوبالنوع: object | null | ما بُحث فيه وما وُجد. null حين يتعذّر تحديد الموقع. |
comparablesمطلوبالنوع: object[] | حتى 15 مقارنة، الأقرب أولًا. |
inputs_ignoredمطلوبالنوع: string[] | مدخلات أرسلتها لم تؤثر في هذه الإجابة. إحدى القيم: |
methodology_versionمطلوبالنوع: string | |
see_alsoمطلوبالنوع: object | بيانات مجانية ذات صلة، ليست جزءًا من هذه الإجابة. |
نقاط نهاية ذات صلة
- جلب الإعلانات المقارنة
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