Získání výsledků rozšířeného Google Hotel Info podle id
DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Získání výsledků rozšířeného Google Hotel Info podle id
Načte z fronty hotelový záznam podle id, zpracovaný. 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. 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. ⚠️ Velikost odpovědi byla určena parametrem depth nebo limitem nastaveným při odeslání a zde ji nelze zúžit; pokud je příliš velká, odešlete menší úlohu místo stránkování.
Referenční ceny
- Účtování: vykázaná cena odpovědi.
- Referenční odhad ceny požadavku: USD 0.012.
- 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: object | null · Response36Afe1097B20_BusinessDataGoogleHotelInfoTaskGetAdvancedResponseInfo200
- 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_BusinessDataGoogleHotelInfoTaskGetAdvancedTaskInfo
- 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 jedinečný identifikátor hotelu
toto pole bude obsahovat parametrhotel_identifier;
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/task_get/advanced/00000000-0000-0000-0000-000000000000 \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
"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]"
]
}
}
]
}
]
}