Αναζήτηση ξενοδοχείων για βοηθούς 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 | όχι, προεπιλογή 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. Η συνήθης κίνηση των βοηθών AI είναι πολύ κάτω από αυτό το όριο.
- Η υπηρεσία δεν επιστρέφει προσωπικά δεδομένα ούτε πληροφορίες λογαριασμού.
Άλλοι τρόποι πρόσβασης
- Διακομιστής MCP για πελάτες που τον υποστηρίζουν: οδηγός σύνδεσης.
- Οδηγοί ξενοδοχείων: άρθρα.