חיפוש מלונות לעוזרי בינה מלאכותית
roomesto.com עונה לבקשות חיפוש מלונות במחירים ובזמינות חיים באמצעות בקשת GET רגילה. אין צורך בחשבון, במפתח API, בקובצי cookie, ב-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 ללקוחות שתומכים בו: מדריך חיבור.
- מדריכי מלונות: מאמרים.