google-hotels/
search

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 un ID per le richieste successive.

Google Hotels API

Ricerca per destinazione
Prezzi per le tue date
Stelle e voto degli ospiti
ID hotel riutilizzabile
0,15 crediti per risultato
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 Hotels

Un risultato di ricerca su Google Hotels riunisce nome, categoria e posizione di un hotel con il voto degli ospiti, il numero di recensioni, le foto e la tariffa a notte più bassa per le date e la valuta scelte. Messi uno accanto all’altro, questi dati mostrano come cambia l’offerta alberghiera tra le destinazioni, come si bilanciano prezzo e voto e quali strutture meritano un esame più approfondito.

Funzionalità della Google Hotels API

  • Cercare come un viaggiatorequery accetta destinazioni come hotels in new york o il nome di un hotel; gli hotel arrivano nell’ordine in cui li mostra Google Hotels e rank indica la posizione di ciascuno.
  • Prezzi per un soggiorno realecheck_in, check_out e currency definiscono il soggiorno che ti interessa; ogni riga riporta quelle date insieme a price.amount, price.currency e un prezzo formattato.
  • Ordinamento e fascia di prezzosort_by passa tra relevance, lowest_price, highest_rating e most_reviewed, mentre min_price e max_price lasciano solo gli hotel nel tuo budget.
  • Indicatori di qualità per ogni hotelstars è la categoria dell’hotel, rating il voto medio degli ospiti da 1 a 5 e reviews_count il numero di recensioni su cui si basa.
  • Coordinate e fotolocation fornisce latitudine e longitudine, images le foto che Google mostra per l’hotel.
  • ID hotel per le richieste successiveL’id di ogni riga si passa così com’è a Google Hotel Details API e a Hotel Price Tracker API, e url rimanda alla pagina dell’hotel su Google Hotels.
  • Fino a 140 hotel per richiestaresults_limit va da 1 a 140, e is_sponsored separa le inserzioni a pagamento dai risultati normali.

Parametri della Google Hotels API

ParametriObbligatorioDescrizione
queryObbligatorioRicerca per destinazione o hotel, ad esempio hotels in new york o il nome di un hotel.
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 e la fascia di prezzo, ad esempio USD o EUR.
sort_byFacoltativoOrdinamento: relevance, lowest_price, highest_rating o most_reviewed.
min_priceFacoltativoPrezzo minimo a notte, nella valuta di currency.
max_priceFacoltativoPrezzo massimo a notte, nella valuta di currency. Non può essere inferiore a min_price.
location_codeFacoltativoCodice località del mercato di ricerca. Il valore predefinito è 2840 (Stati Uniti).
language_codeFacoltativoCodice lingua dei risultati. Il valore predefinito è en.
results_limitFacoltativoNumero di hotel restituiti (1–140). Il valore predefinito è 18.

Come usare la Google Hotels API

Cerca una destinazione e leggi gli hotel riga per riga.

  1. Invia {"query": "hotels in new york", "currency": "USD", "results_limit": 18} in POST a /v1/google-hotels/search.
  2. Interroga GET /v1/tasks/{task_id} finché status non diventa succeeded.
  3. Leggi gli hotel 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/search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"hotels in new york","currency":"USD","results_limit":18}'

Casi d’uso della Google Hotels API

  • Livello dei prezzi di una destinazione: Affianca price.amount a stars e rating per le stesse date e colloca i prezzi alberghieri di una città per categoria.
  • Selezione degli hotel: Tieni gli hotel nella tua fascia di prezzo con rating e reviews_count sopra la soglia e passa il loro id alle richieste di dettagli e di prezzi.
  • Confronto tra date di viaggio: Ripeti la stessa query cambiando check_in e check_out e unisci i risultati per id per vedere come variano i prezzi tra le date.
  • Mappa dell’offerta alberghiera: Sovrapponi stars e prezzi alle coordinate di location per vedere dove si concentrano gli hotel economici e quelli di lusso in una zona.

Consigli degli esperti per la Google Hotels API

  • Indica sempre currency nelle ricerche da confrontare, così price.amount è espresso nella stessa unità.
  • Invia check_in e check_out sempre insieme. Soggiorni oltre 30 notti o con partenza prima dell’arrivo vengono rifiutati prima che la richiesta venga creata.
  • Collega le richieste successive tramite id e non tramite il nome: gli hotel di una stessa catena in una città hanno spesso nomi quasi identici.
  • Ogni hotel restituito costa 0,15 crediti, quindi imposta results_limit sul numero di hotel che esaminerai davvero.

Oltre alla Google Hotels API, usa queste API quando ti serve un altro tipo di dati pubblici di Google Hotels.

  • 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.
  • 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 Hotels API — FAQ

Google Hotels API cerca hotel su Google Hotels per destinazione o nome e restituisce per ciascuno la tariffa a notte per le tue date, le stelle, il voto degli ospiti, il numero di recensioni, le coordinate, le foto e un ID hotel.

Alle date check_in e check_out che indichi, fino a un massimo di 30 notti. Senza entrambe le date, i prezzi si riferiscono a una notte a partire da domani; ogni riga riporta le date del suo prezzo.

Sì. min_price e max_price delimitano il prezzo a notte, e sort_by ordina per relevance, lowest_price, highest_rating o most_reviewed.

La ricerca restituisce i campi di un elenco. Passa l’id di un hotel a Google Hotel Details API per indirizzo, servizi, temi delle recensioni e prezzi per sito di prenotazione, oppure a Hotel Price Tracker API per i prezzi per data di arrivo.

0,15 crediti per hotel restituito, cioè 2,7 crediti per 18 hotel. Le ricerche che non trovano alcun hotel non vengono addebitate.