>

roomesto.com · English

חיפוש מלונות לעוזרי בינה מלאכותית

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לא, ברירת מחדל 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 מכיל:

כללי שימוש

דרכי גישה נוספות