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.
| API | Punto di partenza | Cosa ottieni |
|---|---|---|
| Google Hotels API | Una destinazione o il nome di un hotel in query | Fino a 140 hotel con tariffa a notte, stelle, voto, numero di recensioni, coordinate e ID |
| Google Hotel Details API | Un hotel_id | Una riga con contatti, servizi, punteggi della zona, distribuzione dei voti, temi delle recensioni e offerte per sito |
| Hotel Price Tracker API | Un hotel_id | Una 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. Trova gli hotel
Invia una destinazione in POST a /v1/google-hotels/search e conserva l’id degli hotel da seguire.
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. Leggi i risultati
Interroga GET /v1/tasks/{task_id} finché status non diventa succeeded, poi leggi le righe di results.items.
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.itemsCasi 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.
Combina i dati di più piattaforme per analisi di business più complete
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.
Brand Monitoring API
Trova le pagine web che citano un brand, un prodotto o un tema, assegna a ciascuna un punteggio di sentiment ed emozione e riassumi come ne parla il web.
AI Search API
Segui come AI Overview, ChatGPT e Google AI Mode rispondono alle domande del tuo mercato: le risposte che citano il tuo brand, quanto sei visibile e quali domini e pagine vengono citati.
Instagram API
Cerca o trova profili pubblici e raccogli con un unico flusso asincrono record degli elenchi di follower, relazioni di seguiti, post pubblicati, post in cui un profilo è taggato, risultati per hashtag, Reels, trascrizioni, commenti, numeri degli account, metriche di engagement e metadati dei media.
TikTok API
Raccogli profili TikTok pubblici supportati, metadati di video diretti, commenti di primo livello, risultati di ricerca dei video e video di hashtag specifici con un unico flusso di lavoro asincrono normalizzato.
YouTube API
Raccogli profili dei canali YouTube pubblici supportati, dettagli dei video, video dei canali, commenti, Shorts, risultati per parola chiave e hashtag e trascrizioni disponibili con un unico flusso di lavoro asincrono normalizzato.
Facebook API
Raccogli profili di pagine Facebook pubbliche, post, post di gruppi, commenti, eventi trovati per parola chiave e trascrizioni disponibili dei video, con campi normalizzati di identità, contenuti, origine, formato, luogo, media, reazioni, partecipazione ed engagement.


