تصفح الصفحات

تعيد نقاط القوائم صفحة ومعها:

"pagination": { "limit": 25, "next_cursor": "eyJvIjoy….pkFEfJUOpRbZ…", "has_more": true, "result_window_reached": false }

• للحصول على التالية، كرر الطلب بـcursor=<next_cursor> والمعاملات نفسها. يُرفض المؤشر مع مرشّحات أو ترتيب مختلف.
• تعامل مع المؤشر كسلسلة غير قابلة للتفسير، وأعده كما استلمته. المؤشرات موقّعة؛ يُرفض المعدّل أو المصنوع يدويًا بالرمز invalid_cursor، وقد يتغير محتواها مع آلية التصفح.
• تعني result_window_reached: true وجود نتائج إضافية مع بلوغ عمق خطتك. ضيّق الاستعلام بالحي أو السعر أو نوع العقار بدل التصفح أعمق.
• لا يعيد بحث الإعلانات الإجمالي. استخدم GET /listings/count بالمرشّحات نفسها.

تحمل المؤشرات إزاحة؛ مع sort=newest أو ترتيب سعري قد ينقل إعلان أُضيف أو حُذف بين صفحتين صفوفًا عبر الحد، فتتكرر أو تُفقد. هذا من طبيعة تصفح جدول حي، ولذلك تستخدم المزامنة sort=updated_asc؛ راجع مزامنة نسخة محلية.