Zurück zu den APIs
Google-Hotels-Daten

Google Hotels Data APIs

Suchen Sie Hotels nach Reiseziel, öffnen Sie das vollständige Profil eines Hotels bei Google Hotels und rufen Sie seinen Preiskalender ab – alles verbunden über eine Hotel-ID.

Verfügbare Google-Hotels-APIs

Beginnen Sie mit der Google Hotels API, um Hotels und ihre IDs zu finden, und nutzen Sie dann die Google Hotel Details API für Profil und Angebote eines Hotels oder die Hotel Price Tracker API für seine Preise je Anreisetag.

Welche Google-Hotels-Daten können Sie abrufen?

Jede Zeile beschreibt ein Hotel oder eine Nacht, mit Preisen in der gewählten Währung und einer Hotel-ID, die die drei APIs verbindet.

Hotellisten mit Preisen

Name, Rang, günstigster Preis pro Nacht für Ihre Daten, Kennzeichnung bezahlter Platzierungen und Link zur Seite bei Google Hotels.

Bewertungen und Gästestimmen

Sterne, durchschnittliche Gästebewertung von 1 bis 5, Bewertungsanzahl, Anteil jeder Sternebewertung sowie positive und negative Erwähnungen je Thema.

Preise je Buchungsseite

Preis pro Nacht und Buchungslink jedes Anbieters, mit Kennzeichnung von Hotelwebsite, bezahlten Angeboten und kostenloser Stornierung.

Lage und Umgebung

Adresse, Koordinaten, Name des Viertels und Bewertungen von 1 bis 5 für Freizeitangebote, Restaurants, Nahverkehr und Flughafenanbindung.

Preiskalender pro Nacht

Der günstigste Preis je Anreisetag für ein Hotel, meist für die nächsten 6–8 Wochen.

Welche Google-Hotels-API passt

Alle drei APIs nutzen dieselbe Hotel-ID, sodass ein Suchergebnis direkt in eine Detail- oder Kalenderabfrage übergehen kann.

APIAusgangspunktErgebnis
Google Hotels APIEin Reiseziel oder Hotelname in queryBis zu 140 Hotels mit Preis pro Nacht, Sternen, Bewertung, Bewertungsanzahl, Koordinaten und Hotel-ID
Google Hotel Details APIEine hotel_idEine Zeile mit Kontaktdaten, Ausstattung, Lagebewertung, Bewertungsverteilung, Bewertungsthemen und Preisen je Buchungsseite
Hotel Price Tracker APIEine hotel_idEine Zeile je Anreisetag mit dem günstigsten Preis der Nacht, meist für 6–8 Wochen

So funktioniert die Google Hotels API

Alle drei APIs nutzen denselben asynchronen Ablauf.

  1. 1. Hotels finden

    Senden Sie ein Reiseziel per POST an /v1/google-hotels/search und speichern Sie die id der Hotels, die Sie weiterverfolgen möchten.

  2. 2. Tiefer einsteigen

    Senden Sie eine hotel_id an /v1/google-hotels/hotel-details für Profil und Angebote oder an /v1/google-hotels/hotel-prices für den Preiskalender.

  3. 3. Ergebnisse lesen

    Fragen Sie GET /v1/tasks/{task_id} ab, bis status den Wert succeeded hat, und lesen Sie die Zeilen in results.items.

Hotels in einem Reiseziel suchen

Authentifizieren Sie sich mit Ihrem SocQ-API-Schlüssel und senden Sie ein Reiseziel. Jedes zurückgegebene Hotel kostet 0,15 Credits.

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.items

Typische Anwendungsfälle der Google Hotels API

Preis-Benchmarks für Reiseziele

Vergleichen Sie Preise pro Nacht nach Sternen und Bewertung zwischen Städten für dieselben Daten.

Preisparität prüfen

Vergleichen Sie den Direktpreis eines Hotels mit den Angeboten der Online-Reisebüros für denselben Aufenthalt.

Wettbewerber beobachten

Verfolgen Sie Preiskalender, Bewertungsverteilung und Bewertungsthemen benachbarter Hotels nebeneinander.

Reiseinhalte und Hotelseiten

Füllen Sie Hotelseiten mit Adresse, Ausstattung, Check-in-Zeiten, Fotos und Lagebewertung.

Reiseplanung

Finden Sie vor der Buchung die günstigsten Anreisetage der kommenden Wochen.

Anfrageregeln und Preise

Diese Regeln gelten für alle drei Google-Hotels-APIs.

  • Geben Sie check_in und check_out gemeinsam im Format YYYY-MM-DD ab heute an, für bis zu 30 Nächte; ohne beide Daten gelten die Preise für eine Nacht ab morgen.
  • Setzen Sie currency mit einem dreistelligen Code wie USD oder EUR, damit Preise zwischen Anfragen vergleichbar bleiben.
  • Die Google Hotels API liefert 1–140 Hotels pro Anfrage, standardmäßig 18, und kostet 0,15 Credits pro zurückgegebenem Hotel.
  • Die Google Hotel Details API nimmt eine hotel_id aus einem Suchergebnis und kostet 2 Credits pro Anfrage.
  • Die Hotel Price Tracker API nimmt eine hotel_id und kostet 4 Credits pro Anfrage für den gesamten Kalender.

Häufige Fragen zur Google Hotels API

Was ist die Google Hotels API?

Die Google Hotels API durchsucht Google Hotels nach Reiseziel und liefert Hotels mit Preisen pro Nacht für Ihre Daten, Sternen, Gästebewertung, Bewertungsanzahl, Koordinaten und einer Hotel-ID für Folgeabfragen.

Welche Google-Hotels-APIs sind verfügbar?

Die Google Hotels API für die Suche, die Google Hotel Details API für Profil und Preise je Buchungsseite eines Hotels und die Hotel Price Tracker API für seine Preise je Anreisetag.

Woher kommt die hotel_id?

Jede Zeile der Google Hotels API enthält die Hotel-ID im Feld id. Übergeben Sie diesen Wert als hotel_id an die Detail- und die Kalender-API.

Für welche Daten gelten die Preise?

Suche und Details nutzen Ihre check_in- und check_out-Daten bis zu 30 Nächten oder eine Nacht ab morgen, wenn beide fehlen. Der Preiskalender listet eine Nacht je Anreisetag für etwa 6–8 Wochen.

Wie werden Google-Hotels-Anfragen berechnet?

Die Suche kostet 0,15 Credits pro zurückgegebenem Hotel, Hotel Details 2 Credits pro Anfrage und der Preiskalender 4 Credits pro Anfrage.

Führen Sie öffentliche Profile, Inhalte und Interaktionsdaten verschiedener Plattformen in einem Workflow zusammen, um Marken, Creator und Themen zu verfolgen und plattformübergreifend effizienter zu überwachen und zu analysieren.