AI सहायकों के लिए होटल खोज
roomesto.com होटल खोज के अनुरोधों का जवाब ताज़ा कीमतों और उपलब्धता के साथ साधारण GET अनुरोध से देता है। खाता, API कुंजी, कुकीज़, JavaScript या MCP क्लाइंट की ज़रूरत नहीं है। साइट पर वही खोज इंजन चलता है।
अनुरोध का पता
GET https://roomesto.com/ai/hotels एक HTML परिणाम पृष्ठ देता है जो JavaScript के बिना पढ़ा जा सकता है। संरचित JSON पाने के लिए format=json जोड़ें (या /ai/hotels.json माँगें, या Accept: application/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, जिसमें param और message वाली errors सूची होती है) या 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(UTC मेंfree_untilसमय के साथ),partial,non_refundableयाunknown;penaltiesअवधि के अनुसार राशियाँ बताता है।availability:statusavailable,checked_at(खोज कब चली, UTC) औरrequires_recheck= true: कीमत और कमरा बुकिंग पृष्ठ पर पुष्ट होते हैं।booking_url: उन्हीं तारीख़ों, मेहमानों और मुद्रा वाला roomesto.com का बुकिंग पृष्ठ।
उपयोग के नियम
- कीमतें तारीख़, मुद्रा और
checked_atसमय के साथ दिखाएँ: बुकिंग से पहले वे बदल सकती हैं। not_includedवाले कर कीमत के पास दिखाएँ। अगरincluded_in_pricenull है तो बताएँ कि कर अज्ञात हैं।- यात्री को
booking_urlलिंक पर भेजें। बुकिंग और भुगतान roomesto.com पर होते हैं। - परिणाम पृष्ठों पर
noindexलगा है; अनुक्रमण के लिए यह पृष्ठ और दस्तावेज़ हैं। - सीमा: प्रति IP पता प्रति मिनट 120 अनुरोध। AI सहायकों का सामान्य ट्रैफ़िक इस सीमा से काफ़ी कम है।
- सेवा कोई व्यक्तिगत डेटा या खाता जानकारी नहीं लौटाती।
पहुँचने के अन्य तरीके
- जो क्लाइंट इसे सहयोग करते हैं उनके लिए MCP सर्वर: कनेक्शन गाइड।
- होटल गाइड: लेख।