Darakالمنصة
الاستخداماتالتوثيقالأدلةالباقات
تصفّح الأدلة
الأدلة

ابدأ هنا

  • البدء السريع
  • المصادقة

الذكاء الاصطناعي وMCP

  • ربط مساعد ذكاء اصطناعي
  • البناء باستخدام دارك والذكاء الاصطناعي

عن البيانات

  • ما هو الإعلان العقاري؟
  • التغطية وحداثة البيانات

البناء باستخدام البيانات

  • البحث والتصفية
  • الإشعارات عبر Webhooks
  • مزامنة نسخة محلية
  • التصدير الشامل

التشغيل

  • الحدود والحصص
  • تصفح الصفحات
  • إعادة المحاولة بأمان
  • الأخطاء
  • الإصدارات

السياسات

  • الشروط عمليًا

مرجع API

الأدلة

ابدأ هنا

  • البدء السريع
  • المصادقة

الذكاء الاصطناعي وMCP

  • ربط مساعد ذكاء اصطناعي
  • البناء باستخدام دارك والذكاء الاصطناعي

عن البيانات

  • ما هو الإعلان العقاري؟
  • التغطية وحداثة البيانات

البناء باستخدام البيانات

  • البحث والتصفية
  • الإشعارات عبر Webhooks
  • مزامنة نسخة محلية
  • التصدير الشامل

التشغيل

  • الحدود والحصص
  • تصفح الصفحات
  • إعادة المحاولة بأمان
  • الأخطاء
  • الإصدارات

السياسات

  • الشروط عمليًا

مرجع API

ما هو الإعلان العقاري؟

  • الأسعار. price.yearly_sar هو الرقم القابل للمقارنة: تُحوّل الإيجارات المنشورة شهريًا أو أسبوعيًا أو يوميًا إلى مبلغ سنوي، أما البيع فسعره الإجمالي. يحتفظ price.as_posted بمبلغ المعلن الأصلي وفترته.
  • إعلان واحد لكل عقار. عندما يُنشر العقار نفسه في عدة مصادر، يحتفظ دارك بإعلان واحد ويسرد البقية في also_listed_on.
  • تصفية الجودة. يستبعد البحث والعدّ الأسعار والمساحات غير المعقولة بالتصفية نفسها المستخدمة في darak.app. يتجاوز GET /listings/{id} و/listings/batch هذه التصفية، فيعيدان إعلانات لا تظهر في البحث.
  • الصور شرط للإتاحة. لا يتاح إعلان حتى ينسخ دارك صوره إلى شبكة CDN الخاصة به. يظهر الإعلان الجديد متأخرًا قليلًا، ولا يظهر ما لا يحصل على صور. تُستثنى الأراضي لأن نشرها دون صور شائع. ينطبق ذلك أيضًا على التفاصيل والجلب الدفعي: تعيد الشقة بلا صور 404 ويظهر معرّفها في missing_ids.
  • الحداثة. first_seen_at هو وقت رصد دارك للإعلان أول مرة. updated_at آخر تحديث في المصدر، أو آخر رصد لدى دارك إذا لم ينشر المصدر وقت التحديث. last_seen_at آخر تأكيد بأن الإعلان لا يزال نشطًا.
  • أسعار العرض. أسعار الإعلانات هي المطلوبة، لا أسعار الصفقات. تأتي البيانات من مصادر خارجية وقد تكون ناقصة أو قديمة.
  • نسب المصدر. عند عرض الإعلانات لمستخدميك، انسب البيانات إلى دارك واربط url وانسب الإعلان لمصدره بالاسم (source.name). في الخطط المدفوعة يكون source.url رابطًا في darak.app يحوّل إلى الإعلان الأصلي؛ في الخطة المجانية يكون هو وsource.listing_id بالقيمة null.
Darak API

بيانات العقارات السعودية للمطوّرين.

المنتج
  • مرجع API
  • تغطية البيانات
  • الباقات
  • فحوصات التقييم
  • سجل التحديثات
  • حالة الخدمة
الشركة
  • darak.app
  • تواصل معنا
  • الأمان
الشؤون القانونية
  • الشروط
  • جهات المعالجة الفرعية
© Darak