google-hotels/
hotel-prices

Rufen Sie mit einer Hotel-ID den Preiskalender von Google Hotels ab: den günstigsten Preis pro Nacht für jeden Anreisetag, meist für 6–8 Wochen ab dem Startdatum.

Hotel Price Tracker API

Preiskalender pro Tag
Eine Zeile je Anreisetag
Wählbare Währung
Abfrage per Hotel-ID
4 Credits pro Anfrage
Bereit
Bereit

Geben Sie Parameter ein und senden Sie eine Anfrage. Aufgabenstatus und normalisierte Ergebnisse erscheinen hier.

README

Von SocQ · Aktualisiert am

Hotel Price Tracker

Der Preiskalender von Google Hotels zeigt für ein Hotel den günstigsten Preis einer Nacht bei Anreise an jedem Tag der kommenden Wochen. Als Zeitreihe betrachtet machen diese Nachtpreise den Unterschied zwischen Wochentagen und Wochenenden, saisonale Spitzen und den günstigsten Buchungszeitpunkt sichtbar und helfen bei Preisbeobachtung, Revenue-Analysen und Reiseplanung.

Funktionen der Hotel Price Tracker API

  • Der Kalender als ZeilenJede Zeile steht für einen Anreisetag; check_out ist der Folgetag, und price.amount, price.currency sowie ein formatierter Preis geben den günstigsten Preis dieser Nacht an.
  • Mehrere Wochen pro AbfrageEine Abfrage deckt meist 6–8 Wochen an Anreisetagen ab, sodass Sie nicht jedes Datum einzeln abfragen müssen.
  • Wählbares Startdatumcheck_in legt den Beginn des Kalenders fest und wird zusammen mit check_out angegeben; ohne Angabe beginnt der Kalender morgen.
  • Zeilen nach Hotel und DatumJede Zeile enthält hotel_id und name, und id verbindet Hotel-ID und Anreisetag, sodass sich wiederholte Abfragen leicht zusammenführen lassen.

Parameter der Hotel Price Tracker API

ParameterErforderlichBeschreibung
hotel_idErforderlichHotel-ID aus dem Feld id eines Ergebnisses der Google Hotels API.
check_inOptionalStartdatum des Kalenders (YYYY-MM-DD, heute oder später). Zusammen mit check_out angeben; ohne beide Daten beginnt der Kalender morgen.
check_outOptionalAbreisedatum (YYYY-MM-DD). Muss nach check_in liegen; höchstens 30 Nächte.
currencyOptionalDreistelliger Währungscode für die Nachtpreise, zum Beispiel USD oder EUR.
location_codeOptionalStandortcode des Suchmarkts. Standardwert ist 2840 (USA).
language_codeOptionalSprachcode der Ergebnisse. Standardwert ist en.

So verwenden Sie die Hotel Price Tracker API

Senden Sie eine Hotel-ID und lesen Sie eine Zeile je Anreisetag.

  1. Senden Sie {"hotel_id": "ChoIyKbJ6puqvPf8ARoNL2cvMTFqNHR2MjczeBAB", "currency": "USD"} per POST an /v1/google-hotels/hotel-prices.
  2. Fragen Sie GET /v1/tasks/{task_id} ab, bis status den Wert succeeded hat.
  3. Lesen Sie die Preise je Datum aus results.items und rufen Sie mit results.next_cursor die nächste Seite ab, solange has_more true ist.
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"}'

Anwendungsfälle der Hotel Price Tracker API

  • Die günstigste Nacht finden: Sortieren Sie nach price.amount und wählen Sie den günstigsten Anreisetag der kommenden Wochen für Ihre Reiseplanung.
  • Wochentag gegen Wochenende: Gruppieren Sie nach dem Wochentag von check_in und berechnen Sie, wie viel teurer Freitag- und Samstagnächte als Nächte unter der Woche sind.
  • Preisänderungen verfolgen: Rufen Sie den Kalender regelmäßig ab, vergleichen Sie den Preis derselben id zwischen den Läufen und erkennen Sie, wann ein Hotel Preise anhebt oder senkt.
  • Wettbewerber vergleichen: Rufen Sie die Kalender mehrerer benachbarter Hotels in derselben Währung ab und stellen Sie sie nach check_in nebeneinander, um den Preisvorteil Nacht für Nacht zu sehen.

Profi-Tipps zur Hotel Price Tracker API

  • Speichern Sie Zeilen unter der id aus Hotel-ID und Anreisetag. So aktualisiert ein täglicher Lauf dieselbe Nacht, statt doppelte Zeilen anzulegen.
  • Für weiter entfernte Daten verschieben Sie check_in nach hinten und senden die Anfrage erneut.
  • Halten Sie currency konstant, wenn Sie Ergebnisse mehrerer Hotels oder mehrerer Läufe vergleichen.
  • Eine Anfrage kostet unabhängig von der Zahl der Tage 4 Credits. Der Kalender ist daher günstiger, als einzelne Daten nacheinander abzufragen.

Ergänzend zur Hotel Price Tracker API nutzen Sie diese APIs, wenn Sie eine andere Art öffentlicher Google Hotels-Daten benötigen.

  • Google Hotels API — Durchsuchen Sie Google Hotels nach Reiseziel und erhalten Sie für jedes Hotel den Preis pro Nacht für Ihre Daten, Sterne, Gästebewertung, Bewertungsanzahl, Koordinaten und Hotel-ID.
  • Google Hotel Details API — Rufen Sie mit einer Hotel-ID das Profil eines Hotels bei Google Hotels ab, mit Kontaktdaten, Ausstattung, Lagebewertung, Bewertungsverteilung, Bewertungsthemen und Preisen je Buchungsseite.

Weitere Plattformen entdecken

Kombinieren Sie Google Hotels-Daten mit öffentlichen Daten anderer unterstützter Social-Media-Plattformen.

Hotel Price Tracker API — FAQ

Hotel Price Tracker API ruft mit einer Hotel-ID den Preiskalender von Google Hotels ab und liefert den günstigsten Preis pro Nacht für jeden Anreisetag der nächsten etwa 6–8 Wochen.

Jede Zeile ist der Preis einer Nacht: check_out ist der Tag nach check_in, und price ist der günstigste Preis dieser Nacht.

Meist 6–8 Wochen ab dem Startdatum. Mit check_in beginnt er an diesem Tag, ohne Angabe morgen.

In der Währung, die Sie mit einem dreistelligen Code wie USD oder EUR in currency angeben. Jede Zeile nennt die Währung ihres Preises.

4 Credits pro Anfrage, die den gesamten Kalender eines Hotels liefert.