Získání výsledků vyhledávání Google Hotels podle id
DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Získání výsledků vyhledávání Google Hotels podle id
Načte z fronty vyhledávání Google Hotels podle id. 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_BusinessDataGoogleHotelSearchesTaskGetResponseInfo200
- 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_BusinessDataGoogleHotelSearchesTaskGetTaskInfo
- 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
- 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 obdržené v poli POST
klíčové slovo se vrací s dekódovaným %## (znak plus '+' bude dekódován jako mezera);
pro přesné výsledky vyhledávání se ke klíčovému slovu automaticky připojuje název lokality - 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/task_get/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": [
{
"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]"
}
]
}
]
}
]
}