Zadania wyszukiwania Google Hotels na żywo
DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Zadania wyszukiwania Google Hotels na żywo
Przeszukuje Google Hotels w poszukiwaniu obiektów pasujących do zapytania, z datami i obłożeniem. Odpowiedź jest opakowana w kopertę DataForSEO: dane w tasks[0].result, wynik w tasks[0].status_code — odrzucone żądanie nadal zwraca HTTP 200. Tak znajdziesz hotel, którego id wymagają endpointy informacyjne; post_dataforseo_business_google_hotel_info_live to widok szczegółowy.
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, zostanie zastosowana wartość domyślna2;
uwaga: możesz podać maksymalnie 6 osób, łącznie z dorosłymi i dziećmi
przykład:1 - amenitiesTyp: array string[] | null
udogodnienia hotelu
pole opcjonalne
za pomocą tego pola możesz określić różne udogodnienia hotelu
przykład:[
"free_parking",
"pets_allowed"
]
możliwe wartości:"air_conditioning",<br>"all_inclusive_available",<br>"bar",<br>"free_breakfast",<br>"fitness_center",<br>"kid_friendly",<br>"free_parking",<br>"pets_allowed",<br>"pool",<br>"restaurant",<br>"room_service",<br>"spa",<br>"free_wifi",<br>"parking",<br>"indoor_pool",<br>"outdoor_pool",<br>"wheelchair_accessible",<br>"beach_access" - checkTyp: string | null
_in data zameldowania
pole opcjonalne
jeśli nie podasz tego pola, domyślnie użyta zostanie data jutrzejsza;
format daty:"yyyy-mm-dd"
przykład:"2019-01-15"
Uwaga: wartość nie może poprzedzać dzisiejszej daty - checkTyp: string | null
_out data wymeldowania
pole opcjonalne
jeśli nie podasz tego pola, nasz system domyślnie zastosuje datę dwa dni od dziś;
format daty:"yyyy-mm-dd"
przykład:"2019-01-15"
Uwaga: wartość nie może być mniejsza lub równacheck_in;
zakres między wartościamicheck_inicheck_outnie może przekraczać 30 dni - childrenTyp: array string[] | null
liczba i wiek dzieci
pole opcjonalne
jeśli nie podasz tego pola, w wyszukiwaniu nie zostaną uwzględnione żadne dzieci;
wiek dziecka może wynosić od0do17;
uwaga: możesz podać maksymalnie 6 osób, łącznie z dorosłymi i dziećmi
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" - depthTyp: integer | null
głębokość parsowania
pole opcjonalne
liczba wyników w Google Hotels
wartość domyślna:18wyników organicznych
wartość maksymalna:140
Uwaga: Twoje konto zostanie rozliczone za każde 18 wyników organicznych niezależnie od płatnych pozycji w odpowiedzi;
zatem ustawienie głębokości powyżej18może skutkować dodatkowymi opłatami, jeśli Google Hotels zwróci więcej niż 18 wyników;
jeśli podana głębokość jest większa niż liczba wyników w odpowiedzi, różnica zostanie automatycznie zwrócona na saldo Twojego konta - freeTyp: boolean | null
_cancellation hotele z bezpłatnym anulowaniem
pole opcjonalne
ustaw to pole natrue, jeśli chcesz otrzymać listę hoteli z bezpłatnym anulowaniem rezerwacji
wartość domyślna:false - isTyp: boolean | null
_vacation _rentals wyszukiwanie noclegów wakacyjnych
pole opcjonalne
ustaw to pole natrue, jeśli chcesz otrzymać listę noclegów wakacyjnych zamiast hoteli
wartość domyślna:false - keywordTyp: string | null
słowo kluczowe
pole opcjonalne
podane słowo kluczowe służy do wyszukania listy hoteli;
jeśli nie użyjesz tego pola, zwrócimy listę hoteli znalezionych w podanej lokalizacji;
w polukeywordmożesz podać do 700 znaków
wszystkie ciągi %## zostaną zdekodowane (znak „+” zostanie zdekodowany jako spacja)
jeśli potrzebujesz użyć znaku „%” wkeyword, podaj go jako „%25”;
Uwaga: aby uzyskać dokładne wyniki wyszukiwania, nazwa lokalizacji jest automatycznie dołączana do słowa kluczowegowięcej o zasadach i ograniczeniach pól
keywordikeywordsw interfejsach DataForSEO znajdziesz w tym artykule Centrum pomocy - 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 - 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
Uwaga: aby uzyskać dokładne wyniki wyszukiwania, podanalocation_namezostanie automatycznie dołączona do słowa kluczowego - maxTyp: integer | null
_price maksymalna cena za noc
pole opcjonalne
waluta tej wartości zależy od polacurrency
przykład:600 - minTyp: integer | null
_price minimalna cena za noc
pole opcjonalne
waluta tej wartości zależy od polacurrency
przykład:100 - minTyp: number | null
_rating minimalna ocena
pole opcjonalne
za pomocą tego pola możesz określić ocenę gości wyższą niż pewna wartość
przykład:2.5 - searchTyp: boolean | null
_this _area pokaż hotele z wyświetlanego obszaru
pole opcjonalne
może przyjmować wartości:true,false
wartość domyślna:true
po ustawieniu nafalsetrybsearch_this_areazostanie wyłączony
Uwaga: jeśli trybsearch_this_areajest wyłączony,location_namenie będzie dołączana dokeywordpodczas wyszukiwania
więcej o tym parametrze w naszym Centrum pomocy - sortTyp: string | null
_by parametry sortowania wyników
pole opcjonalne
za pomocą tego pola możesz sortować wyniki
możliwe typy sortowania:relevance– sortowanie według największej trafnościlowest_price– sortowanie według najniższej cenyhighest_rating– sortowanie według najwyższej ocenymost_reviewed– sortowanie według największej liczby opinii
wartość domyślna:relevance - starsTyp: array string[] | null
liczba gwiazdek hotelu
pole opcjonalne
ustaw to pole na[5], jeśli chcesz otrzymać wyłącznie listę hoteli 5-gwiazdkowych
przykład:[3,4,5] - 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_BusinessDataGoogleHotelSearchesLiveResponseInfo200
- 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_BusinessDataGoogleHotelSearchesLiveTaskInfo
- 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
- 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 - itemsTyp: array (object | null)[] | null
napotkane typy elementów
typy wyników wyszukiwania napotkane w tablicyitems;
możliwe typy elementów:hotel_search_item- hotelTyp: string | null
_identifier unikalny identyfikator hotelu w wyszukiwarce Google
przykład:CgoI-KWyzenM_MV3EAE - 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 - locationTyp: object | null · Response36Afe1097B20_GpsCoordinatesLocationInfo
współrzędne GPS lokalizacji hotelu
- latitudeTyp: number | null
szerokość geograficzna hotelu w mapach Google
przykład:"latitude": 51.584091 - longitudeTyp: number | null
długość geograficzna hotelu w mapach Google
przykład:"longitude": -0.31365919999999997
- overviewTyp: array (string | null)[] | null
_images wyróżnione obrazy hotelu
- pricesTyp: object | null · Response36Afe1097B20_HotelPriceInfo
cena 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
informacje o opiniach i ocenach 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 - titleTyp: string | null
nazwa hotelu
- typeTyp: string | null
typ elementu
- itemsTyp: integer | null Format: int64
_count typy elementów
liczba elementów w tablicyitems - keywordTyp: string | null
słowo kluczowe otrzymane w tablicy POST
słowo kluczowe jest zwracane z zdekodowanym %## (znak plus '+' zostanie zdekodowany jako spacja) - languageTyp: string | null
_code kod języka w tablicy POST
- locationTyp: integer | null
_code kod lokalizacji w tablicy POST
- 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_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"
}
]'
{
"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]"
}
]
}
]
}
]
}