v0.2.0-beta

OpenAPI 3.1.0

Live: Google-Hotelinfos als HTML

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_info/live/html

Live: Google-Hotelinfos als HTML

Derselbe Hotel-Eintrag wie post_dataforseo_business_google_hotel_info_live, zurückgegeben als rohes HTML. Eingebettet in das DataForSEO-Envelope: Daten in tasks[0].result, Ergebnis in tasks[0].status_code – eine abgelehnte Anfrage liefert weiterhin HTTP 200.

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, werden standardmäßig zwei Erwachsene verwendet
  Beispiel:
  1
- 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"
- 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"
- 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;
  
  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"
- hotel_identifier
  Typ: string
  
  Eindeutige Hotelkennung
  Pflichtfeld
  eindeutige Kennung eines Hotelobjekts in der Google-Suche;
  Sie erhalten den Wert durch eine Anfrage an die Advanced Google SERP API (im hotels-Element der Antwort enthalten) oder an den Hotel Searches-Endpunkt der Business Data API
  Beispiel:
  ChYIq6SB--i6p6cpGgovbS8wN2s5ODZfEAE
- 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
- priority
  Typ: integer | null
  
  Aufgabenpriorität
  Optionales Feld
  folgende Werte sind möglich:
  1 – normale Ausführungspriorität (standardmäßig gesetzt)
  2 – hohe Ausführungspriorität. Für Aufgaben mit hoher Ausführungspriorität wird zusätzlich berechnet.
  Die Kosten können auf der Seite Pricing berechnet werden.
- 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-Array der Antwort

Antworten

200
Typ: object | null · Response36Afe1097B20_BusinessDataGoogleHotelInfoLiveHtmlResponseInfo
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_BusinessDataGoogleHotelInfoLiveHtmlTaskInfo
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

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

HTML-Seiten

date
Typ: string | null

Datum und Uhrzeit, zu denen die HTML-Seite gescannt wurde
im UTC-Format: “yyyy-mm-dd hh-mm-ss +00:00”
Beispiel:
2019-11-15 12:57:46 +00:00

html
Typ: string | null

HTML-Seite

page
Typ: integer | null

laufende Nummer der zurückgegebenen HTML-Seite

items_count
Typ: integer | null Format: int64

die Anzahl der im items-Array zurückgegebenen Ergebnisse

keyword
Typ: string | null

eindeutige Hotel-ID, angegeben als "hotel_id:$"

language_code
Typ: string | null

Sprachcode in einem POST-Array

location_code
Typ: integer | null

Standortcode in einem POST-Array

se_domain
Typ: string | null
type
Typ: string | null

Elementtyp

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_info/live/html

curl https://openapi.felo.ai/v1/beta/dataforseo/business_data/google/hotel_info/live/html \
  --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",
    "hotel_identifier": "ChYIq6SB--i6p6cpGgovbS8wN2s5ODZfEAE"
  }
]'

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,
          "type": null,
          "se_domain": null,
          "location_code": null,
          "language_code": null,
          "datetime": null,
          "items_count": null,
          "items": [
            {
              "page": null,
              "date": null,
              "html": null
            }
          ]
        }
      ]
    }
  ]
}

Erfolgreicher Vorgang

Live: Google-Hotelinfos als HTML

AuthentifizierungRequired

DataForSEO

Live: Google-Hotelinfos als HTML

Preisreferenz