Torna alle API
Dati di Google Hotels

Google Hotels Data APIs

Cerca hotel per destinazione, apri la scheda completa di qualsiasi hotel su Google Hotels e recupera il suo calendario prezzi a notte, il tutto collegato da un unico ID hotel.

API di Google Hotels disponibili

Parti da Google Hotels API per trovare hotel e relativi ID, poi usa Google Hotel Details API per la scheda e le offerte di un hotel, oppure Hotel Price Tracker API per i suoi prezzi per data di arrivo.

Quali dati di Google Hotels puoi recuperare?

Ogni riga descrive un hotel o una notte, con prezzi nella valuta scelta e un ID hotel che collega le tre API.

Elenchi di hotel con prezzi

Nome, posizione, tariffa a notte più bassa per le tue date, indicatore di inserzione a pagamento e link alla pagina dell’hotel su Google Hotels.

Voti e recensioni degli ospiti

Stelle, voto medio degli ospiti da 1 a 5, numero di recensioni, quota di ogni voto in stelle e menzioni positive e negative per tema.

Offerte per sito di prenotazione

Prezzo a notte e link di prenotazione di ogni venditore, con indicazione del sito ufficiale, delle offerte a pagamento e della cancellazione gratuita.

Posizione e quartiere

Indirizzo, coordinate, nome del quartiere e punteggi da 1 a 5 per attività, ristoranti, trasporti e accesso all’aeroporto.

Calendario prezzi a notte

La tariffa più bassa per ogni data di arrivo di un hotel, di solito per le prossime 6–8 settimane.

Quale API di Google Hotels usare

Le tre API condividono lo stesso ID hotel, quindi un risultato di ricerca passa direttamente a una richiesta di scheda o di calendario.

APIPunto di partenzaCosa ottieni
Google Hotels APIUna destinazione o il nome di un hotel in queryFino a 140 hotel con tariffa a notte, stelle, voto, numero di recensioni, coordinate e ID
Google Hotel Details APIUn hotel_idUna riga con contatti, servizi, punteggi della zona, distribuzione dei voti, temi delle recensioni e offerte per sito
Hotel Price Tracker APIUn hotel_idUna riga per data di arrivo con la tariffa più bassa della notte, di solito per 6–8 settimane

Come funziona l’API di Google Hotels

Le tre API seguono lo stesso flusso di attività asincrone.

  1. 1. Trova gli hotel

    Invia una destinazione in POST a /v1/google-hotels/search e conserva l’id degli hotel da seguire.

  2. 2. Approfondisci

    Invia un hotel_id a /v1/google-hotels/hotel-details per scheda e offerte, oppure a /v1/google-hotels/hotel-prices per il calendario prezzi.

  3. 3. Leggi i risultati

    Interroga GET /v1/tasks/{task_id} finché status non diventa succeeded, poi leggi le righe di results.items.

Cerca hotel in una destinazione

Autenticati con la tua chiave API SocQ e invia una destinazione. Ogni hotel restituito costa 0,15 crediti.

curl -X POST "https://api.socq.ai/v1/google-hotels/search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"hotels in new york","currency":"USD","results_limit":18}'

# Poll GET /v1/tasks/{task_id}
# Read the hotels in results.items

Casi d’uso comuni dell’API di Google Hotels

Benchmark dei prezzi per destinazione

Confronta le tariffe a notte per stelle e voto tra più città per le stesse date.

Verifica della parità tariffaria

Confronta la tariffa ufficiale di un hotel con le offerte delle agenzie di viaggio online per lo stesso soggiorno.

Monitoraggio della concorrenza

Segui fianco a fianco calendari prezzi, distribuzione dei voti e temi delle recensioni degli hotel vicini.

Contenuti di viaggio e schede hotel

Completa le schede con indirizzo, servizi, orari di check-in, foto e punteggi della zona.

Pianificazione dei viaggi

Trova le date di arrivo più convenienti delle prossime settimane prima di prenotare.

Regole di richiesta e prezzi

Queste regole valgono per tutte e tre le API di Google Hotels.

  • Invia check_in e check_out insieme, nel formato YYYY-MM-DD a partire da oggi, per un soggiorno fino a 30 notti; senza date, i prezzi si riferiscono a una notte a partire da domani.
  • Imposta currency con un codice di tre lettere come USD o EUR per mantenere i prezzi confrontabili tra le richieste.
  • Google Hotels API restituisce da 1 a 140 hotel per richiesta, 18 di default, e costa 0,15 crediti per hotel restituito.
  • Google Hotel Details API usa un hotel_id preso da una ricerca e costa 2 crediti per richiesta.
  • Hotel Price Tracker API usa un hotel_id e costa 4 crediti per richiesta per l’intero calendario.

Domande frequenti sull’API di Google Hotels

Che cos’è Google Hotels API?

Google Hotels API cerca hotel su Google Hotels per destinazione e restituisce le tariffe a notte per le tue date, le stelle, il voto degli ospiti, il numero di recensioni, le coordinate e un ID hotel per le richieste successive.

Quali API di Google Hotels sono disponibili?

Google Hotels API per la ricerca, Google Hotel Details API per la scheda e le offerte per sito di un hotel, e Hotel Price Tracker API per i suoi prezzi per data di arrivo.

Da dove arriva l’hotel_id?

Ogni riga di Google Hotels API contiene l’ID dell’hotel nel campo id. Passa questo valore come hotel_id alle API di scheda e di calendario.

A quali date si riferiscono i prezzi?

Ricerca e scheda usano le tue date check_in e check_out, fino a 30 notti, oppure una notte a partire da domani se le ometti. Il calendario elenca una notte per data di arrivo per circa 6–8 settimane.

Come vengono addebitate le richieste di Google Hotels?

La ricerca costa 0,15 crediti per hotel restituito, la scheda hotel 2 crediti per richiesta e il calendario prezzi 4 crediti per richiesta.

Riunisci in un unico flusso i dati pubblici di profili, contenuti ed engagement di piattaforme diverse per monitorare brand, creator e argomenti e condurre monitoraggi e analisi cross-platform in modo più efficiente.