v0.2.0-beta

OpenAPI 3.1.0

Pobieranie wyników wyszukiwania Google Hotels według id

Felo API Support

MIT

Serwer

https://openapi.felo.ai

Biblioteki klienckie

Shell Curl

DataForSEO

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

DataForSEO Operacje

get/v1/beta/dataforseo/business_data/google/hotel_searches/task_get/{id}

Pobieranie wyników wyszukiwania Google Hotels według id

Pobiera z kolejki wyszukiwanie Google Hotels według id. Odpowiedź jest opakowana w kopertę DataForSEO: dane w tasks[0].result, wynik w tasks[0].status_code — odrzucone żądanie nadal zwraca HTTP 200. Odpowiedź jest opakowana w kopertę DataForSEO: dane w tasks[0].result, wynik w tasks[0].status_code — odrzucone żądanie nadal zwraca HTTP 200. ⚠️ Rozmiar odpowiedzi został ustalony przez depth lub limit ustawiony przy zgłoszeniu i nie można go tutaj zawęzić; jeśli jest zbyt duży, zgłoś zadanie z mniejszym zakresem zamiast stronicować.

Informacje o cenach

Rozliczanie: zgłoszony koszt odpowiedzi.
Referencyjny szacunek kosztu żądania: USD 0.012.
Referencyjny mnożnik klienta: 1.0. Nie stosuj go ponownie do rozliczonej kwoty klienta.

Wyłącznie metadane referencyjne — nie oferta dla konta, nie gwarantowana cena ani limit wydatków. Kredyty zasobów nie są kredytami Felo. Ostateczne obciążenia są zgodne z zapisami rozliczeniowymi Felo.

Parametry ścieżki

id
Typ: string
wymagane

identyfikator zadania
unikalny identyfikator zadania w naszym systemie w formacie UUID
można go używać przez 30 dni, aby w dowolnym momencie pobrać wyniki zadania

Odpowiedzi

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

łączny koszt zadań, USD

status_code
Typ: integer | null

ogólny kod statusu pełną listę kodów odpowiedzi znajdziesz tutaj

status_message
Typ: string | null

ogólny komunikat informacyjny pełną listę ogólnych komunikatów informacyjnych znajdziesz tutaj

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

tablica zadań

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

łączny koszt zadań, USD

data
Typ: object | null

zawiera te same parametry, które podano w żądaniu POST

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

identyfikator zadania unikalny identyfikator zadania w naszym systemie w formacie UUID

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

ścieżka URL

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

tablica wyników

check_url
Typ: string | null

bezpośredni adres URL do wyników wyszukiwarki
możesz go użyć, aby upewnić się, że dostarczyliśmy dokładne wyniki

datetime
Typ: string | null

data i godzina otrzymania wyniku
w formacie UTC: „yyyy-mm-dd hh-mm-ss +00:00”
przykład:
2019-11-15 12:57:46 +00:00

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

tablica elementów
uwaga: to pole zawsze równa się null; użyj go, aby ułatwić integrację i zapewnić interoperacyjność z endpointem Hotel Info

hotel_identifier
Typ: string | null

unikalny identyfikator hotelu w wyszukiwarce Google
przykład:
CgoI-KWyzenM_MV3EAE

is_paid
Typ: boolean | null

wskazuje płatną wizytówkę hotelu
jeśli true, powiązany hotel_search_item jest płatną reklamą
jeśli false, powiązany hotel_search_item jest organiczną wizytówką hotelu

location
Typ: object | null · Response36Afe1097B20_GpsCoordinatesLocationInfo

współrzędne GPS lokalizacji hotelu

latitude
Typ: number | null

szerokość geograficzna hotelu w mapach Google
przykład:
"latitude": 51.584091

longitude
Typ: number | null

długość geograficzna hotelu w mapach Google
przykład:
"longitude": -0.31365919999999997

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

wyróżnione obrazy hotelu

prices
Typ: object | null · Response36Afe1097B20_HotelPriceInfo

cena hotelu

check_in
Typ: string | null

data i godzina zameldowania
w formacie UTC: “yyyy-mm-dd hh-mm-ss +00:00”
przykład:
2019-11-15 12:57:46 +00:00

check_out
Typ: string | null

data i godzina wymeldowania
w formacie UTC: “yyyy-mm-dd hh-mm-ss +00:00”
przykład:
2019-11-15 12:57:46 +00:00

currency
Typ: string | null

waluta ceny
domyślnie stosowana jest USD, chyba że określono ją w tablicy POST

discount_text
Typ: string | null

tekst o zastosowanym rabacie

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

napotkane typy elementów
typy wyników wyszukiwania napotkane w tablicy items;
możliwe typy elementów: hotel_search_item

currency
Typ: string | null

waluta ceny
domyślnie stosowana jest USD, chyba że określono ją w tablicy POST

domain
Typ: string | null

domena zewnętrzna domena strony zewnętrznej witryny z informacjami o cenach

free_cancellation_until
Typ: string | null

data, do której dostępne jest bezpłatne anulowanie w formacie UTC: “yyyy-mm-dd hh-mm-ss +00:00” jest równe null, jeśli bezpłatne anulowanie nie jest dostępne dla wybranych dat

is_paid
Typ: boolean | null

wskazuje płatną wizytówkę hotelu
jeśli true, powiązany hotel_search_item jest płatną reklamą
jeśli false, powiązany hotel_search_item jest organiczną wizytówką hotelu

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

wyróżnione oferty cenowe

currency
Typ: string | null

waluta ceny
domyślnie stosowana jest USD, chyba że określono ją w tablicy POST

free_cancellation_until
Typ: string | null

data, do której dostępne jest bezpłatne anulowanie w formacie UTC: “yyyy-mm-dd hh-mm-ss +00:00” jest równe null, jeśli bezpłatne anulowanie nie jest dostępne dla wybranych dat

max_visitors
Typ: integer | null

maksymalna liczba gości maksymalna liczba gości, dla której obowiązuje oferta cenowa

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

obrazy oferty cenowej adresy URL obrazów zamieszczonych w ofercie cenowej

price
Typ: number | null

cena za noc

title
Typ: string | null

nazwa hotelu

type
Typ: string | null

typ elementu

url
Typ: string | null

url oferty cenowej URL strony internetowej, na której pojawia się oferta cenowa

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

cena za noc

title
Typ: string | null

nazwa hotelu

type
Typ: string | null

typ elementu

url
Typ: string | null

url strony zewnętrznej URL strony zewnętrznej witryny z informacjami o cenach

price
Typ: number | null

cena za noc

price_without_discount
Typ: number | null Format: int64

pełna cena za noc bez zastosowanego rabatu

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

waluta ceny
domyślnie stosowana jest USD, chyba że określono ją w tablicy POST

price
Typ: number | null

cena za noc

visitors
Typ: integer | null

liczba gości hotelowych dla tej ceny

reviews
Typ: object | null · Response36Afe1097B20_HotelReviewInfo

informacje o opiniach i ocenach hotelu

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

wzmianki o hotelu
informacje o opiniach o hotelu według kryteriów

negative_count
Typ: integer | null Format: int64

liczba negatywnych opinii według kryterium

positive_count
Typ: integer | null Format: int64

liczba pozytywnych opinii według kryterium

positive_score
Typ: number | null

wynik pozytywny według kryterium

title
Typ: string | null

tytuł ocenianego kryterium

total_count
Typ: integer | null Format: int64

liczba wszystkich opinii według kryterium

visible_by_default
Typ: boolean | null

element jest domyślnie widoczny
wskazuje, czy element opinii jest domyślnie widoczny

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

opinie w witrynach zewnętrznych
opinie z witryn zewnętrznych

rating
Typ: object | null · Response36Afe1097B20_RatingInfo

ocena w opinii
informacje o ocenie zawartej w opinii w witrynie zewnętrznej

rating_max
Typ: integer | null

maksymalna wartość dla rating_type

rating_type
Typ: string | null

typ oceny tutaj znajdziesz następujące elementy: Max5, Percents, CustomMax

value
Typ: number | null Format: double

wartość oceny

votes_count
Typ: integer | null Format: int64

liczba opinii

review_text
Typ: string | null

treść opinii
tekst opinii

title
Typ: string | null

tytuł opinii
zawiera nazwę witryny zewnętrznej, w której opinia pierwotnie się pojawiła

url
Typ: string | null

URL opinii
URL witryny zewnętrznej, w której opinia pierwotnie się pojawiła

rating_distribution
Typ: object | null

rozkład ocen według głosów
rozkład głosów w skali ocen od 1 do 5

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

ogólna ocena hotelu na podstawie głosów klientów

votes_count
Typ: integer | null Format: int64

liczba głosów klientów
liczba głosów klientów uwzględnionych w obliczeniu oceny hotelu

stars
Typ: integer | null

ocena klasy hotelu
ocena klasy w zakresie od 1 do 5 gwiazdek

title
Typ: string | null

nazwa hotelu

type
Typ: string | null

typ elementu

items_count
Typ: integer | null Format: int64

typy elementów
liczba elementów w tablicy items

keyword
Typ: string | null

słowo kluczowe otrzymane w tablicy POST
słowo kluczowe jest zwracane z odkodowanym %## (znak plus '+' zostanie odkodowany jako spacja);
aby uzyskać dokładne wyniki wyszukiwania, nazwa lokalizacji jest automatycznie dołączana do słowa kluczowego

language_code
Typ: string | null

kod języka w tablicy POST

location_code
Typ: integer | null

kod lokalizacji w tablicy POST

result_count
Typ: integer | null Format: int64

liczba elementów w tablicy result

status_code
Typ: integer | null

kod statusu zadania wygenerowany przez DataForSEO; może mieścić się w następującym zakresie: 10000-60000 pełną listę kodów odpowiedzi znajdziesz tutaj

status_message
Typ: string | null

komunikat informacyjny zadania pełną listę ogólnych komunikatów informacyjnych znajdziesz tutaj

time
Typ: string | null

czas wykonania, sekundy

tasks_count
Typ: integer | null Format: int64

liczba zadań w tablicy tasks

tasks_error
Typ: integer | null Format: int64

liczba zadań w tablicy tasks zwróconych z błędem

time
Typ: string | null

łączny czas wykonania, sekundy

version
Typ: string | null

bieżąca wersja interfejsu API
application/json
400

Nie można przetworzyć żądania. Sprawdź parametry żądania.
401

Wymagany jest prawidłowy klucz API Felo.
402

Nie można kontynuować żądania, ponieważ nie spełniono wymogu rozliczeniowego.
403

Konto nie ma uprawnień do wykonania tej operacji.
429

Osiągnięto limit żądań lub wydatków.
502

Usługa nie mogła ukończyć żądania.
503

API lub usługa rozliczeniowa jest tymczasowo niedostępna.
504

Upłynął limit czasu usługi podczas przetwarzania żądania.
default

Odpowiedź błędu; odpowiedzi przekazywane bezpośrednio od dostawcy upstream mogą używać formatów dostawcy

application/json

get/v1/beta/dataforseo/business_data/google/hotel_searches/task_get/{id}

curl https://openapi.felo.ai/v1/beta/dataforseo/business_data/google/hotel_searches/task_get/00000000-0000-0000-0000-000000000000 \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

Pokaż schemat

{
  "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]"
            }
          ]
        }
      ]
    }
  ]
}

Operacja zakończona powodzeniem

Pobieranie wyników wyszukiwania Google Hotels według id

UwierzytelnianieRequired

DataForSEO

Pobieranie wyników wyszukiwania Google Hotels według id

Informacje o cenach