نطاق أسعار العرض القريبة لإعلان

GET/listings/{id}/price-band

المئين 25 والوسيط والمئين 75 لأسعار الوحدات المقارنة القريبة، بالريال ولكل م²، وموقع سعر الإعلان بينها، والمجموعة والاستقرار الداعمان. استخدمه لفحص معقولية سعر مطلوب؛ يقارن أسعار العرض وليس تقييمًا عقاريًا.

النطاق من مقارنة كايت المنشورة لأسعار العرض القريبة بمنهجية nearby-asking-v5، وهي اللقطة نفسها في صفحة الإعلان وGET /market/below-market، فتتفق الثلاثة.

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

يمثل p25–p75 النصف الأوسط لأسعار العرض القريبة، لا تقييمًا أو تثمينًا أو سعرًا متوقعًا للصفقة. الأسعار بالريال، سنوية للإيجار بعد تحويل الشهري والأسبوعي واليومي، وإجمالية للبيع. تُحدّث اللقطات أسبوعيًا على الأقل وتُلغى بمجرد تغير السعر أو الغرف أو النوع.

يجيب GET /listings/{id}/market-position دائمًا مقارنة بالحي والمدينة كاملين. هذه النقطة تجيب لمجموعة قريبة مماثلة فقط وإلا تشرح السبب. status هو available عند وجود نطاق؛ وإلا تكون band وposition وstability بالقيمة null ويحدد status السبب:

insufficient_comparables: المجموعة منشورة لكن الوحدات القريبة قليلة. يبين cohort البحث وما وُجد.
unsupported_cohort: لم تجتز مجموعة المدينة والنوع والغرف ونوع العرض المعايرة، فلا تُنشر مقارنة.
not_residential وmulti_unit لتسعير عدة وحدات معًا وno_price و: لا يمكن مقارنة الإعلان.

الاسم	النوع	الوصف
`listing_id`مطلوب	`integer`
`status`مطلوب	`string`	`available` أو سبب غياب النطاق. راجع وصف نقطة النهاية. إحدى القيم: `available`, `insufficient_comparables`, `unsupported_cohort`, `not_residential`, `multi_unit`, `no_price`, `no_location`, `plot_area_only`, `area_unusable`, `fields_unusable`
`price_basis`مطلوب	`string`	معنى حقول السعر `*_sar`: `yearly_rent` بالريال سنويًا للإيجار، و`sale_price` إجمالي الريال للبيع. إحدى القيم: `yearly_rent`, `sale_price`
`price_source`مطلوب	`string`	مصدر السعر: `asking` للأسعار المطلوبة في الإعلانات، و`registered` للصفقات أو عقود الإيجار المسجلة. عادة تتجاوز أسعار العرض السعر النهائي المتفق عليه. إحدى القيم: `asking`, `registered`
`price_sar`مطلوب	`integer \| null`	السعر المطلوب لهذا الإعلان.
`price_per_sqm_sar`مطلوب	`integer \| null`	سعر العرض لكل م²؛ null ما لم تجتز المساحة الفحوص.
`band`مطلوب	`object \| null`	null إلا إذا كان `status` هو `available`.
`position`مطلوب	`object \| null`	null إلا إذا كان `status` هو `available`.
`stability`مطلوب	`object \| null`	null إلا إذا كان `status` هو `available`.
`cohort`مطلوب	`object \| null`	المقارنة المنفذة؛ null إن لم تُنفّذ بسبب `unsupported_cohort` أو سبب متعلق بالإعلان.
`methodology`مطلوب	`object \| null`	null إذا لم تُنفّذ مقارنة.

نطاق أسعار العرض القريبة لإعلان

المعاملات

الاستجابة

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

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

الأدلة