>

roomesto.com · English

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नहीं, डिफ़ॉल्ट 21 से 6 तक पूर्णांक।
children_agesनहींबच्चों की उम्र अल्पविराम से अलग, 0 से 17, अधिकतम 4 बच्चे, उदाहरण 5,12।
currencyनहीं, डिफ़ॉल्ट USDUSD, EUR, RUB, GBP, TRY, AED, THB, CNY।
min_priceनहींचुनी गई मुद्रा में प्रति रात कीमत, 0 से 100000।
limitनहीं, डिफ़ॉल्ट 101 से 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, जिसमें param और message वाली errors सूची होती है) या provider_unavailable (503: नतीजे नहीं और कीमतें नहीं, आपूर्तिकर्ता की खोज विफल होने पर हम कुछ भी अनुमान नहीं लगाते)।

data_status बताता है कि नतीजे कहाँ से आए: live — खोज अभी चली; cached — हाल की खोज दोबारा उपयोग हुई; stale — नई खोजें सीमित होने पर पुरानी खोज; partial — प्रतीक्षा समय ख़त्म होने पर आपूर्तिकर्ता अभी भी होटल भेज रहा था (hotels_received बताता है कि कितने होटल आए; ऐसा उत्तर कैश नहीं होता, वही अनुरोध बाद में दोहराएँ)।

results का हर तत्व इन्हें रखता है:

उपयोग के नियम

पहुँचने के अन्य तरीके