>

roomesto.com · English

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

ParametroObbligatorioFormato e limiti
destinationsìNome di città o regione, da 2 a 80 caratteri, per esempio Dubai, Istanbul, Paris (meglio in inglese).
checkinsìData YYYY-MM-DD: oggi o successiva (UTC), al massimo 365 giorni in avanti.
checkoutsìData YYYY-MM-DD, successiva all'arrivo; al massimo 30 notti.
adultsno, predefinito 2Numero intero da 1 a 6.
children_agesnoEtà dei bambini separate da virgole, da 0 a 17, al massimo 4 bambini, per esempio 5,12.
currencyno, predefinito USDUSD, EUR, RUB, GBP, TRY, AED, THB, CNY.
min_pricenoPrezzo per notte nella valuta scelta, da 0 a 100000.
limitno, predefinito 10Numero intero da 1 a 20.
langno, predefinito enLingua 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

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:

Regole d'uso

Altre vie d'accesso