google-hotels/
hotel-prices

Recupera con un ID hotel il calendario prezzi di Google Hotels: la tariffa a notte più bassa per ogni data di arrivo, di solito per 6–8 settimane dalla data di inizio.

Hotel Price Tracker API

Calendario prezzi giornaliero
Una riga per data di arrivo
Valuta a scelta
Richiesta per ID hotel
4 crediti per richiesta
Pronto
Pronto

Inserisci i parametri e invia una richiesta. Qui compariranno lo stato dell’attività e i risultati normalizzati.

README

A cura di SocQ · Aggiornato il

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

ParametriObbligatorioDescrizione
hotel_idObbligatorioID hotel preso dal campo id di un risultato di Google Hotels API.
check_inFacoltativoData 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_outFacoltativoData di partenza (YYYY-MM-DD). Deve seguire check_in; al massimo 30 notti.
currencyFacoltativoCodice valuta di tre lettere per le tariffe a notte, ad esempio USD o EUR.
location_codeFacoltativoCodice località del mercato di ricerca. Il valore predefinito è 2840 (Stati Uniti).
language_codeFacoltativoCodice 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.

  1. Invia {"hotel_id": "ChoIyKbJ6puqvPf8ARoNL2cvMTFqNHR2MjczeBAB", "currency": "USD"} in POST a /v1/google-hotels/hotel-prices.
  2. Interroga GET /v1/tasks/{task_id} finché status non diventa succeeded.
  3. 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.

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.

Esplora altre piattaforme

Combina i dati di Google Hotels con i dati pubblici delle altre piattaforme social supportate.

Hotel Price Tracker API — FAQ

Hotel Price Tracker API recupera con un ID hotel il calendario prezzi di Google Hotels e restituisce la tariffa a notte più bassa per ogni data di arrivo delle prossime 6–8 settimane circa.

Ogni riga è il prezzo di una notte: check_out è il giorno dopo check_in, e price è la tariffa più bassa di quella notte.

Di solito 6–8 settimane dalla data di inizio. Con check_in parte da quel giorno, altrimenti da domani.

In quella indicata in currency con un codice di tre lettere come USD o EUR. Ogni riga riporta la valuta del proprio prezzo.

4 crediti per richiesta, che restituisce il calendario completo di un hotel.