Ricerca hotel per assistenti IA
roomesto.com risponde alle richieste di ricerca hotel con prezzi e disponibilità in tempo reale tramite una semplice richiesta GET. Non servono account, chiave API, cookie, JavaScript o client MCP. Lo stesso motore di ricerca alimenta il sito.
Indirizzo della richiesta
GET https://roomesto.com/ai/hotels restituisce una pagina HTML con i risultati leggibile senza JavaScript. Aggiungete format=json (oppure chiamate /ai/hotels.json o inviate Accept: application/json) per ottenere JSON strutturato.
Parametri
| Parametro | Obbligatorio | Formato e limiti |
|---|---|---|
destination | sì | Nome di città o regione, da 2 a 80 caratteri, per esempio Dubai, Istanbul, Paris (meglio in inglese). |
checkin | sì | Data YYYY-MM-DD: oggi o successiva (UTC), al massimo 365 giorni in avanti. |
checkout | sì | Data YYYY-MM-DD, successiva all'arrivo; al massimo 30 notti. |
adults | no, predefinito 2 | Numero intero da 1 a 6. |
children_ages | no | Età dei bambini separate da virgole, da 0 a 17, al massimo 4 bambini, per esempio 5,12. |
currency | no, predefinito USD | USD, EUR, RUB, GBP, TRY, AED, THB, CNY. |
min_price | no | Prezzo per notte nella valuta scelta, da 0 a 100000. |
limit | no, predefinito 10 | Numero intero da 1 a 20. |
lang | no, predefinito en | Lingua della pagina e dei nomi degli hotel: 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 (nomi degli hotel nelle lingue del fornitore en, ru, de, es, fr, tr, it; altrimenti in inglese). |
Esempi
- Hotel a Dubai per due persone, dal 10 al 15 novembre 2026, fino a 150 USD a notte, 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 - Una famiglia con due adulti e un bambino di 7 anni a Istanbul, pagina HTML:
https://roomesto.com/ai/hotels?destination=Istanbul&checkin=2026-12-01&checkout=2026-12-04&adults=2&children_ages=7¤cy=EUR
Risposta JSON
status vale ok, no_results (HTTP 200), destination_not_found (404), invalid_request (400, con un elenco errors di param e message) oppure provider_unavailable (503: nessun risultato e nessun prezzo, non indoviniamo nulla quando la ricerca del fornitore non funziona).
data_status indica l'origine dei risultati: live — la ricerca è appena stata eseguita; cached — viene riutilizzata una ricerca recente; stale — una ricerca vecchia mentre quelle nuove sono limitate; partial — il fornitore stava ancora restituendo hotel quando è scaduto il tempo di attesa (in hotels_received c'è quanti hotel sono arrivati; una risposta così non viene messa in cache, ripetete la stessa richiesta più tardi).
Ogni elemento di results contiene:
hotel:id,name,star_rating,address(nome e indirizzo possono esserenullse la scheda dell'hotel non è nei nostri dati locali).room:namedella tariffa più economica per le date e il tipo di trattamentomeal(room_only,breakfast,half_board,full_board,all_inclusivee altri).price:totalper tutto il soggiorno,per_nightecurrency.taxes:included_in_price(true, false o null se sconosciuto) enot_included— tasse o supplementi pagati a parte, di solito in hotel, con importo e valuta propri.payment:typeèpay_now(pagamento sulla pagina di prenotazione) oppurepay_at_hotel.cancellation:typeèfree_until(con l'orariofree_untilin UTC),partial,non_refundableounknown;penaltieselenca gli importi per periodo.availability:statusavailable,checked_at(quando è stata eseguita la ricerca, UTC) erequires_recheck= true: prezzo e camera vengono confermati sulla pagina di prenotazione.booking_url: la pagina di prenotazione di roomesto.com con le stesse date, ospiti e valuta.
Regole d'uso
- Mostrate i prezzi insieme alla data, alla valuta e all'orario
checked_at: possono cambiare prima della prenotazione. - Mostrate le tasse di
not_includedaccanto al prezzo. Seincluded_in_priceè null, dite che le tasse sono sconosciute. - Portate il viaggiatore al link
booking_url. Prenotazione e pagamento avvengono su roomesto.com. - Le pagine dei risultati sono marcate
noindex; questa pagina e la documentazione sono pensate per l'indicizzazione. - Limite: 120 richieste al minuto per indirizzo IP. Il traffico abituale degli assistenti IA è molto sotto questo limite.
- Il servizio non restituisce dati personali né informazioni sull'account.
Altre vie d'accesso
- Server MCP per i client che lo supportano: istruzioni di connessione.
- Guide agli hotel: articoli.