پرش به مطلب اصلی

جستجوی آگهی‌های دیوار

POST 
/v2/open-platform/finder/post

این API امکان جستجوی آگهی‌های منتشر شده دیوار را با عبارت متنی آزاد، با فیلتر، یا با هر دو فراهم می‌کند. می‌توانید بر اساس دسته‌بندی، شهر، محله و فیلدهای ویژه دسته‌بندی مانند محدوده قیمت، متراژ، تعداد اتاق و سال تولید فیلتر کنید. فیلد اختیاری query_text جستجوی تمام‌متن روی عنوان و محتوای آگهی انجام می‌دهد و همراه با فیلترهای ساختاریافته اعمال می‌شود.

نکات مهم:

  • آگهی‌ها بر اساس زمان آخرین تغییر مرتب می‌شوند
  • فقط آگهی‌های منتشر شده برگردانده می‌شوند
  • query_text اختیاری است؛ اگر ارسال نشود، رفتار قبلی (فقط فیلتر) حفظ می‌شود

دسترسی‌ها:​

مجوزهای API Key مورد نیاز:​
  • SEARCH_POST

Request​

Responses​

پاسخ موفقیت‌آمیز.