Google Hotels riunisce in una sola pagina stelle, valutazioni degli ospiti, prezzi per notte e offerte dei siti di prenotazione per una destinazione. Prodotti di viaggio, strumenti di rate shopping e revenue manager vogliono quei dati sotto forma di righe: un elenco di hotel da confrontare, il record completo di una struttura e l’andamento del suo prezzo nelle diverse date.
Il 2026-11-17 SocQ ha lanciato la piattaforma Google Hotels con tre endpoint che fanno proprio questo. Si collegano tra loro tramite un solo campo, l’id dell’hotel. Questa guida spiega cosa restituisce ciascuno, come si fa la richiesta, quanto costa e quando usarlo.
Risposta rapida: cerca una destinazione con
POST /v1/google-hotels/searche conserva l’iddi ogni hotel. Passalo comehotel_idaPOST /v1/google-hotels/hotel-detailsper servizi, temi delle recensioni e offerte dei siti di prenotazione, oppure aPOST /v1/google-hotels/hotel-pricesper il prezzo più basso per notte in base alla data di check-in. InterrogaGET /v1/tasks/{task_id}per i risultati.
I nuovi endpoint di Google Hotels
1 credito SocQ = $0.005.
| Endpoint | Cosa restituisce | Prezzo |
|---|---|---|
| Google Hotels API | Hotel per una destinazione con stelle, valutazione degli ospiti, numero di recensioni, prezzo più basso per notte per le tue date, posizione, foto e id dell’hotel | 0.15 crediti ($0.00075) per hotel |
| Google Hotel Details API | Indirizzo, telefono, sito web, servizi, punteggi della posizione, distribuzione delle valutazioni, temi delle recensioni, valutazioni su altri siti e l’offerta di ogni sito di prenotazione per un hotel | 2 crediti ($0.01) per chiamata |
| Hotel Price Tracker API | Una riga per data di check-in con il prezzo più basso dell’hotel per una notte, di solito per sei-otto settimane di date | 4 crediti ($0.02) per chiamata |
Autenticazione e flusso asincrono delle attività
Tutte le richieste SocQ si autenticano con una chiave API, e lo stesso header vale per l’invio, lo stato dell’attività e le richieste dei risultati:
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Ogni raccolta viene eseguita come attività in background:
submit -> task_id -> queued -> running -> succeeded
\-> failed
La risposta all’invio contiene data.task_id e data.status. Interroga l’attività con quell’ID:
curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=50" \
-H "Authorization: Bearer $SOCQ_API_KEY"
Quando status è succeeded, la risposta include la prima pagina di record normalizzati in data.results.items. limit vale 50 per impostazione predefinita e arriva fino a 500; se has_more è true, passa results.next_cursor come cursor per leggere la pagina successiva. Mentre un’attività è queued, running o failed, l’endpoint restituisce i metadati dell’attività senza results.
Un callback_url facoltativo nel corpo dell’invio fa sì che SocQ invii un’unica POST con un riepilogo al termine dell’attività; leggi i record con GET /v1/tasks/{task_id}. Un timeout lato client non annulla l’attività, quindi riprendi con lo stesso ID invece di pagare un duplicato. 402 indica crediti insufficienti; 429 indica che la chiave ha raggiunto un limite di frequenza o di crediti.
Google Hotels API: cercare una destinazione
La Google Hotels API cerca gli hotel come fanno i viaggiatori su Google. Inserisci una destinazione o una ricerca di hotel in query.
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
}'
Campi facoltativi:
check_inecheck_out(YYYY-MM-DD, indicati insieme, fino a 30 notti) calcolano il prezzo di un soggiorno specifico. Senza di essi, i prezzi si riferiscono a una notte a partire da domani.currency: un codice di tre lettere comeUSDoEUR.sort_by:relevance,lowest_price,highest_ratingomost_reviewed.min_priceemax_price: la fascia di prezzo per notte, nella valuta scelta.location_code(predefinito 2840, Stati Uniti) elanguage_code(predefinitoen).results_limit: da 1 a 140, predefinito 18.
Ogni riga di hotel contiene id, name, stars (da 1 a 5), rating (da 1 a 5), reviews_count, price (amount, currency, formatted), il check_in e il check_out a cui si riferisce il prezzo, is_sponsored, location con latitudine e longitudine, images e il rank nei risultati. I 18 hotel predefiniti costano 2.7 crediti ($0.0135); il massimo di 140 costa 21 crediti ($0.105). Documentazione: ricerca Google Hotels.
Google Hotel Details API: tutto su una struttura
La Google Hotel Details API restituisce una riga con ciò che Google Hotels sa di una struttura. Passa l’id di un risultato di ricerca come hotel_id. Aggiungi check_in e check_out per ottenere le offerte per quelle date; altrimenti le offerte si riferiscono a una notte a partire da domani.
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"
}'
Oltre ai campi della ricerca, la riga dei dettagli compila:
address,phone,website,check_in_time,check_out_timeeamenities.location_scoresda 1 a 5 peroverall,things_to_do,restaurants,transiteairport_access.rating_distribution, la quota di recensioni per ogni numero di stelle.review_topics, come Location o Breakfast, con il numero di menzioni positive, negative e totali.other_reviews, la valutazione e il numero di recensioni dell’hotel su altri siti di recensioni.offers, una per sito di prenotazione, conseller,price,urldi prenotazione,is_official,is_sponsoredefree_cancellation_until.
offers è ciò che serve per i controlli di rate parity: confronta l’offerta ufficiale con quelle delle agenzie di viaggio online per le stesse date. Ogni richiesta costa 2 crediti ($0.01). Un hotel_id sconosciuto non restituisce righe e viene comunque addebitato. Documentazione: Google Hotel Details.
Hotel Price Tracker API: prezzo più basso per data di check-in
La Hotel Price Tracker API restituisce sotto forma di righe il calendario dei prezzi che sta dietro al selettore di date di Google Hotels. Per un hotel ottieni il prezzo più basso per ogni notte di check-in, di solito per sei-otto settimane di date a partire dal tuo check-in.
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"
}'
check_in imposta la prima data del calendario (domani se omesso); indica insieme anche check_out. Ogni riga contiene un id composto da ID dell’hotel e data, hotel_id, name, check_in, check_out e price. Usalo per individuare le notti più economiche per viaggiare, confrontare in un grafico i prezzi del weekend con quelli infrasettimanali o alimentare un report di rate shopping. Ogni richiesta costa 4 crediti ($0.02), qualunque sia il numero di date. Documentazione: Hotel Price Tracker.
Un semplice flusso per il competitive set
- Cerca la destinazione una volta con
sort_by: "most_reviewed"e scegli il tuo competitive set tra i risultati. - Recupera Hotel Details per ogni hotel per confrontare servizi, punteggi della posizione, temi delle recensioni e offerte dei siti di prenotazione.
- Esegui Hotel Price Tracker per ogni hotel a intervalli pianificati e salva ogni riga con il suo
collected_at.
Per un set di 10 hotel scelti da una ricerca predefinita di 18 hotel, un’esecuzione costa 2.7 crediti per la ricerca, 20 crediti per i dettagli e 40 crediti per i calendari dei prezzi: 62.7 crediti, circa $0.31. I prezzi cambiano, quindi considera ogni esecuzione un’istantanea. Per i dati sulle attività locali, come luoghi e recensioni su Google Maps, leggi API per lo scraping di Google Maps.
Domande frequenti (FAQ)
Che cos’è la Google Hotels API?
Un insieme di endpoint SocQ che restituiscono dati di Google Hotels come righe strutturate: risultati di ricerca per una destinazione, dettagli completi di un hotel e un calendario dei prezzi per notte. Sono endpoint di SocQ, non un prodotto ufficiale di Google.
Dove trovo un hotel_id?
Nel campo id dei risultati di ricerca di Google Hotels. Lo stesso valore funziona per Hotel Details e Hotel Price Tracker.
A quali date si riferiscono i prezzi?
Se invii check_in e check_out (YYYY-MM-DD, fino a 30 notti), i prezzi si riferiscono a quel soggiorno. Senza di essi, ricerca e dettagli indicano il prezzo di una notte a partire da domani, e il price tracker fa iniziare il calendario da domani.
Posso ottenere i prezzi in un’altra valuta?
Sì. Invia una currency di tre lettere come EUR. Ogni oggetto prezzo include amount, currency e una stringa formatted come USD 176.
Pago per un hotel_id non valido?
Sì. Hotel Details non restituisce righe per un hotel_id sconosciuto e addebita comunque 2 crediti, quindi verifica prima gli ID con una ricerca recente.
GOOGLE HOTELS API
Prova il flusso di lavoro con un URL pubblico di Google Hotels
Invia input pubblici e ricevi record normalizzati con un contesto di origine tracciabile.
Scopri le API di Google Hotels