البحث عن الفنادق لمساعدي الذكاء الاصطناعي
يجيب 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 | لا، الافتراضي USD | USD، 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، وإلا بالإنجليزية). |
أمثلة
- فنادق في دبي لشخصين، من 10 إلى 15 نوفمبر 2026، حتى 150 USD لليلة، JSON:
https://roomesto.com/ai/hotels?destination=Dubai&checkin=2026-11-10&checkout=2026-11-15&adults=2¤cy=USD&max_price=150&format=json - عائلة من شخصين بالغين وطفل عمره 7 سنوات في إسطنبول، صفحة HTML:
https://roomesto.com/ai/hotels?destination=Istanbul&checkin=2026-12-01&checkout=2026-12-04&adults=2&children_ages=7¤cy=EUR
الاستجابة بصيغة 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 يحتوي على:
hotel:idوnameوstar_ratingوaddress(قد يكون الاسم والعنوانnullإذا لم تكن بطاقة الفندق في بياناتنا المحلية).room:nameلأرخص سعر غرفة للتواريخ ونوع الطعامmeal(room_only،breakfast،half_board،full_board،all_inclusiveوغيرها).price:totalلكامل الإقامة وper_nightوcurrency.taxes:included_in_price(true أو false أو null إذا كانت غير معروفة) وnot_included— ضرائب أو رسوم تُدفع منفصلة، عادة في الفندق، ولكل منها مبلغها وعملتها.payment:typeإماpay_now(الدفع في صفحة الحجز) أوpay_at_hotel.cancellation:typeإماfree_until(مع وقتfree_untilبتوقيت UTC) أوpartialأوnon_refundableأوunknown؛ وpenaltiesتسرد المبالغ حسب الفترة.availability:statusavailable، وchecked_at(وقت تنفيذ البحث، UTC)، وrequires_recheck= true: يتم تأكيد السعر والغرفة في صفحة الحجز.booking_url: صفحة الحجز في roomesto.com بالتواريخ والضيوف والعملة نفسها.
قواعد الاستخدام
- اعرض الأسعار مع التاريخ والعملة ووقت
checked_at: فقد تتغير قبل الحجز. - اعرض الضرائب من
not_includedبجانب السعر. وإذا كانتincluded_in_priceتساوي null فقل إن الضرائب غير معروفة. - وجّه المسافر إلى رابط
booking_url. الحجز والدفع يتمّان على roomesto.com. - صفحات النتائج موسومة بـ
noindex؛ وهذه الصفحة والوثائق مخصّصة للفهرسة. - الحد: 120 طلبًا في الدقيقة لكل عنوان IP. حركة مساعدي الذكاء الاصطناعي المعتادة أقل بكثير من هذا الحد.
- لا تعيد الخدمة أي بيانات شخصية أو معلومات حساب.
طرق وصول أخرى
- خادم MCP للعملاء الذين يدعمونه: دليل الاتصال.
- أدلة الفنادق: المقالات.