DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Vytváření úloh Google Hotel Info
Zařadí do fronty vyhledání hotelového záznamu a vrátí id úlohy. 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. Zpracovaný výsledek načtěte pomocí get_dataforseo_business_google_hotel_info_fetch, surový pomocí get_dataforseo_business_google_hotel_info_fetch_html.
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, pokud nezadátekeyword
pokud toto pole použijete, nemusíte zadávatkeyword
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 prvkuhotels_packodpovědi) nebo na endpoint Hotel Searches rozhraní Business Data API
příklad:ChYIq6SB--i6p6cpGgovbS8wN2s5ODZfEAE - keywordTyp: string
klíčové slovo
povinné pole, pokud nezadátehotel_identifier
pokud toto pole použijete, nemusíte zadávathotel_identifier
zadané klíčové slovo by mělo označovat název hotelového subjektu
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“ - 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 - pingbackTyp: string | null
_url URL adresa oznámení o dokončení úlohy
volitelné pole
po dokončení úlohy vás budeme informovat požadavkem GET odeslaným na zadanou URL adresu;
můžete použít řetězec „$id“ jako proměnnou$ida řetězec „$tag“ jako proměnnou$tagkódovanou v URL;
před odesláním požadavku nastavíme potřebné hodnoty;
příklad:http://your-server.com/pingscript?id=$idhttp://your-server.com/pingscript?id=$id&tag=$tag
Poznámka: speciální znaky vpingback_urlbudou zakódovány v URL;
mj. znak#bude zakódován jako%23 - postbackTyp: string
_data datový typ postback_url
povinné pole, pokud zadátepostback_url
odpovídá datovému typu, který bude odeslán na váš server
možné hodnoty:advanced,html - postbackTyp: string | null
_url URL adresa pro odesílání výsledků úlohy
volitelné pole
po dokončení úlohy odešleme požadavek POST s výsledky komprimovanými ve formátugzipna zadanou adresupostback_url;
můžete použít řetězec „$id“ jako proměnnou$ida řetězec „$tag“ jako proměnnou$tagkódovanou v URL. Před odesláním požadavku nastavíme potřebné hodnoty;
příklad:http://your-server.com/postbackscript?id=$idhttp://your-server.com/postbackscript?id=$id&tag=$tag
Poznámka: speciální znaky vpostback_urlbudou zakódovány v URL;
mj. znak#bude zakódován jako%23 - 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 - priorityTyp: integer | null
- 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_BusinessDataGoogleHotelInfoTaskPostResponseInfo200
- 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_BusinessDataGoogleHotelInfoTaskPostTaskInfo
- 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: object | null
pole výsledků
v tomto případě bude hodnotanull - 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/task_post \
--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": "ChYIq6SB--i6p6cpGgovbS8wN2s5ODZfEAE",
"tag": "some_string_123",
"postback_url": "https://your-server.com/postbackscript.php",
"postback_data": "advanced"
}
]'
{
"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": null
}
]
}