DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Live: info hotel Google avanzate
La scheda Google di un hotel: camere, servizi, prezzi e le opzioni di prenotazione mostrate da Google. Incapsulato nella struttura DataForSEO: dati in tasks[0].result, esito in tasks[0].status_code; una richiesta rifiutata restituisce comunque HTTP 200. La forma grezza è post_dataforseo_business_google_hotel_info_live_html, quella accodata post_dataforseo_business_google_hotel_info_submit. Per trovare prima l'hotel usare post_dataforseo_business_google_hotel_searches_live.
Riferimento prezzi
- Misurazione: costo della risposta riportato.
- Stima di riferimento per richiesta: USD 0.2428.
- Moltiplicatore cliente di riferimento: 1.0. Non applicarlo di nuovo a un importo cliente già addebitato.
Solo metadati di riferimento, non un preventivo dell'account né un prezzo o un limite di spesa garantito. I crediti delle risorse non sono crediti Felo. Gli addebiti finali seguono le registrazioni di fatturazione Felo.
- Tipo: array (object | null)[]
- adultsTipo: integer | null
numero di adulti
campo facoltativo
se non si specifica questo campo, per impostazione predefinita vengono usati due adulti
esempio:1 - checkTipo: string | null
_in data di check-in
campo facoltativo
se non si specifica questo campo, per impostazione predefinita viene usata la data di domani;
il valore non deve essere precedente alla data odierna
formato data:"yyyy-mm-dd"
esempio:"2019-01-15" - checkTipo: string | null
_out data di check-out
campo facoltativo
se non si specifica questo campo, il nostro sistema applica per impostazione predefinita la data di due giorni da oggi;
Nota: il valore non può essere inferiore o uguale acheck_in;
l'intervallo tra i valoricheck_inecheck_outnon può superare i 30 giorni
formato data:"yyyy-mm-dd"
esempio:"2019-01-15" - childrenTipo: array string[] | null
numero e età dei bambini
campo facoltativo
se non si specifica questo campo, nessun bambino verrà incluso nella ricerca;impostare il seguente valore per includere un bambino di 14 anni:
[14]
impostare il seguente valore per includere un bambino di 13 anni e uno di 8 anni:[13,8] - currencyTipo: string | null
valuta
campo facoltativo
esempio:"USD" - hotelTipo: string
_identifier identificatore univoco dell'hotel
campo obbligatorio
identificatore univoco di un'entità alberghiera nella ricerca Google;
è possibile ottenere il valore effettuando una richiesta all'Advanced Google SERP API (contenuto nell'elementohotelsdella risposta) o all'endpoint Hotel Searches di Business Data API
esempio:ChYIq6SB--i6p6cpGgovbS8wN2s5ODZfEAE - languageTipo: string
_code codice lingua del motore di ricerca
campo obbligatorio se non si specificalanguage_name
se si usa questo campo, non è necessario specificarelanguage_name
è possibile ottenere l'elenco delle lingue disponibili del motore di ricerca con il relativolanguage_codeeffettuando una richiesta separata ahttps://api.dataforseo.com/v3/business_data/google/languages
esempio:en - languageTipo: string
_name nome completo della lingua del motore di ricerca
campo obbligatorio se non si specificalanguage_code
se si usa questo campo, non è necessario specificarelanguage_code
è possibile ottenere l'elenco delle lingue disponibili del motore di ricerca con il relativolanguage_nameeffettuando una richiesta separata ahttps://api.dataforseo.com/v3/business_data/google/languages
esempio:English - loadTipo: boolean | null
_prices _by _dates carica i prezzi del soggiorno in hotel per date
campo facoltativo
se si specifica questo parametro contrue, la risposta includerà l'arrayprices_by_datescon i prezzi del soggiorno in hotel suddivisi per data
se si usa questo parametro, verrà addebitato il doppio del prezzo base per richiesta - locationTipo: integer
_code codice località del motore di ricerca
campo obbligatorio se non si specificalocation_nameolocation_coordinate
se si usa questo campo, non è necessario specificarelocation_nameolocation_coordinate
è possibile ottenere l'elenco delle località disponibili conlocation_codeeffettuando una richiesta separata ahttps://api.dataforseo.com/v3/business_data/google/locations
esempio:2840 - locationTipo: string
_coordinate coordinate GPS di una località
campo obbligatorio se non si specificalocation_nameolocation_code
se si usa questo campo, non è necessario specificarelocation_nameolocation_code
il parametrolocation_coordinatedeve essere specificato nel formato "latitude, longitude"
numero massimo di cifre decimali per "latitude" e "longitude": 7
Nota: se le coordinate vengono usate per impostare una località, la ricerca avverrà nel centro abitato più vicino;
esempio:53.476225,-2.243572 - locationTipo: string
_name nome completo della località del motore di ricerca
campo obbligatorio se non si specificalocation_codeolocation_coordinate
se si usa questo campo, non è necessario specificarelocation_codeolocation_coordinate
è possibile ottenere l'elenco delle località disponibili del motore di ricerca con il relativolocation_nameeffettuando una richiesta separata ahttps://api.dataforseo.com/v3/business_data/google/locations
esempio:London,England,United Kingdom - pricesTipo: string | null
_date _range periodo predefinito per il recupero dei dati giornalieri sui prezzi
campo facoltativo
per usare questo parametro, è necessario specificareload_prices_by_datescontrue
seprices_start_datenon è specificato, la data di inizio viene impostata sulla datacheck_in
valori possibili:month,three_months,six_months,year
valore predefinito:month - pricesTipo: string | null
_end _date data di fine per caricare i prezzi per date
campo facoltativo
per usare questo parametro, è necessario specificareload_prices_by_datescontrue
se questo parametro non è specificato, si ottengono i prezzi per data relativi al mese
formato data:yyyy-mm-dd
esempio:2025-05-21 - pricesTipo: string | null
_start _date data di inizio per caricare i prezzi per date
campo facoltativo
per usare questo parametro, è necessario specificareload_prices_by_datescontrue
se questo parametro non è specificato, la data di inizio viene impostata sulla datacheck_in
formato data:yyyy-mm-dd
esempio:2025-05-20 - tagTipo: string | null
identificatore dell'attività definito dall'utente
campo facoltativo
il limite di caratteri è 255
puoi usare questo parametro per identificare l'attività e associarla al risultato
il valoretagspecificato si trova nell'oggettodatadella risposta
- Tipo: object | null · Response36Afe1097B20_BusinessDataGoogleHotelInfoLiveAdvancedResponseInfo200
- Tipo: number | null Formato: doublecost
Costo totale delle attività, USD
- Tipo: integer | nullstatus
_code codice di stato generale l'elenco completo dei codici di risposta è disponibile qui
- Tipo: string | nullstatus
_message messaggio informativo generale l'elenco completo dei messaggi informativi generali è disponibile qui
- Tipo: array (object | null)[] | nulltasks
array di attività
- Tipo: object | null · Response36Afe1097B20_BusinessDataGoogleHotelInfoLiveAdvancedTaskInfo
- costTipo: number | null Formato: double
Costo totale delle attività, USD
- dataTipo: object | null
Contiene gli stessi parametri specificati nella richiesta POST
- propertyTipo: object | null
Name
- idTipo: string | null
identificatore dell'attività identificatore univoco dell'attività nel nostro sistema in formato UUID
- pathTipo: array (string | null)[] | null
Percorso URL
- resultTipo: array (object | null)[] | null
array di risultati
- aboutTipo: object | null · Response36Afe1097B20_HotelAboutInfo
informazioni sull'hotel
- amenitiesTipo: array (object | null)[] | null
servizi dell'hotel
informazioni sui servizi dell'hotel- categoryTipo: string | null
categoria standardizzata del servizio
- categoryTipo: string | null
_label etichetta della categoria
- itemsTipo: array (object | null)[] | null
servizi e dettagli specifici
- amenityTipo: string | null
nome standardizzato del servizio
- amenityTipo: string | null
_label nome visualizzato del servizio
- hintTipo: string | null
dettagli standardizzati sul servizio
- hintTipo: string | null
_label dettagli visualizzati sul servizio
- isTipo: boolean | null
_available indica se il
amenityè disponibile nell'hotel
- checkTipo: object | null · Response36Afe1097B20_TimeInfo
_in _time orario di check-in dell'hotel
orario di check-in indicato nella scheda dell'hotel- hourTipo: integer | null
ore nel formato a 24 ore
- minuteTipo: integer | null
minuti
- checkTipo: object | null · Response36Afe1097B20_TimeInfo
_out _time orario di check-out dell'hotel
orario di check-out indicato nella scheda dell'hotel- hourTipo: integer | null
ore nel formato a 24 ore
- minuteTipo: integer | null
minuti
- descriptionTipo: string | null
descrizione dell'hotel
la descrizione dell'hotel per cui vengono raccolti i risultati - domainTipo: string | null
dominio dell'hotel
dominio del sito web dell'hotel - fullTipo: string | null
_address indirizzo completo dell'hotel
indirizzo dell'hotel indicato in formato standardizzato - popularTipo: array (object | null)[] | null
_amenities servizi dell'hotel
informazioni sui servizi dell'hotel etichettati come "popolari"- amenityTipo: string | null
nome standardizzato del servizio
- amenityTipo: string | null
_label nome visualizzato del servizio
- hintTipo: string | null
dettagli standardizzati sul servizio
- hintTipo: string | null
_label dettagli visualizzati sul servizio
- isTipo: boolean | null
_available indica se il
amenityè disponibile nell'hotel
- subTipo: array (string | null)[] | null
_descriptions descrizione aggiuntiva dell'hotel
dettagli sull'hotel forniti in aggiunta alla descrizione - urlTipo: string | null
URL dell'hotel
URL del sito web dell'hotel indicato nella scheda
- addressTipo: string | null
indirizzo dell'hotel
indirizzo fisico dell'hotel - checkTipo: string | null
_url URL diretto ai risultati del motore di ricerca
puoi usarlo per verificare che abbiamo fornito risultati accurati - datetimeTipo: string | null
data e ora di ricezione del risultato
nel formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”
esempio:2019-11-15 12:57:46 +00:00 - hotelTipo: string | null
_identifier identificatore ricevuto in un array POST
questo campo contiene il parametrohotel_identifierspecificato durante l'impostazione dell'attività;
esempio:CgoI-KWyzenM_MV3EAE - languageTipo: string | null
_code codice lingua in un array POST
- locationTipo: object | null · Response36Afe1097B20_HotelLocationInfo
informazioni sulla posizione dell'hotel
informazioni sulla posizione in cui si trova l'hotel- latitudeTipo: number | null
latitudine dell'hotel
coordinate di latitudine della posizione dell'hotel
esempio:39.4806397 - locationTipo: array (object | null)[] | null
_chain elementi della catena di posizione
parametri aggiuntivi di ciascun elemento della catena di posizione- cardTipo: string | null
_id identificativo della scheda
- cidTipo: string | null
- featureTipo: string | null
_id - titleTipo: string | null
titolo dell'elemento nella catena di località
- longitudeTipo: number | null
longitudine dell'hotel
coordinate di latitudine della posizione dell'hotel
esempio:-106.0512973 - mapsTipo: string | null
_url URL della posizione dell'hotel in Google Maps
- neighborhoodTipo: string | null
nome del quartiere in cui si trova l'hotel
- neighborhoodTipo: string | null
_description descrizione del quartiere in cui si trova l'hotel
- overallTipo: number | null
_score punteggio complessivo della posizione dell'hotel
indica il punteggio complessivo della posizione dell'hotel nell'intervallo da 1 a 5;
calcolato in base ai dati sulla vicinanza dell'hotel ad attrazioni e ristoranti, trasporti e aeroporti;
tieni presente che i criteri non hanno lo stesso peso nel punteggio complessivo - scoreTipo: object | null
_by _categories punteggi per categoria della posizione dell'hotel
i punteggi della posizione dell'hotel legati alle categorie che indicano la vicinanza ad attrazioni, ristoranti, trasporti e aeroporti;- propertyTipo: number | null Formato: double
Name
- locationTipo: integer | null
_code codice posizione in un array POST
- overviewTipo: array (string | null)[] | null
_images immagini visualizzate nella panoramica dell'hotel
array contenente gli URL delle immagini visualizzate nella panoramica dell'hotel - phoneTipo: string | null
numero di telefono dell'hotel
numero di telefono di contatto dell'hotel - pricesTipo: object | null · Response36Afe1097B20_HotelPriceInfo
dettagli sui prezzi dell'entità hotel
contiene informazioni sui prezzi dell'hotel- checkTipo: string | null
_in data e ora di check-in
nel formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”
esempio:2019-11-15 12:57:46 +00:00 - checkTipo: string | null
_out data e ora di check-out
nel formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”
esempio:2019-11-15 12:57:46 +00:00 - currencyTipo: string | null
valuta del prezzo
USDviene applicato per impostazione predefinita, se non specificato nell'array POST - discountTipo: string | null
_text testo su uno sconto applicato
- itemsTipo: array (object | null)[] | null
tipi di elementi incontrati
tipi di risultati dei motori di ricerca incontrati nell'arrayitems;
tipi di elementi possibili:hotel_search_item- currencyTipo: string | null
valuta del prezzo
USDviene applicato per impostazione predefinita, se non specificato nell'array POST - domainTipo: string | null
dominio di terze parti dominio della pagina del sito web di terze parti con informazioni sui prezzi
- freeTipo: string | null
_cancellation _until data fino alla quale è disponibile la cancellazione gratuita nel formato UTC: “yyyy-mm-dd hh-mm-ss +00:00” è uguale a null se la cancellazione gratuita non è disponibile per le date selezionate
- isTipo: boolean | null
_paid indica una scheda hotel a pagamento
setrue, il relativohotel_search_itemè un annuncio a pagamento
sefalse, il relativohotel_search_itemè una scheda hotel organica - offersTipo: array (object | null)[] | null
offerte di prezzo in evidenza
- currencyTipo: string | null
valuta del prezzo
USDviene applicato per impostazione predefinita, se non specificato nell'array POST - freeTipo: string | null
_cancellation _until data fino alla quale è disponibile la cancellazione gratuita nel formato UTC: “yyyy-mm-dd hh-mm-ss +00:00” è uguale a null se la cancellazione gratuita non è disponibile per le date selezionate
- maxTipo: integer | null
_visitors il numero massimo di visitatori il numero massimo di visitatori per cui è valida l'offerta di prezzo
- offerTipo: array (string | null)[] | null
_images immagini dell'offerta di prezzo URL delle immagini presenti nell'offerta di prezzo
- priceTipo: number | null
prezzo per notte
- titleTipo: string | null
titolo dell'hotel
- typeTipo: string | null
tipo di elemento
- urlTipo: string | null
URL dell'offerta di prezzo URL della pagina del sito web in cui appare l'offerta di prezzo
- officialTipo: boolean | null
_site - priceTipo: number | null
prezzo per notte
- titleTipo: string | null
titolo dell'hotel
- typeTipo: string | null
tipo di elemento
- urlTipo: string | null
URL della pagina di terze parti URL della pagina del sito web di terze parti con informazioni sui prezzi
- priceTipo: number | null
prezzo per notte
- priceTipo: number | null Formato: int64
_without _discount prezzo pieno per notte senza sconto applicato
- pricesTipo: array (object | null)[] | null
_by _dates - checkTipo: string | null
_in _date - checkTipo: string | null
_out _date - currencyTipo: string | null
valuta del prezzo
USDviene applicato per impostazione predefinita, se non specificato nell'array POST - priceTipo: number | null
prezzo per notte
- visitorsTipo: integer | null
numero di visitatori dell'hotel per questo prezzo
- reviewsTipo: object | null · Response36Afe1097B20_HotelReviewInfo
recensioni dell'hotel per criterio
informazioni sulle recensioni dell'entità hotel- mentionsTipo: array (object | null)[] | null
menzioni dell'hotel
informazioni sulle recensioni dell'hotel per criterio- negativeTipo: integer | null Formato: int64
_count numero di recensioni negative per criterio
- positiveTipo: integer | null Formato: int64
_count numero di recensioni positive per criterio
- positiveTipo: number | null
_score punteggio positivo per criterio
- titleTipo: string | null
titolo del criterio valutato
- totalTipo: integer | null Formato: int64
_count numero di tutte le recensioni per criterio
- visibleTipo: boolean | null
_by _default elemento visibile per impostazione predefinita
indica se l'elemento recensione è visibile per impostazione predefinita
- otherTipo: array (object | null)[] | null
_sites _reviews recensioni su siti di terze parti
recensioni da siti di terze parti- ratingTipo: object | null · Response36Afe1097B20_RatingInfo
valutazione nella recensione
informazioni sulla valutazione contenuta nella recensione su un sito di terze parti- ratingTipo: integer | null
_max il valore massimo per un rating_type
- ratingTipo: string | null
_type il tipo di valutazione qui puoi trovare i seguenti elementi: Max5, Percents, CustomMax
- valueTipo: number | null Formato: double
il valore della valutazione
- votesTipo: integer | null Formato: int64
_count la quantità di feedback
- reviewTipo: string | null
_text testo della recensione
testo della recensione - titleTipo: string | null
titolo della recensione
contiene il nome del sito di terze parti in cui la recensione è apparsa inizialmente - urlTipo: string | null
URL della recensione
URL del sito di terze parti in cui la recensione è apparsa inizialmente
- ratingTipo: object | null
_distribution distribuzione delle valutazioni per voto
la distribuzione dei voti sulla valutazione nell'intervallo da 1 a 5- propertyTipo: integer | null Formato: Int64
Name
- valueTipo: number | null
valutazione complessiva dell'hotel basata sui voti dei clienti
- votesTipo: integer | null Formato: int64
_count numero di voti dei clienti
il numero di voti dei clienti inclusi nel calcolo della valutazione dell'hotel
- starsTipo: integer | null
classificazione a stelle dell'hotel
classificazione da 1 a 5 stelle, visualizzata dopo le valutazioni nella sintesi dell'hotel - starsTipo: string | null
_description classificazione a stelle dell'hotel
classificazione da 1 a 5 stelle, visualizzata dopo le valutazioni nella sintesi dell'hotel - titleTipo: string | null
nome dell'hotel
il titolo dell'entità hotel per cui vengono raccolti i risultati
- resultTipo: integer | null Formato: int64
_count Numero di elementi nell'array dei risultati
- statusTipo: integer | null
_code codice di stato dell'attività generato da DataForSEO, può essere compreso nell'intervallo: 10000-60000 l'elenco completo dei codici di risposta è disponibile qui
- statusTipo: string | null
_message messaggio informativo dell'attività l'elenco completo dei messaggi informativi generali è disponibile qui
- timeTipo: string | null
Tempo di esecuzione in secondi
- Tipo: integer | null Formato: int64tasks
_count Il numero di attività nell'array tasks
- Tipo: integer | null Formato: int64tasks
_error Il numero di attività nell'array tasks restituite con un errore
- Tipo: string | nulltime
tempo di esecuzione totale, secondi
- Tipo: string | nullversion
La versione corrente dell'API
application/json - 400
Impossibile elaborare la richiesta. Controlla i parametri della richiesta.
- 401
È richiesta una chiave API Felo valida.
- 402
Impossibile procedere con la richiesta perché non è soddisfatto un requisito di fatturazione.
- 403
L'account non è autorizzato a eseguire questa operazione.
- 429
È stato raggiunto un limite di richieste o di spesa.
- 502
Il servizio non è riuscito a completare la richiesta.
- 503
L'API o il servizio di fatturazione è temporaneamente non disponibile.
- 504
Si è verificato un timeout durante l'elaborazione della richiesta.
- default
Risposta di errore; le risposte passthrough upstream possono usare formati del provider
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]"
]
}
}
]
}
]
}