v0.2.0-beta

OpenAPI 3.1.0

Live: Google-Hotelsuche

Felo API Support

MIT

Server

https://openapi.felo.ai

Client-Bibliotheken

Shell Curl

DataForSEO

SEO, search-engine results, keyword research, backlinks and AI visibility data.

DataForSEO Operationen

post/v1/beta/dataforseo/business_data/google/hotel_searches/live

Live: Google-Hotelsuche

Durchsucht Google Hotels nach Unterkünften, die einer Abfrage entsprechen, mit Daten und Belegung. Eingebettet in das DataForSEO-Envelope: Daten in tasks[0].result, Ergebnis in tasks[0].status_code – eine abgelehnte Anfrage liefert weiterhin HTTP 200. So finden Sie das Hotel, dessen id die Info-Endpunkte benötigen; post_dataforseo_business_google_hotel_info_live ist die Detailansicht.

Preisreferenz

Abrechnung: Gemeldete Antwortkosten.
Referenzschätzung pro Anfrage: USD 0.2428.
Referenz-Kundenmultiplikator: 1.0. Nicht erneut auf bereits abgerechnete Kundenbeträge anwenden.

Nur Referenzmetadaten, kein Kontenangebot und keine garantierte Preis- oder Ausgabenobergrenze. Ressourcen-Credits sind keine Felo-Credits. Endgültige Abrechnungen richten sich nach den Felo-Abrechnungsbelegen.

Body

application/json

Typ: array (object | null)[]
- adults
 Typ: integer | null
 
 Anzahl der Erwachsenen
 Optionales Feld
 Wenn Sie dieses Feld nicht angeben, wird der Standardwert 2 verwendet;
 Hinweis: Sie können bis zu 6 Personen angeben, einschließlich Erwachsenen und Kindern
 Beispiel:
 1
- amenities
 Typ: array string[] | null
 
 Hotelausstattung
 Optionales Feld
 Mit diesem Feld können Sie verschiedene Hotelausstattungen angeben
 Beispiel:
 [ "free_parking", "pets_allowed" ]
 mögliche Werte:
 "air_conditioning", "all_inclusive_available", "bar", "free_breakfast", "fitness_center", "kid_friendly", "free_parking", "pets_allowed", "pool", "restaurant", "room_service", "spa", "free_wifi", "parking", "indoor_pool", "outdoor_pool", "wheelchair_accessible", "beach_access"
- check_in
 Typ: string | null
 
 Check-in-Datum
 Optionales Feld
 Wenn Sie dieses Feld nicht angeben, wird standardmäßig das morgige Datum verwendet;
 Datumsformat: "yyyy-mm-dd"
 Beispiel:
 "2019-01-15"
 Hinweis: Der Wert darf nicht vor dem heutigen Datum liegen
- check_out
 Typ: string | null
 
 Check-out-Datum
 Optionales Feld
 Wenn Sie dieses Feld nicht angeben, verwendet unser System standardmäßig das Datum in zwei Tagen;
 Datumsformat: "yyyy-mm-dd"
 Beispiel:
 "2019-01-15"
 Hinweis: Der Wert darf nicht kleiner oder gleich check_in sein;
 der Abstand zwischen den Werten check_in und check_out darf 30 Tage nicht überschreiten
- children
 Typ: array string[] | null
 
 Anzahl und Alter der Kinder
 Optionales Feld
 Wenn Sie dieses Feld nicht angeben, werden keine Kinder in die Suche einbezogen;
 das Alter der Kinder kann zwischen 0 und 17 liegen;
 Hinweis: Sie können bis zu 6 Personen angeben, einschließlich Erwachsenen und Kindern
 Legen Sie den folgenden Wert fest, um ein 14 Jahre altes Kind einzubeziehen:
 [14]
 Legen Sie den folgenden Wert fest, um ein 13 Jahre altes Kind und ein 8 Jahre altes Kind einzubeziehen:
 [13,8]
- currency
 Typ: string | null
 
 Währung
 Optionales Feld
 Beispiel:
 "USD"
- depth
 Typ: integer | null
 
 Parsing-Tiefe
 Optionales Feld
 Anzahl der Ergebnisse in Google Hotels
 Standardwert: 18 organische Ergebnisse
 Höchstwert: 140
 Hinweis: Ihr Konto wird für jeweils 18 organische Ergebnisse abgerechnet, unabhängig von bezahlten Einträgen in der Antwort;
 eine Tiefe über 18 kann daher zu zusätzlichen Kosten führen, wenn Google Hotels mehr als 18 Ergebnisse zurückgibt;
 Wenn die angegebene Tiefe höher als die Anzahl der Ergebnisse in der Antwort ist, wird die Differenz automatisch Ihrem Kontostand gutgeschrieben
- free_cancellation
 Typ: boolean | null
 
 Hotels mit kostenloser Stornierung
 Optionales Feld
 Setzen Sie dieses Feld auf true, wenn Sie die Liste der Hotels mit kostenloser Stornierung von Reservierungen erhalten möchten
 Standardwert: false
- is_vacation_rentals
 Typ: boolean | null
 
 Suche nach Ferienunterkünften
 Optionales Feld
 Setzen Sie dieses Feld auf true, wenn Sie die Liste der Ferienunterkünfte anstelle von Hotels erhalten möchten
 Standardwert: false
- keyword
 Typ: string | null
 
 keyword
 Optionales Feld
 das von Ihnen angegebene Keyword wird zur Suche nach der Hotelliste verwendet;
 Wenn Sie dieses Feld nicht verwenden, geben wir die an einem angegebenen Standort gefundene Hotelliste zurück;
 im Feld keyword können Sie bis zu 700 Zeichen angeben
 alle %## werden dekodiert (das Zeichen ‘+’ wird zudem in ein Leerzeichen dekodiert)
 wenn Sie das Zeichen “%” für Ihr keyword benötigen, geben Sie es als “%25” an;
 Hinweis: Um genaue Suchergebnisse zu erhalten, wird der Standortname automatisch an das Keyword angehängt
 
 Weitere Informationen zu Regeln und Einschränkungen der Felder keyword und keywords in DataForSEO-APIs finden Sie in diesem Help-Center-Artikel
- language_code
 Typ: string
 
 Sprachcode der Suchmaschine
 Pflichtfeld, wenn nicht angegeben language_name
 bei Verwendung dieses Feldes ist keine Angabe von language_name nötig
 Die Liste der verfügbaren Sprachen der Suchmaschine mit ihrem language_code erhalten Sie durch eine separate Anfrage an https://api.dataforseo.com/v3/business_data/google/languages
 Beispiel:
 en
- language_name
 Typ: string
 
 Vollständiger Name der Suchmaschinensprache
 Pflichtfeld, wenn nicht angegeben language_code
 bei Verwendung dieses Feldes ist keine Angabe von language_code nötig
 Die Liste der verfügbaren Sprachen der Suchmaschine mit language_name erhalten Sie durch eine separate Anfrage an https://api.dataforseo.com/v3/business_data/google/languages
 Beispiel:
 English
- location_code
 Typ: integer
 
 Standortcode der Suchmaschine
 Pflichtfeld, wenn nicht angegeben location_name oder location_coordinate
 bei Verwendung dieses Feldes ist keine Angabe von location_name oder location_coordinate nötig
 Die Liste der verfügbaren Standorte der Suchmaschine mit location_code erhalten Sie durch eine separate Anfrage an https://api.dataforseo.com/v3/business_data/google/locations
 Beispiel:
 2840
- location_coordinate
 Typ: string
 
 GPS-Koordinaten eines Standorts
 Pflichtfeld, wenn nicht angegeben location_name oder location_code
 bei Verwendung dieses Feldes ist keine Angabe von location_name oder location_code nötig
 der Parameter location_coordinate muss im Format "latitude,longitude" angegeben werden
 maximale Anzahl Dezimalstellen für "latitude" und "longitude": 7
 Hinweis: Wenn die Koordinaten zur Festlegung eines Standorts verwendet werden, findet die Suche in der nächstgelegenen Siedlung statt
 Beispiel:
 53.476225,-2.243572
- location_name
 Typ: string
 
 Vollständiger Name des Suchmaschinenstandorts
 Pflichtfeld, wenn nicht angegeben location_code oder location_coordinate
 bei Verwendung dieses Feldes ist keine Angabe von location_code oder location_coordinate nötig
 Die Liste der verfügbaren Standorte der Suchmaschine mit location_name erhalten Sie durch eine separate Anfrage an https://api.dataforseo.com/v3/business_data/google/locations
 Beispiel:
 London,England,United Kingdom
 Hinweis: Um genaue Suchergebnisse zu erhalten, wird der von Ihnen angegebene location_name automatisch an das Keyword angehängt
- max_price
 Typ: integer | null
 
 Höchstpreis pro Nacht
 Optionales Feld
 die Währung dieses Werts hängt vom Feld currency ab
 Beispiel:
 600
- min_price
 Typ: integer | null
 
 Mindestpreis pro Nacht
 Optionales Feld
 die Währung dieses Werts hängt vom Feld currency ab
 Beispiel:
 100
- min_rating
 Typ: number | null
 
 Mindestbewertung
 Optionales Feld
 Mit diesem Feld können Sie eine Gästebewertung oberhalb eines bestimmten Werts angeben
 Beispiel:
 2.5
- search_this_area
 Typ: boolean | null
 
 Hotels aus dem angezeigten Bereich anzeigen
 Optionales Feld
 folgende Werte sind möglich: true, false
 Standardwert: true
 bei false wird der Modus search_this_area deaktiviert
 Hinweis: Wenn der Modus search_this_area deaktiviert ist, wird location_name bei der Suche nicht an das keyword angehängt
 Weitere Informationen zu diesem Parameter finden Sie in unserem Help Center
- sort_by
 Typ: string | null
 
 Sortierparameter für Ergebnisse
 Optionales Feld
 Sie können dieses Feld verwenden, um die Ergebnisse zu sortieren
 mögliche Sortierarten:
 relevance – nach Relevanz sortieren
 lowest_price – nach dem niedrigsten Preis sortieren
 highest_rating – nach der höchsten Bewertung sortieren
 most_reviewed – nach den meisten Bewertungen sortieren
 Standardwert: relevance
- stars
 Typ: array string[] | null
 
 Hotelsterne
 Optionales Feld
 Setzen Sie dieses Feld auf [5], wenn Sie nur die Liste der 5-Sterne-Hotels erhalten möchten
 Beispiel:
 [3,4,5]
- tag
 Typ: string | null
 
 Benutzerdefinierte Aufgaben-ID
 Optionales Feld
 Zeichenlimit: 255
 Mit diesem Parameter können Sie die Aufgabe identifizieren und dem Ergebnis zuordnen
 Den angegebenen Wert tag finden Sie im data-Objekt der Antwort

Antworten

200
Typ: object | null · Response36Afe1097B20_BusinessDataGoogleHotelSearchesLiveResponseInfo
cost
Typ: number | null Format: double

Gesamtkosten der Aufgaben in USD

status_code
Typ: integer | null

allgemeiner Statuscode die vollständige Liste der Antwortcodes finden Sie hier

status_message
Typ: string | null

allgemeine Informationsmeldung die vollständige Liste der allgemeinen Informationsmeldungen finden Sie hier

tasks
Typ: array (object | null)[] | null

Array von Aufgaben

Typ: object | null · Response36Afe1097B20_BusinessDataGoogleHotelSearchesLiveTaskInfo
cost
Typ: number | null Format: double

Gesamtkosten der Aufgaben in USD

data
Typ: object | null

Enthält dieselben Parameter, die Sie in der POST-Anfrage angegeben haben

propertyName
Typ: object | null
id
Typ: string | null

Aufgaben-ID eindeutige Aufgaben-ID in unserem System im UUID-Format

path
Typ: array (string | null)[] | null

URL-Pfad

result
Typ: array (object | null)[] | null

Array von Ergebnissen

check_url
Typ: string | null

direkte URL zu den Suchmaschinenergebnissen
Sie können sie verwenden, um sicherzustellen, dass wir genaue Ergebnisse geliefert haben

datetime
Typ: string | null

Datum und Uhrzeit des Eingangs des Ergebnisses
im UTC-Format: „yyyy-mm-dd hh-mm-ss +00:00“
Beispiel:
2019-11-15 12:57:46 +00:00

items
Typ: array (object | null)[] | null

aufgetretene Elementtypen
Typen von Suchergebnissen, die im items-Array auftreten;
mögliche Elementtypen: hotel_search_item

hotel_identifier
Typ: string | null

eindeutige ID einer Hotelentität in der Google-Suche
Beispiel:
CgoI-KWyzenM_MV3EAE

is_paid
Typ: boolean | null

gibt an, ob es sich um einen bezahlten Hotel-Eintrag handelt
wenn true, ist das zugehörige hotel_search_item eine bezahlte Anzeige
wenn false, ist das zugehörige hotel_search_item ein organischer Hotel-Eintrag

location
Typ: object | null · Response36Afe1097B20_GpsCoordinatesLocationInfo

GPS-Koordinaten des Hotelstandorts

latitude
Typ: number | null

Breitengrad des Hotels in Google Maps
Beispiel:
"latitude": 51.584091

longitude
Typ: number | null

Längengrad des Hotels in Google Maps
Beispiel:
"longitude": -0.31365919999999997

overview_images
Typ: array (string | null)[] | null

hervorgehobene Bilder für ein Hotel

prices
Typ: object | null · Response36Afe1097B20_HotelPriceInfo

Hotelpreis

check_in
Typ: string | null

Check-in-Datum und -Uhrzeit
im UTC-Format: “yyyy-mm-dd hh-mm-ss +00:00”
Beispiel:
2019-11-15 12:57:46 +00:00

check_out
Typ: string | null

Check-out-Datum und -Uhrzeit
im UTC-Format: “yyyy-mm-dd hh-mm-ss +00:00”
Beispiel:
2019-11-15 12:57:46 +00:00

currency
Typ: string | null

Preiswährung
USD wird standardmäßig verwendet, sofern nicht im POST-Array angegeben

discount_text
Typ: string | null

Text zu einem gewährten Rabatt

items
Typ: array (object | null)[] | null

aufgetretene Elementtypen
Typen von Suchergebnissen, die im items-Array auftreten;
mögliche Elementtypen: hotel_search_item

currency
Typ: string | null

Preiswährung
USD wird standardmäßig verwendet, sofern nicht im POST-Array angegeben

domain
Typ: string | null

Domain eines Drittanbieters Domain der Seite einer Drittanbieter-Website mit Preisinformationen

free_cancellation_until
Typ: string | null

Datum, bis zu dem die kostenlose Stornierung möglich ist im UTC-Format: “yyyy-mm-dd hh-mm-ss +00:00” entspricht null, wenn für die ausgewählten Daten keine kostenlose Stornierung verfügbar ist

is_paid
Typ: boolean | null

gibt an, ob es sich um einen bezahlten Hotel-Eintrag handelt
wenn true, ist das zugehörige hotel_search_item eine bezahlte Anzeige
wenn false, ist das zugehörige hotel_search_item ein organischer Hotel-Eintrag

offers
Typ: array (object | null)[] | null

hervorgehobene Preisangebote

currency
Typ: string | null

Preiswährung
USD wird standardmäßig verwendet, sofern nicht im POST-Array angegeben

free_cancellation_until
Typ: string | null

Datum, bis zu dem die kostenlose Stornierung möglich ist im UTC-Format: “yyyy-mm-dd hh-mm-ss +00:00” entspricht null, wenn für die ausgewählten Daten keine kostenlose Stornierung verfügbar ist

max_visitors
Typ: integer | null

Die maximale Anzahl der Besucher die maximale Anzahl der Besucher, für die das Preisangebot gilt

offer_images
Typ: array (string | null)[] | null

Bilder des Preisangebots URLs der im Preisangebot gezeigten Bilder

price
Typ: number | null

Preis pro Nacht

title
Typ: string | null

Name des Hotels

type
Typ: string | null

Elementtyp

url
Typ: string | null

URL des Preisangebots URL der Seite der Website, auf der das Preisangebot erscheint

official_site
Typ: boolean | null
price
Typ: number | null

Preis pro Nacht

title
Typ: string | null

Name des Hotels

type
Typ: string | null

Elementtyp

url
Typ: string | null

URL der Drittanbieter-Seite URL der Seite einer Drittanbieter-Website mit Preisinformationen

price
Typ: number | null

Preis pro Nacht

price_without_discount
Typ: number | null Format: int64

Vollpreis pro Nacht ohne gewährten Rabatt

prices_by_dates
Typ: array (object | null)[] | null
check_in_date
Typ: string | null
check_out_date
Typ: string | null
currency
Typ: string | null

Preiswährung
USD wird standardmäßig verwendet, sofern nicht im POST-Array angegeben

price
Typ: number | null

Preis pro Nacht

visitors
Typ: integer | null

Anzahl der Hotelbesucher für diesen Preis

reviews
Typ: object | null · Response36Afe1097B20_HotelReviewInfo

Hotelbewertungen und Bewertungsinformationen

mentions
Typ: array (object | null)[] | null

Hotel-Erwähnungen
Informationen zu Hotelbewertungen nach Kriterien

negative_count
Typ: integer | null Format: int64

Anzahl negativer Bewertungen nach Kriterium

positive_count
Typ: integer | null Format: int64

Anzahl positiver Bewertungen nach Kriterium

positive_score
Typ: number | null

positiver Wert nach Kriterium

title
Typ: string | null

Titel des bewerteten Kriteriums

total_count
Typ: integer | null Format: int64

Anzahl aller Bewertungen nach Kriterium

visible_by_default
Typ: boolean | null

Element ist standardmäßig sichtbar
gibt an, ob das Bewertungselement standardmäßig sichtbar ist

other_sites_reviews
Typ: array (object | null)[] | null

Bewertungen auf Drittanbieter-Websites
Bewertungen von Drittanbieter-Websites

rating
Typ: object | null · Response36Afe1097B20_RatingInfo

Bewertung in der Rezension
Informationen zur Bewertung, die in der Rezension auf einer Drittanbieter-Website enthalten ist

rating_max
Typ: integer | null

der Höchstwert für einen rating_type

rating_type
Typ: string | null

der Typ der Bewertung hier finden Sie die folgenden Elemente: Max5, Percents, CustomMax

value
Typ: number | null Format: double

der Wert der Bewertung

votes_count
Typ: integer | null Format: int64

die Anzahl der Rückmeldungen

review_text
Typ: string | null

Rezensionstext
Text der Rezension

title
Typ: string | null

Titel der Rezension
enthält den Namen der Drittanbieter-Website, auf der die Rezension ursprünglich erschienen ist

url
Typ: string | null

URL der Rezension
URL der Drittanbieter-Website, auf der die Rezension ursprünglich erschienen ist

rating_distribution
Typ: object | null

Bewertungsverteilung nach Stimmen
die Verteilung der Stimmen über die Bewertungsskala von 1 bis 5

propertyName
Typ: integer | null Format: Int64
value
Typ: number | null

Gesamtbewertung des Hotels auf Basis von Kundenstimmen

votes_count
Typ: integer | null Format: int64

Anzahl der Kundenstimmen
die Anzahl der Kundenstimmen, die in die Berechnung der Hotelbewertung einfließen

stars
Typ: integer | null

Sterneklassifizierung des Hotels
Klassifizierung zwischen 1 und 5 Sternen

title
Typ: string | null

Name des Hotels

type
Typ: string | null

Elementtyp

items_count
Typ: integer | null Format: int64

Elementtypen
die Anzahl der Elemente im Array items

keyword
Typ: string | null

in einem POST-Array empfangenes Keyword
das Keyword wird dekodiert zurückgegeben (%##; das Zeichen „+“ wird in ein Leerzeichen dekodiert)

language_code
Typ: string | null

Sprachcode in einem POST-Array

location_code
Typ: integer | null

Standortcode in einem POST-Array

result_count
Typ: integer | null Format: int64

Anzahl der Elemente im Ergebnis-Array

status_code
Typ: integer | null

Statuscode der Aufgabe von DataForSEO erzeugt, kann im folgenden Bereich liegen: 10000-60000 die vollständige Liste der Antwortcodes finden Sie hier

status_message
Typ: string | null

Informationsmeldung der Aufgabe die vollständige Liste der allgemeinen Informationsmeldungen finden Sie hier

time
Typ: string | null

Ausführungszeit in Sekunden

tasks_count
Typ: integer | null Format: int64

Die Anzahl der Aufgaben im tasks-Array

tasks_error
Typ: integer | null Format: int64

Die Anzahl der Aufgaben im tasks-Array, die mit einem Fehler zurückgegeben wurden

time
Typ: string | null

Gesamtausführungszeit, Sekunden

version
Typ: string | null

Die aktuelle Version der API
application/json
400

Die Anfrage konnte nicht verarbeitet werden. Prüfen Sie die Anfrageparameter.
401

Ein gültiger Felo-API-Schlüssel ist erforderlich.
402

Die Anfrage kann nicht fortgesetzt werden, da eine Abrechnungsvoraussetzung nicht erfüllt ist.
403

Das Konto ist für diesen Vorgang nicht berechtigt.
429

Ein Anfrage- oder Ausgabenlimit wurde erreicht.
502

Der Dienst konnte die Anfrage nicht abschließen.
503

Die API oder der Abrechnungsdienst ist vorübergehend nicht verfügbar.
504

Beim Verarbeiten der Anfrage ist eine Zeitüberschreitung aufgetreten.
default

Fehlerantwort; Upstream-Passthrough-Antworten können Anbieterformate verwenden

application/json

post/v1/beta/dataforseo/business_data/google/hotel_searches/live

curl https://openapi.felo.ai/v1/beta/dataforseo/business_data/google/hotel_searches/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "language_code": "en",
    "location_name": "New York,New York,United States",
    "keyword": "cheap hotel",
    "check_in": "2023-06-01",
    "check_out": "2023-06-30",
    "currency": "USD",
    "adults": 2,
    "children": [
      "14"
    ],
    "sort_by": "highest_rating",
    "priority": 2,
    "tag": "example"
  }
]'

Schema anzeigen

{
  "version": null,
  "status_code": null,
  "status_message": null,
  "time": null,
  "cost": null,
  "tasks_count": null,
  "tasks_error": null,
  "tasks": [
    {
      "id": null,
      "status_code": null,
      "status_message": null,
      "time": null,
      "cost": null,
      "result_count": null,
      "path": [
        null
      ],
      "data": null,
      "result": [
        {
          "keyword": null,
          "location_code": null,
          "language_code": null,
          "check_url": null,
          "datetime": null,
          "items_count": null,
          "items": [
            {
              "type": null,
              "hotel_identifier": null,
              "title": null,
              "stars": null,
              "is_paid": null,
              "location": "[Max Depth Exceeded]",
              "reviews": "[Max Depth Exceeded]",
              "overview_images": [
                "[Max Depth Exceeded]"
              ],
              "prices": "[Max Depth Exceeded]"
            }
          ]
        }
      ]
    }
  ]
}

Erfolgreicher Vorgang

Live: Google-Hotelsuche

AuthentifizierungRequired

DataForSEO

Live: Google-Hotelsuche

Preisreferenz