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
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
hotel_id | Erforderlich | Hotel-ID aus dem Feld id eines Ergebnisses der Google Hotels API. |
check_in | Optional | Startdatum des Kalenders (YYYY-MM-DD, heute oder später). Zusammen mit check_out angeben; ohne beide Daten beginnt der Kalender morgen. |
check_out | Optional | Abreisedatum (YYYY-MM-DD). Muss nach check_in liegen; höchstens 30 Nächte. |
currency | Optional | Dreistelliger Währungscode für die Nachtpreise, zum Beispiel USD oder EUR. |
location_code | Optional | Standortcode des Suchmarkts. Standardwert ist 2840 (USA). |
language_code | Optional | Sprachcode 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.
- Senden Sie {"hotel_id": "ChoIyKbJ6puqvPf8ARoNL2cvMTFqNHR2MjczeBAB", "currency": "USD"} per POST an /v1/google-hotels/hotel-prices.
- Fragen Sie GET /v1/tasks/{task_id} ab, bis status den Wert succeeded hat.
- 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.
Verwandte APIs
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.