البحث في وحدات المشاريع

GET/project-units

وحدات عبر كل المشاريع: إعلانات نشطة مرتبطة بمشروع، بمرشّحات الوحدة كالغرف والسعر والمساحة والمشروع كالمدينة والمطور والحالة. يظهر الإعلان المرتبط بعدة مشاريع مرة واحدة تحت أقوى رابط. تُستبعد الأسعار المنخفضة بشكل غير معقول للمدينة كالأقساط والأخطاء.

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

المعاملات

الاسم	النوع	الوصف
`city`الاستعلام	`string`	احذفه لتضمين كل المدن.
`neighborhood_id`الاستعلام	`integer[]`	معرّفات الأحياء من GET /cities/{city}/neighborhoods؛ يطابق حي الوحدة، أو حي مشروعها إذا لم يكن لها حي.
`developer`الاستعلام	`string`	اسم المطور المطابق تمامًا كما يعيده GET /developers.
`status`الاستعلام	`string[]`

الاسم	النوع	الوصف
`id`مطلوب	`integer`	معرّف الإعلان؛ يعيد GET /listings/{id} الإعلان الكامل بنطاق `listings`.
`url`مطلوب	`string`	صفحة الإعلان في kite.sa.
`project`مطلوب	`object`
`link`مطلوب	`object`	طريقة ربط الإعلان بالمشروع: `source` إذا ذكره المصدر بثقة 1، أو `geo` داخل حدود المشروع أو بجوارها، أو `text` إذا ذُكر في النص. قد تُضاف أنواع جديدة.
`title`مطلوب	`string \| null`
`listing_type`مطلوب	`string`	إحدى القيم: `sale`, `rent`
`property_type`مطلوب	`string`
`sale_price_sar`مطلوب	`integer \| null`	سعر الشراء الإجمالي بالريال. null للإيجارات.
`yearly_rent_sar`مطلوب	`integer \| null`	الإيجار بالريال سنويًا بعد توحيد المنشور شهريًا أو يوميًا. null لوحدات البيع.
`bedrooms`مطلوب	`integer \| null`
`bathrooms`مطلوب	`integer \| null`
`area_sqm`مطلوب	`number \| null`
`floor`مطلوب	`string \| null`
`location`مطلوب	`object`
`images`مطلوب	`string[]`	حتى ثلاثة روابط صور في CDN كايت.
`source`مطلوب	`object`
`first_seen_at`مطلوب	`string (date-time) \| null`
`last_seen_at`مطلوب	`string (date-time) \| null`

البحث في وحدات المشاريع

المعاملات

الاستجابة

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

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

الأدلة