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
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
query | Obbligatorio | Ricerca per destinazione o hotel, ad esempio hotels in new york o il nome di un hotel. |
check_in | Facoltativo | Data 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_out | Facoltativo | Data di partenza (YYYY-MM-DD). Deve seguire check_in; al massimo 30 notti. |
currency | Facoltativo | Codice valuta di tre lettere per i prezzi e la fascia di prezzo, ad esempio USD o EUR. |
sort_by | Facoltativo | Ordinamento: relevance, lowest_price, highest_rating o most_reviewed. |
min_price | Facoltativo | Prezzo minimo a notte, nella valuta di currency. |
max_price | Facoltativo | Prezzo massimo a notte, nella valuta di currency. Non può essere inferiore a min_price. |
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. |
results_limit | Facoltativo | Numero 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.
- Invia {"query": "hotels in new york", "currency": "USD", "results_limit": 18} in POST a /v1/google-hotels/search.
- Interroga GET /v1/tasks/{task_id} finché status non diventa succeeded.
- 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.
API correlate
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.