Google Hotel Details
Die Detailseite eines Hotels bei Google Hotels bündelt Adresse, Telefon, Check-in-Zeiten und Ausstattung mit dem, was Gäste sagen: den Anteil jeder Sternebewertung, positive und negative Erwähnungen zu Themen wie Lage oder Frühstück sowie Bewertungen anderer Portale. Zusammen mit den Preisen, die jede Buchungsseite und die hoteleigene Website für denselben Aufenthalt nennen, eignet sie sich für Preisparitätsprüfungen, Wettbewerbsvergleiche und vollständige Hotelseiten.
Funktionen der Google Hotel Details API
- Preise je Buchungsseiteoffers listet für jeden Anbieter den Preis pro Nacht und einen Buchungslink; is_official, is_sponsored und free_cancellation_until kennzeichnen Direktpreise, bezahlte Platzierungen und kostenlos stornierbare Tarife.
- Worüber Gäste sprechenreview_topics liefert für Themen wie Wellness oder Breakfast jeweils positive_count, negative_count und mentions_count und zeigt so, welche Teile des Aufenthalts gelobt oder kritisiert werden.
- Bewertungsverteilung und andere Portalerating_distribution gibt den Anteil jeder Sternebewertung an, other_reviews die Bewertung, Anzahl und einen Auszug von Portalen wie Tripadvisor.
- Lagebewertunglocation_scores bewertet Gesamtlage, Freizeitangebote, Restaurants, Nahverkehr und Flughafenanbindung von 1 bis 5, ergänzt um den Namen des Viertels und Koordinaten.
- Hotelstammdaten in einer Zeileaddress, phone, website, check_in_time, check_out_time, die verfügbare Ausstattung, eine Beschreibung und Fotos kommen gemeinsam zurück.
- Preise für Ihre Datencheck_in, check_out und currency legen den Aufenthalt fest, für den die Preise gelten; ohne Daten gilt eine Nacht ab morgen.
Parameter der Google Hotel Details API
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
hotel_id | Erforderlich | Hotel-ID aus dem Feld id eines Ergebnisses der Google Hotels API. |
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 die Preise, zum Beispiel USD oder EUR. |
location_code | Optional | Standortcode des Suchmarkts. Standardwert ist 2840 (USA). |
language_code | Optional | Sprachcode der Hoteldetails. Standardwert ist en. |
So verwenden Sie die Google Hotel Details API
Senden Sie eine Hotel-ID aus der Hotelsuche und lesen Sie das Hotel als eine Zeile.
- Senden Sie {"hotel_id": "ChoIyKbJ6puqvPf8ARoNL2cvMTFqNHR2MjczeBAB", "currency": "USD"} per POST an /v1/google-hotels/hotel-details.
- Fragen Sie GET /v1/tasks/{task_id} ab, bis status den Wert succeeded hat.
- Lesen Sie das Hotel aus results.items. has_more und results.next_cursor folgen den üblichen Paginierungsregeln und bleiben bei diesem einzeiligen Ergebnis leer.
curl -X POST "https://api.socq.ai/v1/google-hotels/hotel-details" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"hotel_id":"ChoIyKbJ6puqvPf8ARoNL2cvMTFqNHR2MjczeBAB","currency":"USD"}'Anwendungsfälle der Google Hotel Details API
- Preisparität prüfen: Vergleichen Sie den Direktpreis mit is_official mit den Preisen der Online-Reisebüros für dieselben Daten und finden Sie Anbieter, die das Hotel günstiger verkaufen.
- Wettbewerbsvergleich: Stellen Sie rating_distribution, review_topics und location_scores benachbarter Hotels nebeneinander und sehen Sie, wo ein Haus vorne liegt und wo es zurückfällt.
- Vollständige Hotelseiten: Holen Sie Adresse, Ausstattung, Check-in-Zeiten, Fotos und Lagebewertung mit einer einzigen Abfrage und übernehmen Sie sie in die Hotelseiten Ihres Reiseportals.
- Gästestimmen auswerten: Sortieren Sie review_topics nach negative_count und finden Sie die Themen, über die Gäste am häufigsten klagen, etwa Lärm oder Frühstück.
Profi-Tipps zur Google Hotel Details API
- Verwenden Sie Hotel-IDs aus einer aktuellen Suche mit der Google Hotels API, damit jede Anfrage zu 2 Credits das erwartete Hotel liefert.
- Mit denselben Werten für check_in, check_out und currency wie in der Suche passen die Anbieterpreise zum Preis aus der Suchliste.
- Filtern Sie bezahlte Platzierungen über is_sponsored heraus, bevor Sie Anbieter vergleichen, damit der Vergleich ausgewogen bleibt.
- Behandeln Sie rating_distribution.share als Anteil zwischen 0 und 1, wenn Sie die Verteilung grafisch darstellen.
Verwandte APIs
Ergänzend zur Google Hotel Details 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.
- 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.