google-hotels/
hotel-details

Recupera con un ID hotel la scheda completa di un hotel su Google Hotels: contatti, servizi, punteggi della zona, distribuzione dei voti, temi delle recensioni e il prezzo di ogni sito di prenotazione.

Google Hotel Details API

Prezzi per sito di prenotazione
Temi delle recensioni
Distribuzione dei voti
Punteggi della zona
2 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

Google Hotel Details

La scheda di un hotel su Google Hotels riunisce indirizzo, telefono, orari di check-in e servizi con ciò che dicono gli ospiti: la quota di ogni voto in stelle, le menzioni positive e negative su temi come la posizione o la colazione e i voti di altri siti di recensioni. Insieme ai prezzi che ogni sito di prenotazione e il sito ufficiale dell’hotel propongono per lo stesso soggiorno, serve per verificare la parità tariffaria, confrontarsi con la concorrenza e arricchire le schede degli hotel.

Funzionalità della Google Hotel Details API

  • Prezzi per sito di prenotazioneoffers riporta per ogni venditore il prezzo a notte e il link di prenotazione; is_official, is_sponsored e free_cancellation_until indicano la tariffa diretta, le inserzioni a pagamento e le tariffe con cancellazione gratuita.
  • Di cosa parlano gli ospitireview_topics restituisce positive_count, negative_count e mentions_count per temi come Wellness o Breakfast e mostra quali aspetti del soggiorno vengono lodati o criticati.
  • Distribuzione dei voti e altri sitirating_distribution indica la quota di ogni voto in stelle, other_reviews il voto, il numero di recensioni e un estratto da siti come Tripadvisor.
  • Punteggi della zonalocation_scores valuta da 1 a 5 la posizione complessiva, le attività, i ristoranti, i trasporti e l’accesso all’aeroporto, con il nome del quartiere e le coordinate.
  • I dati dell’hotel in una rigaaddress, phone, website, check_in_time, check_out_time, i servizi disponibili, una descrizione e le foto arrivano insieme.
  • Prezzi per le tue datecheck_in, check_out e currency stabiliscono il soggiorno a cui si riferiscono i prezzi; senza date si considera una notte a partire da domani.

Parametri della Google Hotel Details API

ParametriObbligatorioDescrizione
hotel_idObbligatorioID hotel preso dal campo id di un risultato di Google Hotels API.
check_inFacoltativoData di arrivo (YYYY-MM-DD, oggi o successiva). Va indicata insieme a check_out; senza entrambe le date, i prezzi si riferiscono a una notte a partire da domani.
check_outFacoltativoData di partenza (YYYY-MM-DD). Deve seguire check_in; al massimo 30 notti.
currencyFacoltativoCodice valuta di tre lettere per i prezzi, ad esempio USD o EUR.
location_codeFacoltativoCodice località del mercato di ricerca. Il valore predefinito è 2840 (Stati Uniti).
language_codeFacoltativoCodice lingua dei dettagli dell’hotel. Il valore predefinito è en.

Come usare la Google Hotel Details API

Invia un ID ottenuto dalla ricerca di hotel e leggi l’hotel in una sola riga.

  1. Invia {"hotel_id": "ChoIyKbJ6puqvPf8ARoNL2cvMTFqNHR2MjczeBAB", "currency": "USD"} in POST a /v1/google-hotels/hotel-details.
  2. Interroga GET /v1/tasks/{task_id} finché status non diventa succeeded.
  3. Leggi l’hotel in results.items. has_more e results.next_cursor seguono le normali regole di paginazione e restano vuoti per questo risultato di una sola riga.
curl -X POST "https://api.socq.ai/v1/google-hotels/hotel-details" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"hotel_id":"ChoIyKbJ6puqvPf8ARoNL2cvMTFqNHR2MjczeBAB","currency":"USD"}'

Casi d’uso della Google Hotel Details API

  • Verifica della parità tariffaria: Confronta la tariffa diretta contrassegnata da is_official con i prezzi delle agenzie di viaggio online per le stesse date e individua i venditori che propongono l’hotel a meno.
  • Confronto con la concorrenza: Affianca rating_distribution, review_topics e location_scores di hotel vicini per vedere dove una struttura è in vantaggio e dove resta indietro.
  • Schede hotel complete: Recupera con una sola richiesta indirizzo, servizi, orari di check-in, foto e punteggi della zona per arricchire le schede hotel di un servizio di viaggi.
  • Analisi delle opinioni degli ospiti: Ordina review_topics per negative_count per far emergere i temi con più lamentele, come il rumore o la colazione.

Consigli degli esperti per la Google Hotel Details API

  • Usa ID provenienti da una ricerca recente con Google Hotels API, così ogni richiesta da 2 crediti restituisce l’hotel atteso.
  • Riprendi gli stessi check_in, check_out e currency della ricerca, così i prezzi dei venditori corrispondono al prezzo dell’elenco.
  • Escludi le inserzioni a pagamento con is_sponsored prima di confrontare i venditori, per un confronto equilibrato.
  • Tratta rating_distribution.share come una quota tra 0 e 1 quando rappresenti la distribuzione dei voti in un grafico.

Oltre alla Google Hotel Details 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.
  • Hotel Price Tracker API — Recupera con un ID hotel il calendario prezzi di Google Hotels, con la tariffa a notte più bassa per ogni data di arrivo nelle prossime 6–8 settimane circa.

Esplora altre piattaforme

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

Google Hotel Details API — FAQ

Google Hotel Details API recupera con un ID hotel la scheda di un hotel su Google Hotels e restituisce contatti, servizi, punteggi della zona, distribuzione dei voti, temi delle recensioni, voti di altri siti e il prezzo di ogni sito di prenotazione.

Ogni riga restituita da Google Hotels API contiene l’ID dell’hotel nel campo id: è questo il valore da passare in hotel_id.

I siti di prenotazione che Google Hotels mostra per il soggiorno. Quando partecipa il sito ufficiale dell’hotel, compare anch’esso ed è contrassegnato da is_official.

rating_distribution mostra la quota di ogni voto in stelle, review_topics le menzioni positive e negative per tema, e other_reviews aggiunge voti ed estratti di siti di recensioni esterni.

Ogni richiesta costa 2 crediti e restituisce l’hotel corrispondente all’hotel_id inviato.