Google HotelsHotelpreiseReisedatenRate ShoppingAPI-Leitfaden

Google Hotels API: Hotelsuche, Hoteldetails und Preiskalender pro Nacht

Drei neue SocQ-Endpunkte für Google Hotels liefern Hotelsuchergebnisse mit Preisen, vollständige Hoteldetails mit Angeboten der Buchungsportale und den niedrigsten Übernachtungspreis eines Hotels nach Anreisedatum.

SocQAktualisiert am 19. November 20267 Min. Lesezeit

Google Hotels zeigt Sterne, Gästebewertungen, Übernachtungspreise und Angebote von Buchungsportalen für ein Reiseziel auf einer Seite. Reiseprodukte, Rate-Shopping-Tools und Revenue-Manager wollen diese Daten als Zeilen: eine Liste von Hotels zum Vergleichen, den vollständigen Datensatz einer Unterkunft und wie sich ihr Preis über die Daten hinweg entwickelt.

Am 2026-11-17 hat SocQ die Google-Hotels-Plattform mit drei Endpunkten gestartet, die genau das leisten. Sie sind über ein einziges Feld verknüpft, die Hotel-id. Dieser Leitfaden zeigt, was jeder Endpunkt liefert, wie die Anfrage aussieht, was sie kostet und wann sie sich eignet.

Kurze Antwort: Durchsuchen Sie ein Reiseziel mit POST /v1/google-hotels/search und speichern Sie die id jedes Hotels. Übergeben Sie sie als hotel_id an POST /v1/google-hotels/hotel-details, um Ausstattung, Bewertungsthemen und Angebote der Buchungsportale zu erhalten, oder an POST /v1/google-hotels/hotel-prices, um den niedrigsten Übernachtungspreis nach Anreisedatum zu erhalten. Fragen Sie die Ergebnisse über GET /v1/tasks/{task_id} ab.

Die neuen Google-Hotels-Endpunkte

1 SocQ-Credit = $0,005.

EndpunktWas er liefertPreis
Google Hotels APIHotels für ein Reiseziel mit Sternen, Gästebewertung, Anzahl der Bewertungen, dem niedrigsten Übernachtungspreis für Ihre Daten, Lage, Fotos und der Hotel-id0,15 Credits ($0,00075) pro Hotel
Google Hotel Details APIAdresse, Telefon, Website, Ausstattung, Lagebewertungen, Bewertungsverteilung, Bewertungsthemen, Bewertungen auf anderen Websites und das Angebot jedes Buchungsportals für ein Hotel2 Credits ($0,01) pro Aufruf
Hotel Price Tracker APIEine Zeile pro Anreisedatum mit dem niedrigsten Preis des Hotels für eine Nacht, meist sechs bis acht Wochen an Daten4 Credits ($0,02) pro Aufruf

Authentifizierung und asynchroner Aufgabenablauf

Alle SocQ-Anfragen authentifizieren sich mit einem API-Schlüssel, und derselbe Header gilt für das Einreichen, den Aufgabenstatus und den Abruf der Ergebnisse:

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Jede Erfassung läuft als Hintergrundaufgabe:

submit -> task_id -> queued -> running -> succeeded
                                   \-> failed

Die Antwort auf das Einreichen enthält data.task_id und data.status. Fragen Sie die Aufgabe mit dieser ID ab:

curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=50" \
  -H "Authorization: Bearer $SOCQ_API_KEY"

Wenn status den Wert succeeded hat, enthält die Antwort die erste Seite normalisierter Datensätze in data.results.items. limit ist standardmäßig 50 und geht bis 500; ist has_more true, übergeben Sie results.next_cursor als cursor, um die nächste Seite zu lesen. Solange eine Aufgabe queued, running oder failed ist, liefert der Endpunkt Aufgabenmetadaten ohne results.

Mit einer optionalen callback_url im Anfragekörper sendet SocQ nach Abschluss der Aufgabe einen POST mit einer Aufgabenzusammenfassung; die Datensätze lesen Sie über GET /v1/tasks/{task_id}. Eine Zeitüberschreitung auf Client-Seite bricht die Aufgabe nicht ab. Setzen Sie deshalb mit derselben Aufgaben-ID fort, statt für ein Duplikat zu bezahlen. 402 bedeutet zu wenige Credits; 429 bedeutet, dass der Schlüssel ein Raten- oder Credit-Limit erreicht hat.

Google Hotels API: ein Reiseziel durchsuchen

Die Google Hotels API sucht Hotels so, wie Reisende es bei Google tun. Geben Sie in query ein Reiseziel oder eine Hotelsuche an.

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
  }'

Optionale Felder:

  • check_in und check_out (YYYY-MM-DD, gemeinsam angegeben, bis zu 30 Nächte) bepreisen einen bestimmten Aufenthalt. Ohne sie gelten die Preise für eine Nacht ab morgen.
  • currency: ein dreibuchstabiger Code wie USD oder EUR.
  • sort_by: relevance, lowest_price, highest_rating oder most_reviewed.
  • min_price und max_price: die Preisspanne pro Nacht in der gewählten Währung.
  • location_code (Standard 2840, Vereinigte Staaten) und language_code (Standard en).
  • results_limit: 1 bis 140, Standard 18.

Jede Hotelzeile enthält id, name, stars (1 bis 5), rating (1 bis 5), reviews_count, price (amount, currency, formatted), die check_in und check_out, für die der Preis gilt, is_sponsored, location mit Breiten- und Längengrad, images und den rank in den Ergebnissen. Die standardmäßigen 18 Hotels kosten 2,7 Credits ($0,0135); das Maximum von 140 kostet 21 Credits ($0,105). Dokumentation: Google-Hotels-Suche.

Google Hotel Details API: alles über eine Unterkunft

Die Google Hotel Details API liefert eine Zeile mit allem, was Google Hotels über eine Unterkunft weiß. Übergeben Sie die id aus einem Suchergebnis als hotel_id. Ergänzen Sie check_in und check_out, um Angebote für diese Daten zu erhalten; andernfalls gelten die Angebote für eine Nacht ab morgen.

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"
  }'

Zusätzlich zu den Suchfeldern füllt die Detailzeile Folgendes aus:

  • address, phone, website, check_in_time, check_out_time und amenities.
  • location_scores von 1 bis 5 für overall, things_to_do, restaurants, transit und airport_access.
  • rating_distribution, den Anteil der Bewertungen pro Sternestufe.
  • review_topics, etwa Lage oder Frühstück, mit positiven, negativen und gesamten Erwähnungszahlen.
  • other_reviews, die Bewertung und Bewertungsanzahl des Hotels auf anderen Bewertungsportalen.
  • offers, eines pro Buchungsportal, mit seller, price, Buchungs-url, is_official, is_sponsored und free_cancellation_until.

offers ist das, was Ratenparitäts-Prüfungen brauchen: Vergleichen Sie das offizielle Angebot mit den Online-Reisebüros für dieselben Daten. Jede Anfrage kostet 2 Credits ($0,01). Eine unbekannte hotel_id liefert keine Zeilen und wird trotzdem berechnet. Dokumentation: Google Hotel Details.

Hotel Price Tracker API: niedrigster Preis nach Anreisedatum

Die Hotel Price Tracker API liefert den Preiskalender hinter der Datumsauswahl von Google Hotels als Zeilen. Für ein Hotel erhalten Sie den niedrigsten Preis für jede Anreisenacht, meist sechs bis acht Wochen an Daten ab Ihrem Anreisedatum.

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"
  }'

check_in legt das erste Datum des Kalenders fest (morgen, wenn weggelassen); geben Sie check_out dazu an. Jede Zeile enthält eine id aus Hotel-ID und Datum, hotel_id, name, check_in, check_out und price. Damit finden Sie die günstigsten Reisenächte, vergleichen Wochenend- und Wochentagspreise in einem Diagramm oder speisen einen Rate-Shopping-Bericht. Jede Anfrage kostet 4 Credits ($0,02), unabhängig von der Zahl der Daten. Dokumentation: Hotel Price Tracker.

Ein einfacher Workflow für das Wettbewerbsumfeld

  1. Durchsuchen Sie das Reiseziel einmal mit sort_by: "most_reviewed" und wählen Sie Ihr Wettbewerbsumfeld aus den Ergebnissen.
  2. Rufen Sie für jedes Hotel Hotel Details ab, um Ausstattung, Lagebewertungen, Bewertungsthemen und Angebote der Buchungsportale zu vergleichen.
  3. Führen Sie Hotel Price Tracker für jedes Hotel nach Zeitplan aus und speichern Sie jede Zeile mit ihrem collected_at.

Für eine Gruppe von 10 Hotels aus einer Standardsuche mit 18 Hotels kostet ein Lauf 2,7 Credits für die Suche, 20 Credits für die Details und 40 Credits für die Preiskalender: 62,7 Credits, etwa $0,31. Preise ändern sich, betrachten Sie jeden Lauf also als Momentaufnahme. Für lokale Unternehmensdaten wie Orte und Bewertungen auf Google Maps siehe Google Maps Scraper APIs.

FAQ

Was ist die Google Hotels API?

Eine Gruppe von SocQ-Endpunkten, die Google-Hotels-Daten als strukturierte Zeilen liefern: Suchergebnisse für ein Reiseziel, vollständige Details zu einem Hotel und einen Preiskalender pro Nacht. Es sind SocQ-Endpunkte, kein offizielles Google-Produkt.

Woher bekomme ich eine hotel_id?

Aus dem Feld id der Suchergebnisse von Google Hotels. Derselbe Wert funktioniert für Hotel Details und Hotel Price Tracker.

Für welche Daten gelten die Preise?

Wenn Sie check_in und check_out senden (YYYY-MM-DD, bis zu 30 Nächte), gelten die Preise für diesen Aufenthalt. Ohne sie bepreisen Suche und Details eine Nacht ab morgen, und der Price Tracker beginnt seinen Kalender morgen.

Kann ich Preise in einer anderen Währung erhalten?

Ja. Senden Sie eine dreibuchstabige currency wie EUR. Jedes Preisobjekt enthält amount, currency und einen formatted-String wie USD 176.

Wird eine ungültige hotel_id berechnet?

Ja. Hotel Details liefert für eine unbekannte hotel_id keine Zeilen und berechnet trotzdem 2 Credits. Prüfen Sie IDs deshalb zuerst gegen eine aktuelle Suche.

GOOGLE HOTELS API

Workflow mit einer öffentlichen Google Hotels-URL testen

Senden Sie öffentliche Eingaben und erhalten Sie normalisierte Datensätze mit nachvollziehbarem Quellkontext.

Google Hotels-APIs ansehen