Google Hotel Info na żywo — wersja zaawansowana
DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Google Hotel Info na żywo — wersja zaawansowana
Wizytówka jednego hotelu w Google: pokoje, udogodnienia, ceny i opcje rezerwacji pokazywane przez Google. Odpowiedź jest opakowana w kopertę DataForSEO: dane w tasks[0].result, wynik w tasks[0].status_code — odrzucone żądanie nadal zwraca HTTP 200. Wersja surowa to post_dataforseo_business_google_hotel_info_live_html, a wersja kolejkowana — post_dataforseo_business_google_hotel_info_submit. Aby najpierw znaleźć hotel, użyj post_dataforseo_business_google_hotel_searches_live.
Informacje o cenach
- Rozliczanie: zgłoszony koszt odpowiedzi.
- Referencyjny szacunek kosztu żądania: USD 0.2428.
- 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.
- Typ: array (object | null)[]
- adultsTyp: integer | null
liczba dorosłych
pole opcjonalne
jeśli nie podasz tego pola, domyślnie przyjętych zostanie dwóch dorosłych
przykład:1 - checkTyp: string | null
_in data zameldowania
pole opcjonalne
jeśli nie podasz tego pola, domyślnie użyta zostanie data jutrzejsza;
wartość nie może być wcześniejsza niż dzisiejsza data
format daty:"yyyy-mm-dd"
przykład:"2019-01-15" - checkTyp: string | null
_out data wymeldowania
pole opcjonalne
jeśli nie podasz tego pola, nasz system domyślnie zastosuje datę dwa dni od dziś;
Uwaga: wartość nie może być mniejsza lub równacheck_in;
zakres między wartościamicheck_inicheck_outnie może przekraczać 30 dni
format daty:"yyyy-mm-dd"
przykład:"2019-01-15" - childrenTyp: array string[] | null
liczba i wiek dzieci
pole opcjonalne
jeśli nie podasz tego pola, w wyszukiwaniu nie zostaną uwzględnione żadne dzieci;ustaw poniższą wartość, aby uwzględnić jedno 14-letnie dziecko:
[14]
ustaw poniższą wartość, aby uwzględnić jedno 13-letnie dziecko i jedno 8-letnie dziecko:[13,8] - currencyTyp: string | null
waluta
pole opcjonalne
przykład:"USD" - hotelTyp: string
_identifier unikalny identyfikator hotelu
pole wymagane
unikalny identyfikator obiektu hotelowego w wyszukiwarce Google;
wartość możesz uzyskać, wysyłając żądanie do Advanced Google SERP API (znajdziesz go w elemenciehotelsodpowiedzi) lub do endpointu Hotel Searches w Business Data API
przykład:ChYIq6SB--i6p6cpGgovbS8wN2s5ODZfEAE - languageTyp: string
_code kod języka wyszukiwarki
pole wymagane, jeśli nie podaszlanguage_name
jeśli użyjesz tego pola, nie musisz podawaćlanguage_name
listę dostępnych języków wraz z ichlanguage_codemożesz uzyskać, wysyłając osobne żądanie dohttps://api.dataforseo.com/v3/business_data/google/languages
przykład:en - languageTyp: string
_name pełna nazwa języka wyszukiwarki
pole wymagane, jeśli nie podaszlanguage_code
jeśli użyjesz tego pola, nie musisz podawaćlanguage_code
listę dostępnych języków zlanguage_namemożesz uzyskać, wysyłając osobne żądanie dohttps://api.dataforseo.com/v3/business_data/google/languages
przykład:English - loadTyp: boolean | null
_prices _by _dates pobieranie cen pobytu hotelowego według dat
pole opcjonalne
jeśli podasz ten parametr z wartościątrue, odpowiedź będzie zawierać tablicęprices_by_datesz cenami pobytu hotelowego podzielonymi według dat
jeśli użyjesz tego parametru, zostanie naliczona podwójna cena bazowa za żądanie - locationTyp: integer
_code kod lokalizacji wyszukiwarki
pole wymagane, jeśli nie podaszlocation_namelublocation_coordinate
jeśli użyjesz tego pola, nie musisz podawaćlocation_namelublocation_coordinate
listę dostępnych lokalizacji zlocation_codemożesz uzyskać, wysyłając osobne żądanie dohttps://api.dataforseo.com/v3/business_data/google/locations
przykład:2840 - locationTyp: string
_coordinate współrzędne GPS lokalizacji
pole wymagane, jeśli nie podaszlocation_namelublocation_code
jeśli użyjesz tego pola, nie musisz podawaćlocation_namelublocation_code
parametrlocation_coordinatenależy podać w formacie "latitude, longitude"
maksymalna liczba cyfr po przecinku dla "latitude" i "longitude": 7
Uwaga: jeśli współrzędne służą do ustawienia lokalizacji, wyszukiwanie odbędzie się w najbliższej miejscowości;
przykład:53.476225,-2.243572 - locationTyp: string
_name pełna nazwa lokalizacji wyszukiwarki
pole wymagane, jeśli nie podaszlocation_codelublocation_coordinate
jeśli użyjesz tego pola, nie musisz podawaćlocation_codelublocation_coordinate
listę dostępnych lokalizacji zlocation_namemożesz uzyskać, wysyłając osobne żądanie dohttps://api.dataforseo.com/v3/business_data/google/locations
przykład:London,England,United Kingdom - pricesTyp: string | null
_date _range zdefiniowany okres pobierania dziennych danych cenowych
pole opcjonalne
aby użyć tego parametru, musisz podaćload_prices_by_datesz wartościątrue
jeśliprices_start_datenie zostanie podana, data początkowa jest ustawiana na datęcheck_in
możliwe wartości:month,three_months,six_months,year
wartość domyślna:month - pricesTyp: string | null
_end _date data końcowa pobierania cen według dat
pole opcjonalne
aby użyć tego parametru, musisz podaćload_prices_by_datesz wartościątrue
jeśli ten parametr nie zostanie podany, otrzymasz ceny według daty za miesiąc
format daty:yyyy-mm-dd
przykład:2025-05-21 - pricesTyp: string | null
_start _date data początkowa pobierania cen według dat
pole opcjonalne
aby użyć tego parametru, musisz podaćload_prices_by_datesz wartościątrue
jeśli ten parametr nie zostanie podany, data początkowa jest ustawiana na datęcheck_in
format daty:yyyy-mm-dd
przykład:2025-05-20 - tagTyp: string | null
identyfikator zadania zdefiniowany przez użytkownika
pole opcjonalne
limit znaków: 255
ten parametr służy do identyfikacji zadania i dopasowania go do wyniku
podaną wartośćtagznajdziesz w obiekciedataodpowiedzi
- Typ: object | null · Response36Afe1097B20_BusinessDataGoogleHotelInfoLiveAdvancedResponseInfo200
- Typ: number | null Format: doublecost
łączny koszt zadań, USD
- Typ: integer | nullstatus
_code ogólny kod statusu pełną listę kodów odpowiedzi znajdziesz tutaj
- Typ: string | nullstatus
_message ogólny komunikat informacyjny pełną listę ogólnych komunikatów informacyjnych znajdziesz tutaj
- Typ: array (object | null)[] | nulltasks
tablica zadań
- Typ: object | null · Response36Afe1097B20_BusinessDataGoogleHotelInfoLiveAdvancedTaskInfo
- costTyp: number | null Format: double
łączny koszt zadań, USD
- dataTyp: object | null
zawiera te same parametry, które podano w żądaniu POST
- propertyTyp: object | null
Name
- idTyp: string | null
identyfikator zadania unikalny identyfikator zadania w naszym systemie w formacie UUID
- pathTyp: array (string | null)[] | null
ścieżka URL
- resultTyp: array (object | null)[] | null
tablica wyników
- aboutTyp: object | null · Response36Afe1097B20_HotelAboutInfo
informacje o hotelu
- amenitiesTyp: array (object | null)[] | null
udogodnienia hotelu
informacje o udogodnieniach hotelu- categoryTyp: string | null
standardowa kategoria udogodnienia
- categoryTyp: string | null
_label etykieta kategorii
- itemsTyp: array (object | null)[] | null
konkretne udogodnienia i szczegóły
- amenityTyp: string | null
standardowa nazwa udogodnienia
- amenityTyp: string | null
_label wyświetlana nazwa udogodnienia
- hintTyp: string | null
standardowe szczegóły udogodnienia
- hintTyp: string | null
_label wyświetlane szczegóły udogodnienia
- isTyp: boolean | null
_available wskazuje, czy
amenityjest dostępne w hotelu
- checkTyp: object | null · Response36Afe1097B20_TimeInfo
_in _time godzina zameldowania w hotelu
godzina zameldowania wskazana w ofercie hotelu- hourTyp: integer | null
godziny w formacie 24-godzinnym
- minuteTyp: integer | null
minuty
- checkTyp: object | null · Response36Afe1097B20_TimeInfo
_out _time godzina wymeldowania z hotelu
godzina wymeldowania wskazana w ofercie hotelu- hourTyp: integer | null
godziny w formacie 24-godzinnym
- minuteTyp: integer | null
minuty
- descriptionTyp: string | null
opis hotelu
opis obiektu hotelowego, dla którego zbierane są wyniki - domainTyp: string | null
domena hotelu
domena witryny hotelu - fullTyp: string | null
_address pełny adres hotelu
adres hotelu wskazany w standardowym formacie - popularTyp: array (object | null)[] | null
_amenities udogodnienia hotelu
informacje o udogodnieniach hotelu oznaczonych jako „popularne”- amenityTyp: string | null
standardowa nazwa udogodnienia
- amenityTyp: string | null
_label wyświetlana nazwa udogodnienia
- hintTyp: string | null
standardowe szczegóły udogodnienia
- hintTyp: string | null
_label wyświetlane szczegóły udogodnienia
- isTyp: boolean | null
_available wskazuje, czy
amenityjest dostępne w hotelu
- subTyp: array (string | null)[] | null
_descriptions dodatkowy opis hotelu
szczegóły hotelu podane oprócz opisu - urlTyp: string | null
url hotelu
URL witryny hotelu wskazany w ofercie
- addressTyp: string | null
adres hotelu
fizyczny adres hotelu - checkTyp: string | null
_url bezpośredni adres URL do wyników wyszukiwarki
możesz go użyć, aby upewnić się, że dostarczyliśmy dokładne wyniki - datetimeTyp: 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 - hotelTyp: string | null
_identifier identyfikator otrzymany w tablicy POST
to pole będzie zawierać parametrhotel_identifierpodany podczas ustawiania zadania;
przykład:CgoI-KWyzenM_MV3EAE - languageTyp: string | null
_code kod języka w tablicy POST
- locationTyp: object | null · Response36Afe1097B20_HotelLocationInfo
informacje o lokalizacji hotelu
informacje o lokalizacji, w której znajduje się hotel- latitudeTyp: number | null
szerokość geograficzna hotelu
współrzędne szerokości geograficznej lokalizacji hotelu
przykład:39.4806397 - locationTyp: array (object | null)[] | null
_chain elementy łańcucha lokalizacji
dodatkowe parametry każdego elementu łańcucha lokalizacji- cardTyp: string | null
_id identyfikator karty
- cidTyp: string | null
- featureTyp: string | null
_id - titleTyp: string | null
tytuł elementu w łańcuchu lokalizacji
- longitudeTyp: number | null
długość geograficzna hotelu
współrzędne długości geograficznej lokalizacji hotelu
przykład:-106.0512973 - mapsTyp: string | null
_url url lokalizacji hotelu w mapach Google
- neighborhoodTyp: string | null
nazwa dzielnicy, w której znajduje się hotel
- neighborhoodTyp: string | null
_description opis dzielnicy, w której znajduje się hotel
- overallTyp: number | null
_score ogólna ocena lokalizacji hotelu
wskazuje ogólną ocenę lokalizacji hotelu w zakresie od 1 do 5;
obliczana na podstawie danych o bliskości hotelu do pobliskich atrakcji i restauracji, transportu i lotnisk;
pamiętaj, że kryteria nie mają równej wagi w ogólnej ocenie - scoreTyp: object | null
_by _categories oceny kategorii lokalizacji hotelu
oceny lokalizacji hotelu powiązane z kategoriami wskazującymi bliskość pobliskich atrakcji, restauracji, transportu i lotnisk;- propertyTyp: number | null Format: double
Name
- locationTyp: integer | null
_code kod lokalizacji w tablicy POST
- overviewTyp: array (string | null)[] | null
_images obrazy wyświetlane w przeglądzie hotelu
tablica zawierająca URL-e obrazów wyświetlanych w przeglądzie hotelu - phoneTyp: string | null
numer telefonu hotelu
kontaktowy numer telefonu hotelu - pricesTyp: object | null · Response36Afe1097B20_HotelPriceInfo
szczegóły cen hotelu
zawiera informacje o cenach hotelu- checkTyp: string | null
_in 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 - checkTyp: string | null
_out 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 - currencyTyp: string | null
waluta ceny
domyślnie stosowana jestUSD, chyba że określono ją w tablicy POST - discountTyp: string | null
_text tekst o zastosowanym rabacie
- itemsTyp: array (object | null)[] | null
napotkane typy elementów
typy wyników wyszukiwania napotkane w tablicyitems;
możliwe typy elementów:hotel_search_item- currencyTyp: string | null
waluta ceny
domyślnie stosowana jestUSD, chyba że określono ją w tablicy POST - domainTyp: string | null
domena zewnętrzna domena strony zewnętrznej witryny z informacjami o cenach
- freeTyp: string | null
_cancellation _until 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
- isTyp: boolean | null
_paid wskazuje płatną wizytówkę hotelu
jeślitrue, powiązanyhotel_search_itemjest płatną reklamą
jeślifalse, powiązanyhotel_search_itemjest organiczną wizytówką hotelu - offersTyp: array (object | null)[] | null
wyróżnione oferty cenowe
- currencyTyp: string | null
waluta ceny
domyślnie stosowana jestUSD, chyba że określono ją w tablicy POST - freeTyp: string | null
_cancellation _until 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
- maxTyp: integer | null
_visitors maksymalna liczba gości maksymalna liczba gości, dla której obowiązuje oferta cenowa
- offerTyp: array (string | null)[] | null
_images obrazy oferty cenowej adresy URL obrazów zamieszczonych w ofercie cenowej
- priceTyp: number | null
cena za noc
- titleTyp: string | null
nazwa hotelu
- typeTyp: string | null
typ elementu
- urlTyp: string | null
url oferty cenowej URL strony internetowej, na której pojawia się oferta cenowa
- officialTyp: boolean | null
_site - priceTyp: number | null
cena za noc
- titleTyp: string | null
nazwa hotelu
- typeTyp: string | null
typ elementu
- urlTyp: string | null
url strony zewnętrznej URL strony zewnętrznej witryny z informacjami o cenach
- priceTyp: number | null
cena za noc
- priceTyp: number | null Format: int64
_without _discount pełna cena za noc bez zastosowanego rabatu
- pricesTyp: array (object | null)[] | null
_by _dates - checkTyp: string | null
_in _date - checkTyp: string | null
_out _date - currencyTyp: string | null
waluta ceny
domyślnie stosowana jestUSD, chyba że określono ją w tablicy POST - priceTyp: number | null
cena za noc
- visitorsTyp: integer | null
liczba gości hotelowych dla tej ceny
- reviewsTyp: object | null · Response36Afe1097B20_HotelReviewInfo
opinie o hotelu według kryteriów
informacje o opiniach dotyczących hotelu- mentionsTyp: array (object | null)[] | null
wzmianki o hotelu
informacje o opiniach o hotelu według kryteriów- negativeTyp: integer | null Format: int64
_count liczba negatywnych opinii według kryterium
- positiveTyp: integer | null Format: int64
_count liczba pozytywnych opinii według kryterium
- positiveTyp: number | null
_score wynik pozytywny według kryterium
- titleTyp: string | null
tytuł ocenianego kryterium
- totalTyp: integer | null Format: int64
_count liczba wszystkich opinii według kryterium
- visibleTyp: boolean | null
_by _default element jest domyślnie widoczny
wskazuje, czy element opinii jest domyślnie widoczny
- otherTyp: array (object | null)[] | null
_sites _reviews opinie w witrynach zewnętrznych
opinie z witryn zewnętrznych- ratingTyp: object | null · Response36Afe1097B20_RatingInfo
ocena w opinii
informacje o ocenie zawartej w opinii w witrynie zewnętrznej- ratingTyp: integer | null
_max maksymalna wartość dla rating_type
- ratingTyp: string | null
_type typ oceny tutaj znajdziesz następujące elementy: Max5, Percents, CustomMax
- valueTyp: number | null Format: double
wartość oceny
- votesTyp: integer | null Format: int64
_count liczba opinii
- reviewTyp: string | null
_text treść opinii
tekst opinii - titleTyp: string | null
tytuł opinii
zawiera nazwę witryny zewnętrznej, w której opinia pierwotnie się pojawiła - urlTyp: string | null
URL opinii
URL witryny zewnętrznej, w której opinia pierwotnie się pojawiła
- ratingTyp: object | null
_distribution rozkład ocen według głosów
rozkład głosów w skali ocen od 1 do 5- propertyTyp: integer | null Format: Int64
Name
- valueTyp: number | null
ogólna ocena hotelu na podstawie głosów klientów
- votesTyp: integer | null Format: int64
_count liczba głosów klientów
liczba głosów klientów uwzględnionych w obliczeniu oceny hotelu
- starsTyp: integer | null
ocena klasy hotelu
ocena klasy w zakresie od 1 do 5 gwiazdek, wyświetlana po ocenach z opinii w podsumowaniu hotelu - starsTyp: string | null
_description ocena klasy hotelu
ocena klasy w zakresie od 1 do 5 gwiazdek, wyświetlana po ocenach z opinii w podsumowaniu hotelu - titleTyp: string | null
nazwa hotelu
nazwa hotelu, dla którego zbierane są wyniki
- resultTyp: integer | null Format: int64
_count liczba elementów w tablicy result
- statusTyp: integer | null
_code 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
- statusTyp: string | null
_message komunikat informacyjny zadania pełną listę ogólnych komunikatów informacyjnych znajdziesz tutaj
- timeTyp: string | null
czas wykonania, sekundy
- Typ: integer | null Format: int64tasks
_count liczba zadań w tablicy tasks
- Typ: integer | null Format: int64tasks
_error liczba zadań w tablicy tasks zwróconych z błędem
- Typ: string | nulltime
łączny czas wykonania, sekundy
- Typ: string | nullversion
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
curl https://openapi.felo.ai/v1/beta/dataforseo/business_data/google/hotel_info/live/advanced \
--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": "CgoI-KWyzenM_MV3EAE"
}
]'
{
"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": [
{
"hotel_identifier": null,
"location_code": null,
"language_code": null,
"check_url": null,
"datetime": null,
"title": null,
"stars": null,
"stars_description": null,
"address": null,
"phone": null,
"about": {
"description": null,
"sub_descriptions": [
"[Max Depth Exceeded]"
],
"check_in_time": "[Max Depth Exceeded]",
"check_out_time": "[Max Depth Exceeded]",
"full_address": null,
"domain": null,
"url": null,
"amenities": [
"[Max Depth Exceeded]"
],
"popular_amenities": [
"[Max Depth Exceeded]"
]
},
"location": {
"neighborhood": null,
"neighborhood_description": null,
"maps_url": null,
"overall_score": null,
"score_by_categories": null,
"latitude": null,
"longitude": null,
"location_chain": [
"[Max Depth Exceeded]"
]
},
"reviews": {
"value": null,
"votes_count": null,
"mentions": [
"[Max Depth Exceeded]"
],
"rating_distribution": null,
"other_sites_reviews": [
"[Max Depth Exceeded]"
]
},
"overview_images": [
null
],
"prices": {
"price": null,
"price_without_discount": null,
"currency": null,
"discount_text": null,
"check_in": null,
"check_out": null,
"visitors": null,
"items": [
"[Max Depth Exceeded]"
],
"prices_by_dates": [
"[Max Depth Exceeded]"
]
}
}
]
}
]
}