DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Live: ricerca hotel Google
Cerca su Google Hotels strutture corrispondenti a una query, con date e occupazione. Incapsulato nella struttura DataForSEO: dati in tasks[0].result, esito in tasks[0].status_code; una richiesta rifiutata restituisce comunque HTTP 200. È così che si trova l'hotel di cui gli endpoint info richiedono l'id; post_dataforseo_business_google_hotel_info_live è la vista di dettaglio.
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, verrà applicato il valore predefinito2;
nota che è possibile specificare fino a 6 persone, includendo sia adulti che bambini
esempio:1 - amenitiesTipo: array string[] | null
servizi dell'hotel
campo facoltativo
è possibile usare questo campo per specificare diversi servizi dell'hotel
esempio:[
"free_parking",
"pets_allowed"
]
valori possibili:"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" - 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;
formato data:"yyyy-mm-dd"
esempio:"2019-01-15"
Nota: il valore non può essere precedente alla data odierna - 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;
formato data:"yyyy-mm-dd"
esempio:"2019-01-15"
Nota: il valore non può essere inferiore o uguale acheck_in;
l'intervallo tra i valoricheck_inecheck_outnon può superare i 30 giorni - childrenTipo: array string[] | null
numero e età dei bambini
campo facoltativo
se non si specifica questo campo, nessun bambino verrà incluso nella ricerca;
l'età del bambino può essere compresa tra0e17;
nota che è possibile specificare fino a 6 persone, includendo sia adulti che bambini
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" - depthTipo: integer | null
profondità di parsing
campo facoltativo
numero di risultati in Google Hotels
valore predefinito:18risultati organici
valore massimo:140
Nota: il conto viene fatturato per ogni 18 risultati organici indipendentemente dagli annunci a pagamento nella risposta;
pertanto, impostare una profondità superiore a18può comportare costi aggiuntivi se Google Hotels restituisce più di 18 risultati;
se la profondità specificata è superiore al numero di risultati nella risposta, la differenza verrà automaticamente rimborsata sul saldo del conto - freeTipo: boolean | null
_cancellation hotel con cancellazione gratuita
campo facoltativo
impostare questo campo sutruese si desidera ottenere l'elenco degli hotel con cancellazione gratuita delle prenotazioni
valore predefinito:false - isTipo: boolean | null
_vacation _rentals ricerca di case vacanza
campo facoltativo
impostare questo campo sutruese si desidera ottenere l'elenco delle case vacanza invece degli hotel
valore predefinito:false - keywordTipo: string | null
keyword
campo facoltativo
la keyword specificata viene usata per cercare l'elenco degli hotel;
se non si usa questo campo, verrà restituito l'elenco degli hotel trovati in una località specificata;
è possibile specificare fino a 700 caratteri nel campokeyword
tutti i %## verranno decodificati (inoltre il carattere ‘+’ verrà decodificato in uno spazio)
se è necessario usare il carattere “%” nellakeyword, specificarlo come “%25”;
Nota: per ottenere risultati di ricerca accurati, il nome della località viene aggiunto automaticamente alla keywordscopri di più sulle regole e sui limiti dei campi
keywordekeywordsnelle API DataForSEO in questo articolo del Help Center - 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 - 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
Nota: per ottenere risultati di ricerca accurati, illocation_namespecificato verrà automaticamente aggiunto alla keyword - maxTipo: integer | null
_price prezzo massimo per notte
campo facoltativo
la valuta di questo valore dipende dal campocurrency
esempio:600 - minTipo: integer | null
_price prezzo minimo per notte
campo facoltativo
la valuta di questo valore dipende dal campocurrency
esempio:100 - minTipo: number | null
_rating valutazione minima
campo facoltativo
è possibile usare questo campo per specificare una valutazione degli ospiti superiore a un determinato valore
esempio:2.5 - searchTipo: boolean | null
_this _area mostra gli hotel dall'area visualizzata
campo facoltativo
può assumere i valori:true,false
valore predefinito:true
se impostato sufalse, la modalitàsearch_this_areaverrà disattivata
Nota: se la modalitàsearch_this_areaè disattivata,location_namenon verrà aggiunto allakeyworddurante la ricerca
per saperne di più su questo parametro, consulta il nostro Help Center - sortTipo: string | null
_by parametri di ordinamento dei risultati
campo facoltativo
è possibile usare questo campo per ordinare i risultati
tipi di ordinamento possibili:relevance– ordina per i più pertinentilowest_price– ordina per il prezzo più bassohighest_rating– ordina per la valutazione più altamost_reviewed– ordina per il maggior numero di recensioni
valore predefinito:relevance - starsTipo: array string[] | null
stelle dell'hotel
campo facoltativo
impostare questo campo su[5]se si desidera ottenere solo l'elenco degli hotel a 5 stelle
esempio:[3,4,5] - 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_BusinessDataGoogleHotelSearchesLiveResponseInfo200
- 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_BusinessDataGoogleHotelSearchesLiveTaskInfo
- 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
- 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 - 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- hotelTipo: string | null
_identifier identificatore univoco di un'entità hotel in Google Search
esempio:CgoI-KWyzenM_MV3EAE - 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 - locationTipo: object | null · Response36Afe1097B20_GpsCoordinatesLocationInfo
coordinate GPS della posizione dell'hotel
- latitudeTipo: number | null
coordinata di latitudine dell'hotel in Google Maps
esempio:"latitude": 51.584091 - longitudeTipo: number | null
coordinata di longitudine dell'hotel in Google Maps
esempio:"longitude": -0.31365919999999997
- overviewTipo: array (string | null)[] | null
_images immagini in evidenza per un hotel
- pricesTipo: object | null · Response36Afe1097B20_HotelPriceInfo
prezzo 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 e informazioni sulla valutazione dell'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 - titleTipo: string | null
titolo dell'hotel
- typeTipo: string | null
tipo di elemento
- itemsTipo: integer | null Formato: int64
_count tipi di elemento
il numero di elementi nell'arrayitems - keywordTipo: string | null
keyword ricevuta in un array POST
la keyword viene restituita decodificata (%##; il carattere '+' viene decodificato in uno spazio) - languageTipo: string | null
_code codice lingua in un array POST
- locationTipo: integer | null
_code codice posizione in un array POST
- 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_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]"
}
]
}
]
}
]
}