>

roomesto.com · English

Αναζήτηση ξενοδοχείων για βοηθούς AI

Το roomesto.com απαντά σε αναζητήσεις ξενοδοχείων με ζωντανές τιμές και διαθεσιμότητα μέσω απλού αιτήματος GET. Δεν χρειάζονται λογαριασμός, κλειδί API, cookies, 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 περιέχει:

Κανόνες χρήσης

Άλλοι τρόποι πρόσβασης