Hotel Price Tracker
Il calendario prezzi di Google Hotels mostra, per un hotel, la tariffa più bassa di una notte con arrivo in ogni giorno delle prossime settimane. Lette come una serie temporale, queste tariffe a notte rivelano la differenza tra giorni feriali e weekend, i picchi stagionali e il momento più conveniente per prenotare, e sono utili per monitorare i prezzi, analizzare i ricavi e pianificare i viaggi.
Funzionalità della Hotel Price Tracker API
- Il calendario in righeOgni riga è una data di arrivo; check_out è il giorno seguente, e price.amount, price.currency e un prezzo formattato indicano la tariffa più bassa di quella notte.
- Più settimane per richiestaUna richiesta copre di solito 6–8 settimane di date di arrivo, senza dover interrogare ogni data separatamente.
- Data di inizio a sceltacheck_in fissa l’inizio del calendario e va indicato insieme a check_out; se omesso, il calendario parte da domani.
- Righe identificate per hotel e dataOgni riga contiene hotel_id e name, e id unisce l’ID dell’hotel e la data di arrivo, così è semplice unire esecuzioni ripetute.
Parametri della Hotel Price Tracker API
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
hotel_id | Obbligatorio | ID hotel preso dal campo id di un risultato di Google Hotels API. |
check_in | Facoltativo | Data di inizio del calendario (YYYY-MM-DD, oggi o successiva). Va indicata insieme a check_out; senza entrambe le date, il calendario parte da domani. |
check_out | Facoltativo | Data di partenza (YYYY-MM-DD). Deve seguire check_in; al massimo 30 notti. |
currency | Facoltativo | Codice valuta di tre lettere per le tariffe a notte, ad esempio USD o EUR. |
location_code | Facoltativo | Codice località del mercato di ricerca. Il valore predefinito è 2840 (Stati Uniti). |
language_code | Facoltativo | Codice lingua dei risultati. Il valore predefinito è en. |
Come usare la Hotel Price Tracker API
Invia un ID hotel e leggi una riga per ogni data di arrivo.
- Invia {"hotel_id": "ChoIyKbJ6puqvPf8ARoNL2cvMTFqNHR2MjczeBAB", "currency": "USD"} in POST a /v1/google-hotels/hotel-prices.
- Interroga GET /v1/tasks/{task_id} finché status non diventa succeeded.
- Leggi i prezzi per data in results.items e usa results.next_cursor per la pagina successiva finché has_more è true.
curl -X POST "https://api.socq.ai/v1/google-hotels/hotel-prices" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"hotel_id":"ChoIyKbJ6puqvPf8ARoNL2cvMTFqNHR2MjczeBAB","currency":"USD"}'Casi d’uso della Hotel Price Tracker API
- Trovare la notte più conveniente: Ordina per price.amount e scegli la data di arrivo più economica delle prossime settimane per organizzare il viaggio.
- Giorni feriali o weekend: Raggruppa per giorno della settimana di check_in e calcola quanto costano in più le notti di venerdì e sabato rispetto a quelle feriali.
- Monitoraggio delle variazioni di prezzo: Recupera il calendario a intervalli regolari, confronta il prezzo dello stesso id tra un’esecuzione e l’altra e individua quando un hotel alza o abbassa le tariffe.
- Confronto con la concorrenza: Recupera nella stessa valuta i calendari di più hotel vicini e allineali per check_in per confrontare il vantaggio di prezzo notte per notte.
Consigli degli esperti per la Hotel Price Tracker API
- Salva le righe con l’id che unisce hotel e data di arrivo: così un’esecuzione giornaliera aggiorna la stessa notte invece di creare righe duplicate.
- Per vedere date più lontane, sposta in avanti check_in e ripeti la richiesta.
- Mantieni la stessa currency quando confronti più hotel o più esecuzioni.
- Ogni richiesta costa 4 crediti a prescindere dal numero di date restituite, quindi il calendario conviene rispetto a interrogare una data alla volta.
API correlate
Oltre alla Hotel Price Tracker API, usa queste API quando ti serve un altro tipo di dati pubblici di Google Hotels.
- Google Hotels API — Cerca hotel su Google Hotels per destinazione e ottieni per ciascuno la tariffa a notte per le tue date, le stelle, il voto degli ospiti, il numero di recensioni, le coordinate e l’ID.
- Google Hotel Details API — Apri la scheda di un hotel su Google Hotels tramite il suo ID, con contatti, servizi, punteggi della zona, distribuzione dei voti, temi delle recensioni e offerte per sito di prenotazione.