ما البيانات التي يمكنني الحصول عليها؟

يُعيد GET /v1/properties صفحة واحدة من العقارات المنشورة لدولة يغطيها مفتاحك. ويحمل كل عقار الحقول التالية:

• المعرّف والدولة ونوع الإعلان ونوع العقار: id، country، listing_type، property_type
• المقاطعة ومعرّفها، والمدينة ومعرّفها، والمنطقة ومعرّفها، والعنوان والرمز البريدي: province، province_id، city، city_id، area، area_id، address، post_code
• إحداثيات الموقع، خط العرض وخط الطول، ودرجة دقة الموقع: latitude، longitude، location_precision
• السعر والسعر الأعلى والعملة: price، price_max، currency
• عدد غرف النوم والحمّامات والغرف: bedrooms، bathrooms، rooms
• المساحة الداخلية، والمساحة الداخلية بالمتر المربع، ومساحة الأرض، ومساحة الأرض بالمتر المربع: living_area، living_area_sqm، lot_area، lot_area_sqm
• سنة البناء وتاريخ النشر وتاريخ آخر تحديث: build_year، published_date، last_updated
• المزايا والأجهزة المنزلية ومعلومات الحي والوسوم: features، appliances، neighbourhood، tags
• المطوّر العقاري والملخّص والوصف ونص وصف الموقع: developer، summary، description، location_text
• الصور: images

تُقدَّم الأوصاف نصًا عاديًا بعد حذف بيانات الاتصال منها. وتُعاد المنازل التي يعرضها مالكوها بموقع تقريبي ومن دون رقم المبنى، ويبيّن الحقل location_precision مدى دقة كل موقع. وتأتي العقارات حاليًا من دون صور: فالحقل images قائمة فارغة إلى أن تُضاف روابط الصور.

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