DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Google Hotel Info naživo – rozšířené
Firemní záznam jednoho hotelu v Google: pokoje, vybavení, ceny a možnosti rezervace, které Google zobrazuje. Odpověď je zabalena do obálky DataForSEO: data v tasks[0].result, výsledek v tasks[0].status_code – odmítnutý požadavek stále vrací HTTP 200. Surová podoba je post_dataforseo_business_google_hotel_info_live_html a frontovaná podoba post_dataforseo_business_google_hotel_info_submit. Nejprve hotel najděte pomocí post_dataforseo_business_google_hotel_searches_live.
Referenční ceny
- Účtování: vykázaná cena odpovědi.
- Referenční odhad ceny požadavku: USD 0.2428.
- Referenční multiplikátor zákazníka: 1.0. Znovu jej neaplikujte na již zúčtovanou částku zákazníka.
Pouze referenční metadata — nikoli nabídka pro účet, garantovaná cena ani limit utrácení. Kredity prostředků nejsou kredity Felo. Konečné účtování se řídí fakturačními záznamy Felo.
- Typ: array (object | null)[]
- adultsTyp: integer | null
počet dospělých
volitelné pole
pokud toto pole nezadáte, použijí se ve výchozím nastavení dva dospělí
příklad:1 - checkTyp: string | null
_in datum příjezdu
volitelné pole
pokud toto pole nezadáte, použije se ve výchozím nastavení zítřejší datum;
hodnota nesmí být dřívější než dnešní datum
formát data:"yyyy-mm-dd"
příklad:"2019-01-15" - checkTyp: string | null
_out datum odjezdu
volitelné pole
pokud toto pole nezadáte, náš systém ve výchozím nastavení použije datum dva dny od dnešního dne;
Poznámka: hodnota nesmí být menší nebo rovna hodnotěcheck_in;
rozsah mezi hodnotamicheck_inacheck_outnesmí přesáhnout 30 dní
formát data:"yyyy-mm-dd"
příklad:"2019-01-15" - childrenTyp: array string[] | null
počet a věk dětí
volitelné pole
pokud toto pole nezadáte, nebudou do vyhledávání zahrnuty žádné děti;nastavte následující hodnotu, chcete-li zahrnout jedno 14leté dítě:
[14]
nastavte následující hodnotu, chcete-li zahrnout jedno 13leté dítě a jedno 8leté dítě:[13,8] - currencyTyp: string | null
měna
volitelné pole
příklad:"USD" - hotelTyp: string
_identifier jedinečný identifikátor hotelu
povinné pole
jedinečný identifikátor hotelového subjektu ve vyhledávání Google;
hodnotu můžete získat odesláním požadavku na Advanced Google SERP API (je uvedena v prvkuhotelsodpovědi) nebo na endpoint Hotel Searches rozhraní Business Data API
příklad:ChYIq6SB--i6p6cpGgovbS8wN2s5ODZfEAE - languageTyp: string
_code kód jazyka vyhledávače
povinné pole, pokud nezadátelanguage_name
pokud toto pole použijete, nemusíte zadávatlanguage_name
seznam dostupných jazyků s jejichlanguage_codezískáte samostatným požadavkem nahttps://api.dataforseo.com/v3/business_data/google/languages
příklad:en - languageTyp: string
_name úplný název jazyka vyhledávače
povinné pole, pokud nezadátelanguage_code
pokud toto pole použijete, nemusíte zadávatlanguage_code
seznam dostupných jazyků slanguage_namezískáte samostatným požadavkem nahttps://api.dataforseo.com/v3/business_data/google/languages
příklad:English - loadTyp: boolean | null
_prices _by _dates načtení cen pobytu v hotelu podle dat
volitelné pole
pokud tento parametr zadáte s hodnotoutrue, odpověď bude obsahovat poleprices_by_datess cenami pobytu v hotelu rozdělenými podle dat
pokud tento parametr použijete, bude vám účtována dvojnásobná základní cena za požadavek - locationTyp: integer
_code kód lokality vyhledávače
povinné pole, pokud nezadátelocation_namenebolocation_coordinate
pokud toto pole použijete, nemusíte zadávatlocation_nameanilocation_coordinate
seznam dostupných lokalit slocation_codezískáte samostatným požadavkem nahttps://api.dataforseo.com/v3/business_data/google/locations
příklad:2840 - locationTyp: string
_coordinate GPS souřadnice lokality
povinné pole, pokud nezadátelocation_namenebolocation_code
pokud toto pole použijete, nemusíte zadávatlocation_nameanilocation_code
parametrlocation_coordinateje nutné zadat ve formátu "latitude, longitude"
maximální počet desetinných míst pro "latitude" a "longitude": 7
Poznámka: pokud se souřadnice použijí k nastavení lokality, vyhledávání proběhne v nejbližší osadě;
příklad:53.476225,-2.243572 - locationTyp: string
_name úplný název lokality vyhledávače
povinné pole, pokud nezadátelocation_codenebolocation_coordinate
pokud toto pole použijete, nemusíte zadávatlocation_codeanilocation_coordinate
seznam dostupných lokalit slocation_namezískáte samostatným požadavkem nahttps://api.dataforseo.com/v3/business_data/google/locations
příklad:London,England,United Kingdom - pricesTyp: string | null
_date _range předdefinované období pro získávání denních cenových údajů
volitelné pole
pro použití tohoto parametru musíte zadatload_prices_by_datess hodnotoutrue
pokudprices_start_datenení zadáno, počáteční datum se nastaví na datumcheck_in
možné hodnoty:month,three_months,six_months,year
výchozí hodnota:month - pricesTyp: string | null
_end _date koncové datum pro načtení cen podle dat
volitelné pole
pro použití tohoto parametru musíte zadatload_prices_by_datess hodnotoutrue
pokud tento parametr nezadáte, získáte ceny podle data za měsíc
formát data:yyyy-mm-dd
příklad:2025-05-21 - pricesTyp: string | null
_start _date počáteční datum pro načtení cen podle dat
volitelné pole
pro použití tohoto parametru musíte zadatload_prices_by_datess hodnotoutrue
pokud tento parametr nezadáte, počáteční datum se nastaví na datumcheck_in
formát data:yyyy-mm-dd
příklad:2025-05-20 - tagTyp: string | null
uživatelem definovaný identifikátor úlohy
volitelné pole
limit znaků je 255
tento parametr můžete použít k identifikaci úlohy a jejímu spárování s výsledkem
zadanou hodnotutagnajdete v objektudataodpovědi
- Typ: object | null · Response36Afe1097B20_BusinessDataGoogleHotelInfoLiveAdvancedResponseInfo200
- Typ: number | null Formát: doublecost
celkové náklady na úlohy, USD
- Typ: integer | nullstatus
_code obecný kód stavu úplný seznam kódů odpovědí najdete zde
- Typ: string | nullstatus
_message obecná informační zpráva úplný seznam obecných informačních zpráv najdete zde
- Typ: array (object | null)[] | nulltasks
pole úloh
- Typ: object | null · Response36Afe1097B20_BusinessDataGoogleHotelInfoLiveAdvancedTaskInfo
- costTyp: number | null Formát: double
celkové náklady na úlohy, USD
- dataTyp: object | null
obsahuje stejné parametry, které jste zadali v požadavku POST
- propertyTyp: object | null
Name
- idTyp: string | null
identifikátor úlohy jedinečný identifikátor úlohy v našem systému ve formátu UUID
- pathTyp: array (string | null)[] | null
cesta URL
- resultTyp: array (object | null)[] | null
pole výsledků
- aboutTyp: object | null · Response36Afe1097B20_HotelAboutInfo
informace o hotelu
- amenitiesTyp: array (object | null)[] | null
vybavení hotelu
informace o vybavení hotelu- categoryTyp: string | null
standardizovaná kategorie vybavení
- categoryTyp: string | null
_label označení kategorie
- itemsTyp: array (object | null)[] | null
konkrétní vybavení a podrobnosti
- amenityTyp: string | null
standardizovaný název vybavení
- amenityTyp: string | null
_label zobrazovaný název vybavení
- hintTyp: string | null
standardizované podrobnosti o vybavení
- hintTyp: string | null
_label zobrazované podrobnosti o vybavení
- isTyp: boolean | null
_available určuje, zda je
amenityv hotelu k dispozici
- checkTyp: object | null · Response36Afe1097B20_TimeInfo
_in _time doba check-inu v hotelu
doba check-inu uvedená v nabídce hotelu- hourTyp: integer | null
hodiny ve 24hodinovém formátu
- minuteTyp: integer | null
minuty
- checkTyp: object | null · Response36Afe1097B20_TimeInfo
_out _time doba check-outu v hotelu
doba check-outu uvedená v nabídce hotelu- hourTyp: integer | null
hodiny ve 24hodinovém formátu
- minuteTyp: integer | null
minuty
- descriptionTyp: string | null
popis hotelu
popis hotelového zařízení, pro které se výsledky shromažďují - domainTyp: string | null
doména hotelu
doména webu hotelu - fullTyp: string | null
_address úplná adresa hotelu
adresa hotelu uvedená ve standardizovaném formátu - popularTyp: array (object | null)[] | null
_amenities vybavení hotelu
informace o vybavení hotelu označeném jako „populární”- amenityTyp: string | null
standardizovaný název vybavení
- amenityTyp: string | null
_label zobrazovaný název vybavení
- hintTyp: string | null
standardizované podrobnosti o vybavení
- hintTyp: string | null
_label zobrazované podrobnosti o vybavení
- isTyp: boolean | null
_available určuje, zda je
amenityv hotelu k dispozici
- subTyp: array (string | null)[] | null
_descriptions doplňující popis hotelu
podrobnosti o hotelu uvedené nad rámec popisu - urlTyp: string | null
url hotelu
URL webu hotelu uvedená v nabídce
- addressTyp: string | null
adresa hotelu
fyzická adresa hotelu - checkTyp: string | null
_url přímá adresa URL na výsledky vyhledávače
můžete ji použít k ověření, že jsme poskytli přesné výsledky - datetimeTyp: string | null
datum a čas přijetí výsledku
ve formátu UTC: „yyyy-mm-dd hh-mm-ss +00:00”
příklad:2019-11-15 12:57:46 +00:00 - hotelTyp: string | null
_identifier identifikátor obdržený v poli POST
toto pole bude obsahovat parametrhotel_identifierzadaný při nastavování úlohy;
příklad:CgoI-KWyzenM_MV3EAE - languageTyp: string | null
_code kód jazyka v poli POST
- locationTyp: object | null · Response36Afe1097B20_HotelLocationInfo
informace o poloze hotelu
informace o místě, kde se hotel nachází- latitudeTyp: number | null
zeměpisná šířka hotelu
souřadnice zeměpisné šířky polohy hotelu
příklad:39.4806397 - locationTyp: array (object | null)[] | null
_chain prvky řetězce polohy
doplňující parametry každého prvku řetězce polohy- cardTyp: string | null
_id identifikátor karty
- cidTyp: string | null
- featureTyp: string | null
_id - titleTyp: string | null
název prvku v řetězci lokalit
- longitudeTyp: number | null
zeměpisná délka hotelu
souřadnice zeměpisné délky polohy hotelu
příklad:-106.0512973 - mapsTyp: string | null
_url url polohy hotelu v mapách Google
- neighborhoodTyp: string | null
název čtvrti, kde se hotel nachází
- neighborhoodTyp: string | null
_description popis čtvrti, kde se hotel nachází
- overallTyp: number | null
_score celkové skóre polohy hotelu
určuje celkové skóre polohy hotelu v rozsahu od 1 do 5;
vypočítává se na základě dat o blízkosti hotelu k nedalekým atrakcím a restauracím, dopravě a letištím;
mějte na paměti, že kritéria nemají v celkovém skóre stejnou váhu - scoreTyp: object | null
_by _categories skóre kategorií polohy hotelu
skóre polohy hotelu spojená s kategoriemi, které označují blízkost nedalekých atrakcí, restaurací, dopravy a letišť;- propertyTyp: number | null Formát: double
Name
- locationTyp: integer | null
_code kód lokality v poli POST
- overviewTyp: array (string | null)[] | null
_images obrázky zobrazené v přehledu hotelu
pole obsahující URL obrázků zobrazených v přehledu hotelu - phoneTyp: string | null
telefonní číslo hotelu
kontaktní telefonní číslo hotelu - pricesTyp: object | null · Response36Afe1097B20_HotelPriceInfo
podrobnosti o cenách hotelu
obsahuje informace o cenách hotelu- checkTyp: string | null
_in datum a čas check-inu
ve formátu UTC: “yyyy-mm-dd hh-mm-ss +00:00”
příklad:2019-11-15 12:57:46 +00:00 - checkTyp: string | null
_out datum a čas check-outu
ve formátu UTC: “yyyy-mm-dd hh-mm-ss +00:00”
příklad:2019-11-15 12:57:46 +00:00 - currencyTyp: string | null
měna ceny
ve výchozím nastavení se použijeUSD, pokud není uvedena v poli POST - discountTyp: string | null
_text text o uplatněné slevě
- itemsTyp: array (object | null)[] | null
nalezené typy prvků
typy výsledků vyhledávání nalezené v poliitems;
možné typy prvků:hotel_search_item- currencyTyp: string | null
měna ceny
ve výchozím nastavení se použijeUSD, pokud není uvedena v poli POST - domainTyp: string | null
doména třetí strany doména stránky webu třetí strany s informacemi o cenách
- freeTyp: string | null
_cancellation _until datum, do kterého je k dispozici bezplatné zrušení ve formátu UTC: “yyyy-mm-dd hh-mm-ss +00:00” rovná se null, pokud bezplatné zrušení není pro vybrané termíny k dispozici
- isTyp: boolean | null
_paid udává placený firemní záznam hotelu
pokudtrue, souvisejícíhotel_search_itemje placená reklama
pokudfalse, souvisejícíhotel_search_itemje organický firemní záznam hotelu - offersTyp: array (object | null)[] | null
hlavní cenové nabídky
- currencyTyp: string | null
měna ceny
ve výchozím nastavení se použijeUSD, pokud není uvedena v poli POST - freeTyp: string | null
_cancellation _until datum, do kterého je k dispozici bezplatné zrušení ve formátu UTC: “yyyy-mm-dd hh-mm-ss +00:00” rovná se null, pokud bezplatné zrušení není pro vybrané termíny k dispozici
- maxTyp: integer | null
_visitors maximální počet hostů maximální počet hostů, pro který je cenová nabídka platná
- offerTyp: array (string | null)[] | null
_images obrázky cenové nabídky URL obrázků uvedených v cenové nabídce
- priceTyp: number | null
cena za noc
- titleTyp: string | null
název hotelu
- typeTyp: string | null
typ prvku
- urlTyp: string | null
url cenové nabídky URL stránky webu, kde se cenová nabídka zobrazuje
- officialTyp: boolean | null
_site - priceTyp: number | null
cena za noc
- titleTyp: string | null
název hotelu
- typeTyp: string | null
typ prvku
- urlTyp: string | null
url stránky třetí strany URL stránky webu třetí strany s informacemi o cenách
- priceTyp: number | null
cena za noc
- priceTyp: number | null Formát: int64
_without _discount plná cena za noc bez uplatněné slevy
- pricesTyp: array (object | null)[] | null
_by _dates - checkTyp: string | null
_in _date - checkTyp: string | null
_out _date - currencyTyp: string | null
měna ceny
ve výchozím nastavení se použijeUSD, pokud není uvedena v poli POST - priceTyp: number | null
cena za noc
- visitorsTyp: integer | null
počet hostů hotelu pro tuto cenu
- reviewsTyp: object | null · Response36Afe1097B20_HotelReviewInfo
recenze hotelu podle kritérií
informace o recenzích hotelu- mentionsTyp: array (object | null)[] | null
zmínky o hotelu
informace o recenzích hotelu podle kritérií- negativeTyp: integer | null Formát: int64
_count počet negativních recenzí podle kritéria
- positiveTyp: integer | null Formát: int64
_count počet pozitivních recenzí podle kritéria
- positiveTyp: number | null
_score pozitivní skóre podle kritéria
- titleTyp: string | null
název hodnoceného kritéria
- totalTyp: integer | null Formát: int64
_count počet všech recenzí podle kritéria
- visibleTyp: boolean | null
_by _default prvek je ve výchozím nastavení viditelný
udává, zda je prvek recenze ve výchozím nastavení viditelný
- otherTyp: array (object | null)[] | null
_sites _reviews recenze na webech třetích stran
recenze z webů třetích stran- ratingTyp: object | null · Response36Afe1097B20_RatingInfo
hodnocení v recenzi
informace o hodnocení uvedeném v recenzi na webu třetí strany- ratingTyp: integer | null
_max maximální hodnota pro rating_type
- ratingTyp: string | null
_type typ hodnocení zde najdete následující prvky: Max5, Percents, CustomMax
- valueTyp: number | null Formát: double
hodnota hodnocení
- votesTyp: integer | null Formát: int64
_count množství zpětné vazby
- reviewTyp: string | null
_text text recenze
text recenze - titleTyp: string | null
název recenze
obsahuje název webu třetí strany, kde se recenze původně objevila - urlTyp: string | null
URL recenze
URL webu třetí strany, kde se recenze původně objevila
- ratingTyp: object | null
_distribution rozložení hodnocení podle hlasů
rozložení hlasů napříč hodnocením v rozsahu od 1 do 5- propertyTyp: integer | null Formát: Int64
Name
- valueTyp: number | null
celkové hodnocení hotelu na základě hlasů zákazníků
- votesTyp: integer | null Formát: int64
_count počet hlasů zákazníků
počet hlasů zákazníků zahrnutých do výpočtu hodnocení hotelu
- starsTyp: integer | null
hodnocení třídy hotelu
hodnocení třídy v rozsahu 1–5 hvězdiček zobrazené v přehledu hotelu za hodnocením z recenzí - starsTyp: string | null
_description hodnocení třídy hotelu
hodnocení třídy v rozsahu 1–5 hvězdiček zobrazené v přehledu hotelu za hodnocením z recenzí - titleTyp: string | null
název hotelu
název hotelu, pro který se výsledky shromažďují
- resultTyp: integer | null Formát: int64
_count počet prvků v poli result
- statusTyp: integer | null
_code stavový kód úlohy vygenerovaný DataForSEO; může být v následujícím rozsahu: 10000-60000 úplný seznam kódů odpovědí najdete zde
- statusTyp: string | null
_message informační zpráva úlohy úplný seznam obecných informačních zpráv najdete zde
- timeTyp: string | null
doba provedení, sekundy
- Typ: integer | null Formát: int64tasks
_count počet úloh v poli tasks
- Typ: integer | null Formát: int64tasks
_error počet úloh v poli tasks vrácených s chybou
- Typ: string | nulltime
celková doba provádění, sekundy
- Typ: string | nullversion
aktuální verze API
application/json - 400
Požadavek se nepodařilo zpracovat. Zkontrolujte parametry požadavku.
- 401
Je vyžadován platný API klíč Felo.
- 402
V požadavku nelze pokračovat, protože není splněn požadavek na fakturaci.
- 403
Účet nemá oprávnění tuto operaci provést.
- 429
Byl dosažen limit požadavků nebo útraty.
- 502
Služba nemohla požadavek dokončit.
- 503
API nebo fakturační služba je dočasně nedostupná.
- 504
Při zpracování požadavku vypršel časový limit služby.
- default
Chybová odpověď; odpovědi předávané přímo od upstream poskytovatele mohou používat formáty poskytovatele
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]"
]
}
}
]
}
]
}