التغطية وحداثة البيانات
تجد الأعداد الحية بحسب المصدر والمدينة وعينة قابلة للتنزيل في صفحة التغطية. يشرح هذا الدليل كيفية إنتاج الأرقام، وهي أهم من الأرقام نفسها عند اختيار ما ستبني عليه.
دورية التحديث. يقرأ دارك الإعلانات العامة من كل مصدر مرتين يوميًا. last_seen_at آخر تأكيد لنشاط الإعلان، وupdated_at وقت التحديث في المصدر إن نشره، وإلا فهو last_seen_at.
إعلان واحد لكل عقار. يُعلن العقار نفسه غالبًا في عدة مواقع. يجمع دارك الإعلانات بتشابه الصور باستخدام البصمات الإدراكية، مع الموقع والسعر والمساحة وعدد غرف النوم، ويختار إعلانًا رئيسيًا ويسرد البقية في also_listed_on. لا يحسب البحث والعدّ وإحصاءات السوق إلا الرئيسي، لذلك يكون عدد دارك أقل من مجموع المصادر وأكثر صدقًا.
تصفية الجودة. يستبعد البحث والعدّ وإحصاءات السوق الإعلانات ذات السعر أو المساحة غير المعقولين لمدينتها ونوع عرضها ونوع عقارها. تُحدد حدود السعر لكل شريحة، بحسب غرف النوم للمساكن ونطاق المساحة للتجاري، من وسيط لوغاريتم السعر والانحراف المطلق الوسيط MAD. يقاوم ذلك الإعلانات المصنفة خطأ، كإيجار شهري مسجل كسنوي، التي تؤثر في المئينات. تكملها حدود غرف النوم والمساحة وحد أدنى يساوي 30% من وسيط الحي. يتجاوز جلب التفاصيل والجلب الدفعي هذه التصفية، فيمكن أن يعيد GET /listings/{id} إعلانًا لا يظهر في البحث. الحدود أوسع في المدن الصغيرة لقلة البيانات المستخدمة في المعايرة.
الصور شرط للإتاحة. يتاح الإعلان بعد نسخ صوره إلى CDN دارك، فيظهر الإعلان الجديد بعد ظهوره في المصدر بقليل. وما لا يحصل على صور لا يظهر. تُستثنى الأراضي لشيوع الإعلان عنها دون صور.
الأحياء. تُعيّن من إحداثيات الإعلان واسم الحي لدى المصدر. تقرّب بعض المصادر الإحداثيات أو تغيّرها لحماية الخصوصية، فقد يقع الإعلان خارج حيّه الحقيقي قليلًا. استخدم neighborhood_id الثابت للتصفية، لا lat/lng.
إحصاءات السوق تُحسب على الإعلانات النشطة المحدّثة خلال آخر 30 يومًا بعد تصفية الجودة. تحمل كل استجابة sample_size، وتُحجب الوسطاء إذا كانت العينة أصغر من أن تدعم رقمًا مفيدًا.
السجل التاريخي يبدأ في 2026-03-09، وهذا يحد نطاق price-history ونقاط نهاية الاتجاهات.
ما لا تمثله البيانات. هذه أسعار عرض، لا صفقات؛ ما يطلبه البائعون والمؤجرون، لا ما دفعه أحد. التغطية أعمق في الرياض وجدة والمنطقة الشرقية وأقل في المدن الصغيرة. قد تغيّر المصادر ما تنشره أو تختفي.