DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Úlohy vyhledávání Google Hotels naživo
Prohledává Google Hotels a hledá ubytování odpovídající dotazu, s daty a obsazeností. 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. Takto najdete hotel, jehož id potřebují informační endpointy; post_dataforseo_business_google_hotel_info_live je detailní zobrazení.
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žije se výchozí hodnota2;
poznámka: můžete zadat až 6 osob včetně dospělých a dětí
příklad:1 - amenitiesTyp: array string[] | null
vybavení hotelu
volitelné pole
pomocí tohoto pole můžete určit různé vybavení hotelu
příklad:[
"free_parking",
"pets_allowed"
]
možné hodnoty:"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 datum příjezdu
volitelné pole
pokud toto pole nezadáte, použije se ve výchozím nastavení zítřejší datum;
formát data:"yyyy-mm-dd"
příklad:"2019-01-15"
Poznámka: hodnota nesmí předcházet dnešnímu datu - 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;
formát data:"yyyy-mm-dd"
příklad:"2019-01-15"
Poznámka: hodnota nesmí být menší nebo rovna hodnotěcheck_in;
rozsah mezi hodnotamicheck_inacheck_outnesmí přesáhnout 30 dní - 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;
věk dítěte může být od0do17;
poznámka: můžete zadat až 6 osob včetně dospělých a dětí
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" - depthTyp: integer | null
hloubka parsování
volitelné pole
počet výsledků v Google Hotels
výchozí hodnota:18organických výsledků
maximální hodnota:140
Poznámka: váš účet bude účtován za každých 18 organických výsledků bez ohledu na placené nabídky v odpovědi;
nastavení hloubky nad18proto může vést k dodatečným poplatkům, pokud Google Hotels vrátí více než 18 výsledků;
pokud je zadaná hloubka vyšší než počet výsledků v odpovědi, rozdíl vám bude automaticky vrácen na zůstatek účtu - freeTyp: boolean | null
_cancellation hotely s bezplatným zrušením
volitelné pole
nastavte toto pole natrue, chcete-li získat seznam hotelů s bezplatným zrušením rezervace
výchozí hodnota:false - isTyp: boolean | null
_vacation _rentals vyhledávání rekreačních pronájmů
volitelné pole
nastavte toto pole natrue, chcete-li místo hotelů získat seznam rekreačních pronájmů
výchozí hodnota:false - keywordTyp: string | null
klíčové slovo
volitelné pole
zadané klíčové slovo se používá k vyhledání seznamu hotelů;
pokud toto pole nepoužijete, vrátíme seznam hotelů nalezených v zadané lokalitě;
do polekeywordmůžete zadat až 700 znaků
všechny řetězce %## budou dekódovány (znak „+“ bude dekódován jako mezera)
pokud potřebujete vkeywordpoužít znak „%“, zadejte jej jako „%25“;
Poznámka: pro získání přesných výsledků vyhledávání se název lokality automaticky připojuje ke klíčovému slovuvíce o pravidlech a omezeních polí
keywordakeywordsv rozhraních DataForSEO najdete v tomto článku nápovědy - 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 - 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
Poznámka: pro získání přesných výsledků vyhledávání bude zadanélocation_nameautomaticky připojeno ke klíčovému slovu - maxTyp: integer | null
_price maximální cena za noc
volitelné pole
měna této hodnoty závisí na policurrency
příklad:600 - minTyp: integer | null
_price minimální cena za noc
volitelné pole
měna této hodnoty závisí na policurrency
příklad:100 - minTyp: number | null
_rating minimální hodnocení
volitelné pole
pomocí tohoto pole můžete zadat hodnocení hostů vyšší než určitá hodnota
příklad:2.5 - searchTyp: boolean | null
_this _area zobrazit hotely ze zobrazené oblasti
volitelné pole
může nabývat hodnot:true,false
výchozí hodnota:true
při nastavení nafalsebude režimsearch_this_areavypnut
Poznámka: pokud je režimsearch_this_areavypnut,location_namenebude během vyhledávání připojeno kekeyword
více o tomto parametru v našem Centru nápovědy - sortTyp: string | null
_by parametry řazení výsledků
volitelné pole
pomocí tohoto pole můžete výsledky řadit
možné typy řazení:relevance– řadit podle nejvyšší relevancelowest_price– řadit podle nejnižší cenyhighest_rating– řadit podle nejvyššího hodnocenímost_reviewed– řadit podle největšího počtu recenzí
výchozí hodnota:relevance - starsTyp: array string[] | null
hvězdičky hotelu
volitelné pole
nastavte toto pole na[5], chcete-li získat pouze seznam 5hvězdičkových hotelů
příklad:[3,4,5] - 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_BusinessDataGoogleHotelSearchesLiveResponseInfo200
- 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_BusinessDataGoogleHotelSearchesLiveTaskInfo
- 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ů
- 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 - itemsTyp: array (object | null)[] | null
nalezené typy prvků
typy výsledků vyhledávání nalezené v poliitems;
možné typy prvků:hotel_search_item- hotelTyp: string | null
_identifier jedinečný identifikátor hotelu ve vyhledávání Google
příklad:CgoI-KWyzenM_MV3EAE - 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 - locationTyp: object | null · Response36Afe1097B20_GpsCoordinatesLocationInfo
GPS souřadnice polohy hotelu
- latitudeTyp: number | null
zeměpisná šířka hotelu v mapách Google
příklad:"latitude": 51.584091 - longitudeTyp: number | null
zeměpisná délka hotelu v mapách Google
příklad:"longitude": -0.31365919999999997
- overviewTyp: array (string | null)[] | null
_images zvýrazněné obrázky hotelu
- pricesTyp: object | null · Response36Afe1097B20_HotelPriceInfo
cena 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 a informace o hodnocení 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 - titleTyp: string | null
název hotelu
- typeTyp: string | null
typ prvku
- itemsTyp: integer | null Formát: int64
_count typy prvků
počet prvků v poliitems - keywordTyp: string | null
klíčové slovo přijaté v poli POST
klíčové slovo se vrací s dekódovaným %## (znak plus '+' bude dekódován jako mezera) - languageTyp: string | null
_code kód jazyka v poli POST
- locationTyp: integer | null
_code kód lokality v poli POST
- 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_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]"
}
]
}
]
}
]
}