البحث في المشاريع العقارية

GET/projects

مشاريع سكنية وتجارية على الخارطة وحديثة البناء من مطورين وبوابات سعودية، بسجل واحد لكل مشروع بعد دمج المصادر. الأسعار أسعار شراء معلنة من المطور بالريال. تصفح بـcursor.

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

المعاملات

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

الاسم	النوع	الوصف
`id`مطلوب	`integer`
`url`مطلوب	`string \| null`	صفحة المشروع في kite.sa.
`name_ar`مطلوب	`string \| null`
`name_en`مطلوب	`string \| null`
`developer`مطلوب	`string \| null`	اسم المطور كما نُشر. أرسله في `developer` للتصفية؛ راجع GET /developers.
`status`مطلوب	`string \| null`	حالة البيع أو البناء؛ null إذا لم يذكرها المصدر.
`project_type`مطلوب	`string \| null`	`off_plan` للبيع قبل الاكتمال أو `ready` للجاهز. null إذا لم يُعرف.
`listing_category`مطلوب	`string`
`location`مطلوب	`object`
`price`مطلوب	`object`	أسعار شراء المطور المعلنة بالريال، إجمالية لا سنوية. null إذا لم تُنشر أو كانت منخفضة بشكل غير معقول.
`area_sqm`مطلوب	`object`	نطاق مساحة الوحدة المعلن بالمتر المربع.
`advertised_unit_count`مطلوب	`integer \| null`	إجمالي وحدات المشروع كما يعلنه المطور.
`linked_units`مطلوب	`object`
`cover_image`مطلوب	`string \| null`	أول صورة في CDN كايت إن نُسخت.
`last_seen_at`مطلوب	`string (date-time) \| null`	آخر تحديث للمشروع من مصدره في كايت.

البحث في المشاريع العقارية

المعاملات

الاستجابة

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

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

الأدلة