>

roomesto.com · English

البحث عن الفنادق لمساعدي الذكاء الاصطناعي

يجيب roomesto.com على طلبات البحث عن الفنادق بأسعار وتوافر حيين عبر طلب GET عادي. لا حاجة إلى حساب أو مفتاح API أو ملفات تعريف الارتباط أو JavaScript أو عميل MCP. محرك البحث نفسه يعمل على الموقع.

عنوان الطلب

يعيد GET https://roomesto.com/ai/hotels صفحة HTML بالنتائج تُقرأ بدون JavaScript. أضف format=json (أو اطلب /ai/hotels.json، أو أرسل Accept: application/json) للحصول على JSON منظّم.

المعاملات

المعاملإلزاميالصيغة والحدود
destinationنعماسم المدينة أو المنطقة، من 2 إلى 80 حرفًا، مثل Dubai أو Istanbul أو Paris (الاسم بالإنجليزية هو الأفضل).
checkinنعمالتاريخ YYYY-MM-DD: اليوم أو لاحقًا (UTC)، بحد أقصى 365 يومًا مقدمًا.
checkoutنعمالتاريخ YYYY-MM-DD، بعد تاريخ الوصول؛ بحد أقصى 30 ليلة.
adultsلا، الافتراضي 2عدد صحيح من 1 إلى 6.
children_agesلاأعمار الأطفال مفصولة بفواصل، من 0 إلى 17، بحد أقصى 4 أطفال، مثل 5,12.
currencyلا، الافتراضي USDUSD، EUR، RUB، GBP، TRY، AED، THB، CNY.
min_priceلاالسعر لكل ليلة بالعملة المطلوبة، من 0 إلى 100000.
limitلا، الافتراضي 10عدد صحيح من 1 إلى 20.
langلا، الافتراضي enلغة الصفحة وأسماء الفنادق: en، ru، de، es، fr، tr، it، zh، ar، ja، ko، pt، nl، sv، no، da، fi، pl، cs، el، he، hi، id، th، vi، uk، ro (أسماء الفنادق بلغات المورّد en وru وde وes وfr وtr وit، وإلا بالإنجليزية).

أمثلة

الاستجابة بصيغة JSON

status هي إحدى القيم ok أو no_results (HTTP 200) أو destination_not_found (404) أو invalid_request (400، مع قائمة errors تتضمن param وmessage) أو provider_unavailable (503: بلا نتائج وبلا أسعار، ولا نخمّن شيئًا عندما يفشل بحث المورّد).

يوضح data_status مصدر النتائج: live — تم تنفيذ البحث الآن؛ cached — أُعيد استخدام بحث حديث؛ stale — بحث قديم بينما البحوث الجديدة محدودة؛ partial — كان المورّد ما زال يعيد فنادق عندما انتهى وقت الانتظار (يوضح hotels_received عدد الفنادق التي وصلت؛ هذه الاستجابة لا تُحفظ في الذاكرة المؤقتة، فأعد الطلب نفسه لاحقًا).

كل عنصر في results يحتوي على:

قواعد الاستخدام

طرق وصول أخرى