Google Hotels
Ein Suchergebnis bei Google Hotels vereint Name, Sterne und Lage eines Hotels mit Gästebewertung, Bewertungsanzahl, Fotos und dem günstigsten Preis pro Nacht für die gewählten Daten und die gewählte Währung. Nebeneinander gelegt zeigen diese Werte, wie sich das Hotelangebot verschiedener Reiseziele unterscheidet, wie Preis und Bewertung zueinander stehen und welche Häuser eine genauere Prüfung verdienen.
Funktionen der Google Hotels API
- Suchen wie Reisendequery akzeptiert Reiseziele wie hotels in new york oder einen Hotelnamen; die Hotels kommen in der Reihenfolge zurück, in der Google Hotels sie zeigt, und rank enthält die Position jedes Hotels.
- Preise für einen echten AufenthaltMit check_in, check_out und currency legen Sie den gewünschten Aufenthalt fest; jede Zeile enthält diese Daten sowie price.amount, price.currency und einen formatierten Preis.
- Sortierung und Preisgrenzensort_by wechselt zwischen relevance, lowest_price, highest_rating und most_reviewed, und mit min_price und max_price bleiben nur Hotels in Ihrem Budget übrig.
- Bewertungssignale für jedes Hotelstars steht für die Hotelkategorie, rating für die durchschnittliche Gästebewertung von 1 bis 5 und reviews_count für die Zahl der Bewertungen dahinter.
- Koordinaten und Fotoslocation liefert Breiten- und Längengrad, images die Fotos, die Google für das Hotel anzeigt.
- Hotel-IDs für FolgeabfragenDie id jeder Zeile lässt sich direkt an die Google Hotel Details API und die Hotel Price Tracker API übergeben; url verweist auf die Seite des Hotels bei Google Hotels.
- Bis zu 140 Hotels pro Abfrageresults_limit reicht von 1 bis 140, und is_sponsored trennt bezahlte Platzierungen von regulären Einträgen.
Parameter der Google Hotels API
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
query | Erforderlich | Suchbegriff für Reiseziel oder Hotel, zum Beispiel hotels in new york oder ein Hotelname. |
check_in | Optional | Anreisedatum (YYYY-MM-DD, heute oder später). Zusammen mit check_out angeben; ohne beide Daten gelten die Preise für eine Nacht ab 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 Preise und Preisgrenzen, zum Beispiel USD oder EUR. |
sort_by | Optional | Sortierung: relevance, lowest_price, highest_rating oder most_reviewed. |
min_price | Optional | Mindestpreis pro Nacht in der Währung aus currency. |
max_price | Optional | Höchstpreis pro Nacht in der Währung aus currency. Darf nicht unter min_price liegen. |
location_code | Optional | Standortcode des Suchmarkts. Standardwert ist 2840 (USA). |
language_code | Optional | Sprachcode der Ergebnisse. Standardwert ist en. |
results_limit | Optional | Anzahl der zurückgegebenen Hotels (1–140). Standardwert ist 18. |
So verwenden Sie die Google Hotels API
Suchen Sie nach einem Reiseziel und lesen Sie die Hotels Zeile für Zeile.
- Senden Sie {"query": "hotels in new york", "currency": "USD", "results_limit": 18} per POST an /v1/google-hotels/search.
- Fragen Sie GET /v1/tasks/{task_id} ab, bis status den Wert succeeded hat.
- Lesen Sie die Hotels 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/search" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"hotels in new york","currency":"USD","results_limit":18}'Anwendungsfälle der Google Hotels API
- Preisniveau eines Reiseziels: Stellen Sie price.amount für dieselben Daten neben stars und rating, um die Hotelpreise einer Stadt nach Kategorie einzuordnen.
- Hotels in die engere Wahl nehmen: Behalten Sie Hotels innerhalb Ihres Preisrahmens, deren rating und reviews_count Ihre Schwelle erreichen, und geben Sie ihre id an Detail- und Preisabfragen weiter.
- Reisedaten vergleichen: Führen Sie dieselbe query mit anderen Werten für check_in und check_out aus und verknüpfen Sie die Ergebnisse über id, um die Preisentwicklung zwischen den Daten zu sehen.
- Hotelangebot auf der Karte: Legen Sie stars und Preise über die Koordinaten aus location und erkennen Sie, wo sich günstige und gehobene Hotels in einer Gegend ballen.
Profi-Tipps zur Google Hotels API
- Geben Sie bei Suchen, die Sie vergleichen möchten, immer currency an, damit price.amount dieselbe Einheit hat.
- Setzen Sie check_in und check_out immer gemeinsam. Aufenthalte über 30 Nächte oder eine Abreise vor der Anreise werden abgelehnt, bevor eine Aufgabe entsteht.
- Verknüpfen Sie Folgeabfragen über id statt über den Hotelnamen; Häuser einer Kette in derselben Stadt heißen oft fast gleich.
- Jedes zurückgegebene Hotel kostet 0,15 Credits. Stellen Sie results_limit daher auf die Zahl ein, die Sie wirklich prüfen.
Verwandte APIs
Ergänzend zur Google Hotels API nutzen Sie diese APIs, wenn Sie eine andere Art öffentlicher Google Hotels-Daten benötigen.
- 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.
- Hotel Price Tracker API — Rufen Sie mit einer Hotel-ID den Preiskalender eines Hotels bei Google Hotels ab, mit dem günstigsten Preis pro Nacht für jeden Anreisetag der nächsten etwa 6–8 Wochen.