google-hotels/
search

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 eine Hotel-ID für weitere Abfragen.

Google Hotels API

Suche nach Reiseziel
Preise für Ihre Daten
Sterne und Gästebewertung
Hotel-ID für Folgeabfragen
0,15 Credits pro Ergebnis
Bereit
Bereit

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

README

Von SocQ · Aktualisiert am

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

ParameterErforderlichBeschreibung
queryErforderlichSuchbegriff für Reiseziel oder Hotel, zum Beispiel hotels in new york oder ein Hotelname.
check_inOptionalAnreisedatum (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_outOptionalAbreisedatum (YYYY-MM-DD). Muss nach check_in liegen; höchstens 30 Nächte.
currencyOptionalDreistelliger Währungscode für Preise und Preisgrenzen, zum Beispiel USD oder EUR.
sort_byOptionalSortierung: relevance, lowest_price, highest_rating oder most_reviewed.
min_priceOptionalMindestpreis pro Nacht in der Währung aus currency.
max_priceOptionalHöchstpreis pro Nacht in der Währung aus currency. Darf nicht unter min_price liegen.
location_codeOptionalStandortcode des Suchmarkts. Standardwert ist 2840 (USA).
language_codeOptionalSprachcode der Ergebnisse. Standardwert ist en.
results_limitOptionalAnzahl 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.

  1. Senden Sie {"query": "hotels in new york", "currency": "USD", "results_limit": 18} per POST an /v1/google-hotels/search.
  2. Fragen Sie GET /v1/tasks/{task_id} ab, bis status den Wert succeeded hat.
  3. 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.

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.

Weitere Plattformen entdecken

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

Google Hotels API — FAQ

Google Hotels API durchsucht Google Hotels nach Reiseziel oder Hotelname und liefert für jedes Hotel den Preis pro Nacht für Ihre Daten, Sterne, Gästebewertung, Bewertungsanzahl, Koordinaten, Fotos und eine Hotel-ID.

Für die angegebenen check_in und check_out, bei höchstens 30 Nächten. Ohne beide Daten gelten die Preise für eine Nacht ab morgen; jede Zeile enthält die Daten, auf die sich ihr Preis bezieht.

Ja. min_price und max_price begrenzen den Preis pro Nacht, und sort_by sortiert nach relevance, lowest_price, highest_rating oder most_reviewed.

Die Suche liefert Felder auf Listenebene. Übergeben Sie die id eines Hotels an die Google Hotel Details API für Adresse, Ausstattung, Bewertungsthemen und Preise je Buchungsseite oder an die Hotel Price Tracker API für Preise je Anreisetag.

0,15 Credits pro zurückgegebenem Hotel, also 2,7 Credits für 18 Hotels. Eine Suche ohne gefundene Hotels wird nicht berechnet.