Google Hotel Info Advanced en temps réel
DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Google Hotel Info Advanced en temps réel
La fiche Google d'un hôtel : chambres, équipements, prix et les options de réservation affichées par Google. Enveloppé dans l'enveloppe DataForSEO : données dans tasks[0].result, résultat dans tasks[0].status_code — une requête rejetée renvoie tout de même HTTP 200. La forme brute est post_dataforseo_business_google_hotel_info_live_html, et la forme en file d'attente post_dataforseo_business_google_hotel_info_submit. Pour trouver d'abord l'hôtel, utilisez post_dataforseo_business_google_hotel_searches_live.
Référence tarifaire
- Facturation : coût de réponse déclaré.
- Estimation de référence par requête : USD 0.2428.
- Multiplicateur de référence client : 1.0. Ne pas l'appliquer une seconde fois à un montant client déjà réglé.
Métadonnées de référence uniquement, et non un devis de compte, un prix garanti ou un plafond de dépenses. Les crédits de ressources ne sont pas des crédits Felo. Les débits définitifs suivent les enregistrements de facturation Felo.
- Type: array (object | null)[]
- adultsType: integer | null
nombre d'adultes
champ facultatif
si vous ne spécifiez pas ce champ, deux adultes seront utilisés par défaut
exemple :1 - checkType: string | null
_in date d'arrivée
champ facultatif
si vous ne spécifiez pas ce champ, la date de demain sera utilisée par défaut ;
la valeur ne doit pas être antérieure à la date du jour
format de date :"yyyy-mm-dd"
exemple :"2019-01-15" - checkType: string | null
_out date de départ
champ facultatif
si vous ne spécifiez pas ce champ, notre système appliquera par défaut la date de deux jours à partir de maintenant ;
Remarque : la valeur ne peut pas être inférieure ou égale àcheck_in;
l'intervalle entre les valeurs decheck_inetcheck_outne peut pas dépasser 30 jours
format de date :"yyyy-mm-dd"
exemple :"2019-01-15" - childrenType: array string[] | null
nombre et âge des enfants
champ facultatif
si vous ne spécifiez pas ce champ, aucun enfant ne sera inclus dans la recherche ;définissez la valeur suivante pour inclure un enfant de 14 ans :
[14]
définissez la valeur suivante pour inclure un enfant de 13 ans et un enfant de 8 ans :[13,8] - currencyType: string | null
devise
champ facultatif
exemple :"USD" - hotelType: string
_identifier identifiant unique de l'hôtel
champ obligatoire
identifiant unique d'une entité hôtelière dans la recherche Google ;
vous pouvez obtenir la valeur en effectuant une requête vers l'Advanced Google SERP API (contenue dans l'élémenthotelsde la réponse) ou vers le point de terminaison Hotel Searches de Business Data API
exemple :ChYIq6SB--i6p6cpGgovbS8wN2s5ODZfEAE - languageType: string
_code code de langue du moteur de recherche
champ obligatoire si vous ne spécifiez paslanguage_name
si vous utilisez ce champ, vous n'avez pas besoin de spécifierlanguage_name
vous pouvez obtenir la liste des langues disponibles avec leurlanguage_codeen effectuant une requête distincte surhttps://api.dataforseo.com/v3/business_data/google/languages
exemple :en - languageType: string
_name nom complet de la langue du moteur de recherche
champ obligatoire si vous ne spécifiez paslanguage_code
si vous utilisez ce champ, vous n'avez pas besoin de spécifierlanguage_code
vous pouvez obtenir la liste des langues disponibles aveclanguage_nameen effectuant une requête distincte surhttps://api.dataforseo.com/v3/business_data/google/languages
exemple :English - loadType: boolean | null
_prices _by _dates charger les prix de séjour à l'hôtel par dates
champ facultatif
si vous spécifiez ce paramètre avectrue, la réponse inclura le tableauprices_by_datesavec les prix de séjour à l'hôtel répartis par dates
si vous utilisez ce paramètre, le double du prix de base par requête vous sera facturé - locationType: integer
_code code d'emplacement du moteur de recherche
champ obligatoire si vous ne spécifiez paslocation_name_orlocation_coordinate
si vous utilisez ce champ, vous n'avez pas besoin de spécifierlocation_nameoulocation_coordinate
vous pouvez obtenir la liste des emplacements disponibles aveclocation_codeen effectuant une requête distincte surhttps://api.dataforseo.com/v3/business_data/google/locations
exemple :2840 - locationType: string
_coordinate coordonnées GPS d'un emplacement
champ obligatoire si vous ne spécifiez paslocation_name_orlocation_code
si vous utilisez ce champ, vous n'avez pas besoin de spécifierlocation_nameoulocation_code
le paramètrelocation_coordinatedoit être spécifié au format "latitude, longitude"
nombre maximal de décimales pour "latitude" et "longitude" : 7
Remarque : si les coordonnées servent à définir un emplacement, la recherche aura lieu dans la localité la plus proche ;
exemple :53.476225,-2.243572 - locationType: string
_name nom complet de l'emplacement du moteur de recherche
champ obligatoire si vous ne spécifiez paslocation_codeoulocation_coordinate
si vous utilisez ce champ, vous n'avez pas besoin de spécifierlocation_codeoulocation_coordinate
vous pouvez obtenir la liste des emplacements disponibles aveclocation_nameen effectuant une requête distincte surhttps://api.dataforseo.com/v3/business_data/google/locations
exemple :London,England,United Kingdom - pricesType: string | null
_date _range période prédéfinie pour récupérer les données de prix quotidiennes
champ facultatif
pour utiliser ce paramètre, vous devez spécifierload_prices_by_datesavectrue
siprices_start_daten'est pas spécifié, la date de début est fixée à la datecheck_in
valeurs possibles :month,three_months,six_months,year
valeur par défaut :month - pricesType: string | null
_end _date date de fin pour charger les prix par dates
champ facultatif
pour utiliser ce paramètre, vous devez spécifierload_prices_by_datesavectrue
si ce paramètre n'est pas spécifié, vous obtiendrez les prix par date pour le mois
format de date :yyyy-mm-dd
exemple :2025-05-21 - pricesType: string | null
_start _date date de début pour charger les prix par dates
champ facultatif
pour utiliser ce paramètre, vous devez spécifierload_prices_by_datesavectrue
si ce paramètre n'est pas spécifié, la date de début est fixée à la datecheck_in
format de date :yyyy-mm-dd
exemple :2025-05-20 - tagType: string | null
identifiant de tâche défini par l'utilisateur
champ facultatif
la limite est de 255 caractères
vous pouvez utiliser ce paramètre pour identifier la tâche et l'associer au résultat
vous trouverez la valeurtagspécifiée dans l'objetdatade la réponse
- Type: object | null · Response36Afe1097B20_BusinessDataGoogleHotelInfoLiveAdvancedResponseInfo200
- Type: number | null Format: doublecost
coût total des tâches, USD
- Type: integer | nullstatus
_code code d'état général vous pouvez trouver la liste complète des codes de réponse ici
- Type: string | nullstatus
_message message d'information général vous pouvez trouver la liste complète des messages d'information généraux ici
- Type: array (object | null)[] | nulltasks
tableau de tâches
- Type: object | null · Response36Afe1097B20_BusinessDataGoogleHotelInfoLiveAdvancedTaskInfo
- costType: number | null Format: double
coût total des tâches, USD
- dataType: object | null
contient les mêmes paramètres que ceux spécifiés dans la requête POST
- propertyType: object | null
Name
- idType: string | null
identifiant de la tâche identifiant unique de la tâche dans notre système au format UUID
- pathType: array (string | null)[] | null
chemin de l'URL
- resultType: array (object | null)[] | null
tableau de résultats
- aboutType: object | null · Response36Afe1097B20_HotelAboutInfo
informations sur l'hôtel
- amenitiesType: array (object | null)[] | null
équipements de l'hôtel
informations sur les équipements de l'hôtel- categoryType: string | null
catégorie normalisée de l'équipement
- categoryType: string | null
_label libellé de la catégorie
- itemsType: array (object | null)[] | null
équipements et détails spécifiques
- amenityType: string | null
nom normalisé de l'équipement
- amenityType: string | null
_label nom de l'équipement affiché
- hintType: string | null
détails normalisés sur l'équipement
- hintType: string | null
_label détails affichés sur l'équipement
- isType: boolean | null
_available indique si l'
amenityest disponible dans l'hôtel
- checkType: object | null · Response36Afe1097B20_TimeInfo
_in _time heure de check-in de l'hôtel
heure de check-in indiquée dans la fiche de l'hôtel- hourType: integer | null
heures au format 24 heures
- minuteType: integer | null
Minutes
- checkType: object | null · Response36Afe1097B20_TimeInfo
_out _time heure de check-out de l'hôtel
heure de check-out indiquée dans la fiche de l'hôtel- hourType: integer | null
heures au format 24 heures
- minuteType: integer | null
Minutes
- descriptionType: string | null
description de l'hôtel
la description de l'entité hôtelière pour laquelle les résultats sont collectés - domainType: string | null
domaine de l'hôtel
domaine du site web de l'hôtel - fullType: string | null
_address adresse complète de l'hôtel
adresse de l'hôtel indiquée au format normalisé - popularType: array (object | null)[] | null
_amenities équipements de l'hôtel
informations sur les équipements de l'hôtel étiquetés « populaires »- amenityType: string | null
nom normalisé de l'équipement
- amenityType: string | null
_label nom de l'équipement affiché
- hintType: string | null
détails normalisés sur l'équipement
- hintType: string | null
_label détails affichés sur l'équipement
- isType: boolean | null
_available indique si l'
amenityest disponible dans l'hôtel
- subType: array (string | null)[] | null
_descriptions description complémentaire de l'hôtel
détails sur l'hôtel fournis en complément de la description - urlType: string | null
url de l'hôtel
URL du site web de l'hôtel indiqué dans la fiche
- addressType: string | null
adresse de l'hôtel
adresse physique de l'hôtel - checkType: string | null
_url URL directe vers les résultats du moteur de recherche
vous pouvez l'utiliser pour vérifier que nous fournissons des résultats précis - datetimeType: string | null
date et heure de réception du résultat
au format UTC : “yyyy-mm-dd hh-mm-ss +00:00”
exemple :2019-11-15 12:57:46 +00:00 - hotelType: string | null
_identifier identifiant reçu dans un tableau POST
ce champ contiendra le paramètrehotel_identifierspécifié lors de la définition d'une tâche ;
exemple :CgoI-KWyzenM_MV3EAE - languageType: string | null
_code code de langue dans un tableau POST
- locationType: object | null · Response36Afe1097B20_HotelLocationInfo
informations sur l'emplacement de l'hôtel
informations sur le lieu où se trouve l'hôtel- latitudeType: number | null
latitude de l'hôtel
coordonnées de latitude de l'emplacement de l'hôtel
exemple :39.4806397 - locationType: array (object | null)[] | null
_chain éléments de la chaîne de localisation
paramètres supplémentaires de chaque élément de la chaîne de localisation- cardType: string | null
_id identifiant de la carte
- cidType: string | null
- featureType: string | null
_id - titleType: string | null
titre de l'élément dans la chaîne de localisation
- longitudeType: number | null
longitude de l'hôtel
coordonnées de latitude de l'emplacement de l'hôtel
exemple :-106.0512973 - mapsType: string | null
_url url de l'emplacement de l'hôtel dans google maps
- neighborhoodType: string | null
nom du quartier où se trouve l'hôtel
- neighborhoodType: string | null
_description description du quartier où se trouve l'hôtel
- overallType: number | null
_score score global de l'emplacement de l'hôtel
indique le score global de l'emplacement de l'hôtel dans une plage de 1 à 5 ;
calculé à partir de données sur la proximité de l'hôtel avec les activités et restaurants à proximité, les transports et les aéroports ;
notez que les critères n'ont pas tous le même poids dans le score global - scoreType: object | null
_by _categories scores par catégorie de l'emplacement de l'hôtel
les scores de l'emplacement de l'hôtel liés aux catégories qui indiquent la proximité avec les activités, restaurants, transports et aéroports à proximité ;- propertyType: number | null Format: double
Name
- locationType: integer | null
_code code de localisation dans un tableau POST
- overviewType: array (string | null)[] | null
_images images affichées dans l'aperçu de l'hôtel
tableau contenant les URL des images affichées dans l'aperçu de l'hôtel - phoneType: string | null
numéro de téléphone de l'hôtel
numéro de téléphone de contact de l'hôtel - pricesType: object | null · Response36Afe1097B20_HotelPriceInfo
détails de tarification de l'entité hôtel
contient des informations sur les prix de l'hôtel- checkType: string | null
_in date et heure d'arrivée
au format UTC : “yyyy-mm-dd hh-mm-ss +00:00”
exemple :2019-11-15 12:57:46 +00:00 - checkType: string | null
_out date et heure de départ
au format UTC : “yyyy-mm-dd hh-mm-ss +00:00”
exemple :2019-11-15 12:57:46 +00:00 - currencyType: string | null
devise du prix
USDest appliqué par défaut, sauf indication contraire dans le tableau POST - discountType: string | null
_text texte concernant une remise appliquée
- itemsType: array (object | null)[] | null
types d'éléments rencontrés
types de résultats de moteurs de recherche rencontrés dans le tableauitems;
types d'éléments possibles :hotel_search_item- currencyType: string | null
devise du prix
USDest appliqué par défaut, sauf indication contraire dans le tableau POST - domainType: string | null
domaine tiers domaine de la page du site web tiers contenant des informations tarifaires
- freeType: string | null
_cancellation _until date jusqu'à laquelle l'annulation gratuite est disponible au format UTC : “yyyy-mm-dd hh-mm-ss +00:00” vaut null si l'annulation gratuite n'est pas disponible pour les dates sélectionnées
- isType: boolean | null
_paid indique une fiche d'hôtel payante
sitrue, lehotel_search_itemassocié est une annonce payante
sifalse, lehotel_search_itemassocié est une fiche d'hôtel organique - offersType: array (object | null)[] | null
offres de prix à la une
- currencyType: string | null
devise du prix
USDest appliqué par défaut, sauf indication contraire dans le tableau POST - freeType: string | null
_cancellation _until date jusqu'à laquelle l'annulation gratuite est disponible au format UTC : “yyyy-mm-dd hh-mm-ss +00:00” vaut null si l'annulation gratuite n'est pas disponible pour les dates sélectionnées
- maxType: integer | null
_visitors le nombre maximal de visiteurs le nombre maximal de visiteurs pour lequel l'offre de prix est valide
- offerType: array (string | null)[] | null
_images images de l'offre de prix URL des images présentées dans l'offre de prix
- priceType: number | null
prix par nuit
- titleType: string | null
titre de l'hôtel
- typeType: string | null
type d'élément
- urlType: string | null
url de l'offre de prix URL de la page du site web où l'offre de prix apparaît
- officialType: boolean | null
_site - priceType: number | null
prix par nuit
- titleType: string | null
titre de l'hôtel
- typeType: string | null
type d'élément
- urlType: string | null
url de la page tierce URL de la page du site web tiers contenant des informations tarifaires
- priceType: number | null
prix par nuit
- priceType: number | null Format: int64
_without _discount prix total par nuit sans remise appliquée
- pricesType: array (object | null)[] | null
_by _dates - checkType: string | null
_in _date - checkType: string | null
_out _date - currencyType: string | null
devise du prix
USDest appliqué par défaut, sauf indication contraire dans le tableau POST - priceType: number | null
prix par nuit
- visitorsType: integer | null
nombre de visiteurs de l'hôtel pour ce prix
- reviewsType: object | null · Response36Afe1097B20_HotelReviewInfo
avis sur l'hôtel par critère
informations sur les avis de l'entité hôtel- mentionsType: array (object | null)[] | null
mentions de l'hôtel
informations sur les avis sur l'hôtel par critère- negativeType: integer | null Format: int64
_count nombre d'avis négatifs par critère
- positiveType: integer | null Format: int64
_count nombre d'avis positifs par critère
- positiveType: number | null
_score score positif par critère
- titleType: string | null
titre du critère évalué
- totalType: integer | null Format: int64
_count nombre de tous les avis par critère
- visibleType: boolean | null
_by _default élément visible par défaut
indique si l'élément d'avis est visible par défaut
- otherType: array (object | null)[] | null
_sites _reviews avis sur des sites tiers
avis provenant de sites tiers- ratingType: object | null · Response36Afe1097B20_RatingInfo
note dans l'avis
informations sur la note contenue dans l'avis sur un site tiers- ratingType: integer | null
_max la valeur maximale d'un rating_type
- ratingType: string | null
_type le type de note vous trouverez ici les éléments suivants : Max5, Percents, CustomMax
- valueType: number | null Format: double
la valeur de la note
- votesType: integer | null Format: int64
_count la quantité d'avis
- reviewType: string | null
_text texte de l'avis
texte de l'avis - titleType: string | null
titre de l'avis
contient le nom du site tiers où l'avis est initialement apparu - urlType: string | null
URL de l'avis
URL du site tiers où l'avis est initialement apparu
- ratingType: object | null
_distribution répartition des notes par votes
la répartition des votes sur la note dans la plage de 1 à 5- propertyType: integer | null Format: Int64
Name
- valueType: number | null
note globale de l'hôtel basée sur les votes des clients
- votesType: integer | null Format: int64
_count nombre de votes des clients
le nombre de votes de clients pris en compte dans le calcul de la note de l'hôtel
- starsType: integer | null
classement par étoiles de l'hôtel
classement allant de 1 à 5 étoiles, affiché après les notes d'avis dans le résumé de l'hôtel - starsType: string | null
_description classement par étoiles de l'hôtel
classement allant de 1 à 5 étoiles, affiché après les notes d'avis dans le résumé de l'hôtel - titleType: string | null
titre de l'hôtel
le titre de l'entité hôtel pour laquelle les résultats sont collectés
- resultType: integer | null Format: int64
_count nombre d'éléments dans le tableau de résultats
- statusType: integer | null
_code code d'état de la tâche généré par DataForSEO ; peut être compris dans la plage suivante : 10000-60000 vous pouvez trouver la liste complète des codes de réponse ici
- statusType: string | null
_message message d'information de la tâche vous pouvez trouver la liste complète des messages d'information généraux ici
- timeType: string | null
temps d'exécution, en secondes
- Type: integer | null Format: int64tasks
_count le nombre de tâches dans le tableau de tâches
- Type: integer | null Format: int64tasks
_error le nombre de tâches dans le tableau de tâches renvoyées avec une erreur
- Type: string | nulltime
temps d'exécution total, en secondes
- Type: string | nullversion
la version actuelle de l'API
application/json - 400
La requête n'a pas pu être traitée. Vérifiez les paramètres de la requête.
- 401
Une clé API Felo valide est requise.
- 402
La requête ne peut pas aboutir car une condition de facturation n'est pas remplie.
- 403
Le compte n'est pas autorisé à effectuer cette opération.
- 429
Une limite de requêtes ou de dépenses a été atteinte.
- 502
Le service n'a pas pu terminer la requête.
- 503
L'API ou le service de facturation est temporairement indisponible.
- 504
Le service a expiré lors du traitement de la requête.
- default
Réponse d'erreur ; les réponses transmises depuis l'upstream peuvent utiliser les formats du fournisseur
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]"
]
}
}
]
}
]
}