Ricerca hotel, tariffe e prenotazione
Risolvi una destinazione, elenca le strutture, valida la tariffa e conferma. Un flusso REST, prezzi in USD.
{
"CheckIn": "2026-11-14",
"CheckOut": "2026-11-16",
"CityId": 11111111456928,
"Occupancies": [ { "AdultCount": 2 } ],
"Sort": "price"
}L'inventario alberghiero è enorme e le tariffe cambiano in fretta. Questa API di alloggi offre ricerca pubblica dei luoghi, disponibilità in modalità città e hotel, validazione della tariffa con finestra di blocco e un flusso chiaro: prima prenoti, poi confermi.
Un'unica API di alloggi si pone davanti a milioni di strutture, dalle catene globali alle boutique indipendenti. Disponibilità, trattamenti, politiche di cancellazione e tasse arrivano in un solo formato e valuta, così il tuo sito o la tua app di prenotazione hotel non deve conciliare una dozzina di formati dei fornitori.
Cosa ottieni
La ricerca pubblica dei luoghi si collega direttamente a un campo con completamento automatico.
Un unico endpoint di disponibilità elenca un'intera città o apre un singolo hotel con le sue camere.
Valida la tariffa, blocca la camera, poi conferma e addebita, tutto in USD.
Ricerca per città e per hotel da un unico endpoint, da un'intera destinazione a una singola struttura.
La convalida della tariffa apre una breve finestra di blocco, così il prezzo che mostri è quello che prenoti.
Come funziona il flusso
Resolve
Turn a destination string into a place id with public place search.
Search
List availability for a whole city, or open a single property with its rooms.
Validate
Confirm the live rate and open a short hold window.
Book
Place the order and confirm; your balance is charged on confirmation.
Endpoint principali
/Hotel/PlaceSearchResolve a destination into a place id./v2/Hotel/HotelAvailabilityList availability in city or hotel mode./Hotel/RateValidateValidate the selected rate and hold it./Hotel/HotelBookCreate and confirm the booking./Hotel/BookingDetailsRetrieve a booking and its status.Richiesta e risposta
{
"CheckIn": "2026-11-14",
"CheckOut": "2026-11-16",
"CityId": 11111111456928,
"Occupancies": [ { "AdultCount": 2 } ],
"Sort": "price"
}{
"hotels": [
{
"hotelId": "HTL-9931",
"name": "Marina Suites",
"stars": 4,
"lowestRate": {
"amount": 180.00, "currency": "USD", "board": "BB"
},
"rooms": [ { "code": "DLX-K", "refundable": true } ]
}
]
}Cosa include la risposta
hotelId- Stable id for the property.
lowestRate- Cheapest bookable rate, in USD, with board type.
rooms- Room options with codes and refundability.
cancellationPolicy- Deadlines and penalties that apply to the rate.
hold- Minutes the validated rate stays bookable.
Hotel in tutto il mondo
Domande frequenti
Come trasformo una destinazione in una ricerca?
Chiama la ricerca pubblica dei luoghi per convertire il testo in un id e passalo alla disponibilità.
Quanto dura una tariffa validata?
Quindici minuti. Prenota entro quella finestra con il codice tariffa restituito.
Quando viene addebitato il mio saldo?
Solo quando confermi l'ordine. La prenotazione blocca la camera senza addebitare.
Le tariffe includono tasse e costi?
Sì. Ogni tariffa riporta valuta, trattamento e il dettaglio di tasse e costi, tutto normalizzato in USD.
Posso aprire direttamente una singola struttura?
Sì. La modalità hotel apre una struttura con le sue camere, mentre la modalità città elenca un'intera destinazione.
Costruisci il tuo prodotto di viaggio su un'unica API.
Integrazione gratuita. 1% per biglietto emesso, con tetto di 10 $. Copertura dal vivo di voli, hotel e attività.