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/searchund speichern Sie dieidjedes Hotels. Übergeben Sie sie alshotel_idanPOST /v1/google-hotels/hotel-details, um Ausstattung, Bewertungsthemen und Angebote der Buchungsportale zu erhalten, oder anPOST /v1/google-hotels/hotel-prices, um den niedrigsten Übernachtungspreis nach Anreisedatum zu erhalten. Fragen Sie die Ergebnisse überGET /v1/tasks/{task_id}ab.
Die neuen Google-Hotels-Endpunkte
1 SocQ-Credit = $0,005.
| Endpunkt | Was er liefert | Preis |
|---|---|---|
| Google Hotels API | Hotels für ein Reiseziel mit Sternen, Gästebewertung, Anzahl der Bewertungen, dem niedrigsten Übernachtungspreis für Ihre Daten, Lage, Fotos und der Hotel-id | 0,15 Credits ($0,00075) pro Hotel |
| Google Hotel Details API | Adresse, Telefon, Website, Ausstattung, Lagebewertungen, Bewertungsverteilung, Bewertungsthemen, Bewertungen auf anderen Websites und das Angebot jedes Buchungsportals für ein Hotel | 2 Credits ($0,01) pro Aufruf |
| Hotel Price Tracker API | Eine Zeile pro Anreisedatum mit dem niedrigsten Preis des Hotels für eine Nacht, meist sechs bis acht Wochen an Daten | 4 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_inundcheck_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 wieUSDoderEUR.sort_by:relevance,lowest_price,highest_ratingodermost_reviewed.min_priceundmax_price: die Preisspanne pro Nacht in der gewählten Währung.location_code(Standard 2840, Vereinigte Staaten) undlanguage_code(Standarden).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_timeundamenities.location_scoresvon 1 bis 5 füroverall,things_to_do,restaurants,transitundairport_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, mitseller,price, Buchungs-url,is_official,is_sponsoredundfree_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
- Durchsuchen Sie das Reiseziel einmal mit
sort_by: "most_reviewed"und wählen Sie Ihr Wettbewerbsumfeld aus den Ergebnissen. - Rufen Sie für jedes Hotel Hotel Details ab, um Ausstattung, Lagebewertungen, Bewertungsthemen und Angebote der Buchungsportale zu vergleichen.
- 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