Tâches Google Hotel Searches en temps réel
DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Tâches Google Hotel Searches en temps réel
Recherche sur Google Hotels des établissements correspondant à une requête, avec dates et occupation. 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. C'est ainsi que l'on trouve l'hôtel dont l'id est nécessaire aux endpoints d'informations ; post_dataforseo_business_google_hotel_info_live est la vue détaillée.
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, la valeur par défaut de2sera appliquée ;
remarque : vous pouvez spécifier jusqu'à 6 personnes, adultes et enfants compris
exemple :1 - amenitiesType: array string[] | null
équipements de l'hôtel
champ facultatif
vous pouvez utiliser ce champ pour spécifier différents équipements de l'hôtel
exemple :[
"free_parking",
"pets_allowed"
]
valeurs possibles :"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" - 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 ;
format de date :"yyyy-mm-dd"
exemple :"2019-01-15"
Remarque : la valeur ne peut pas précéder la date du jour - 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 ;
format de date :"yyyy-mm-dd"
exemple :"2019-01-15"
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 - 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 ;
l'âge de l'enfant peut aller de0à17;
remarque : vous pouvez spécifier jusqu'à 6 personnes, adultes et enfants compris
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" - depthType: integer | null
profondeur d'analyse
champ facultatif
nombre de résultats dans Google Hotels
valeur par défaut :18résultats organiques
valeur maximale :140
Remarque : votre compte sera facturé pour chaque 18 résultats organiques, indépendamment des annonces payantes dans la réponse ;
ainsi, définir une profondeur supérieure à18peut entraîner des frais supplémentaires si Google Hotels renvoie plus de 18 résultats ;
Si la profondeur spécifiée est supérieure au nombre de résultats de la réponse, la différence sera automatiquement remboursée sur le solde de votre compte - freeType: boolean | null
_cancellation hôtels avec annulation gratuite
champ facultatif
définissez ce champ surtruesi vous souhaitez obtenir la liste des hôtels avec annulation gratuite des réservations
valeur par défaut :false - isType: boolean | null
_vacation _rentals recherche de locations de vacances
champ facultatif
définissez ce champ surtruesi vous souhaitez obtenir la liste des locations de vacances au lieu des hôtels
valeur par défaut :false - keywordType: string | null
mot-clé
champ facultatif
le mot-clé que vous spécifiez sert à rechercher la liste des hôtels ;
si vous n'utilisez pas ce champ, nous renverrons la liste des hôtels trouvés dans un emplacement spécifié ;
vous pouvez spécifier jusqu'à 700 caractères dans le champkeyword
tous les %## seront décodés (le caractère ‘+’ sera décodé en espace)
si vous devez utiliser le caractère “%” dans votrekeyword, spécifiez-le comme “%25” ;
Remarque : pour obtenir des résultats de recherche précis, le nom de l'emplacement est automatiquement ajouté au mot-cléen savoir plus sur les règles et limites des champs
keywordetkeywordsdans les API DataForSEO dans cet article du centre d'aide - 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 - 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
Remarque : pour obtenir des résultats de recherche précis, lelocation_nameque vous spécifiez sera automatiquement ajouté au mot-clé - maxType: integer | null
_price prix maximal par nuit
champ facultatif
la devise de cette valeur dépend du champcurrency
exemple :600 - minType: integer | null
_price prix minimal par nuit
champ facultatif
la devise de cette valeur dépend du champcurrency
exemple :100 - minType: number | null
_rating note minimale
champ facultatif
vous pouvez utiliser ce champ pour spécifier une note des clients supérieure à une certaine valeur
exemple :2.5 - searchType: boolean | null
_this _area afficher les hôtels de la zone affichée
champ facultatif
peut prendre les valeurs :true,false
valeur par défaut :true
si elle est définie surfalse, le modesearch_this_areasera désactivé
Remarque : si le modesearch_this_areaest désactivé,location_namene sera pas ajouté aukeywordlors de la recherche
en savoir plus sur ce paramètre dans notre centre d'aide - sortType: string | null
_by paramètres de tri des résultats
champ facultatif
vous pouvez utiliser ce champ pour trier les résultats
types de tri possibles :relevance– trier par pertinencelowest_price– trier par prix le plus bashighest_rating– trier par note la plus élevéemost_reviewed– trier par nombre d'avis
valeur par défaut :relevance - starsType: array string[] | null
étoiles de l'hôtel
champ facultatif
définissez ce champ sur[5]si vous souhaitez obtenir uniquement la liste des hôtels 5 étoiles
exemple :[3,4,5] - 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_BusinessDataGoogleHotelSearchesLiveResponseInfo200
- 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_BusinessDataGoogleHotelSearchesLiveTaskInfo
- 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
- 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 - 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- hotelType: string | null
_identifier identifiant unique d'une entité hôtel dans la recherche Google
exemple :CgoI-KWyzenM_MV3EAE - 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 - locationType: object | null · Response36Afe1097B20_GpsCoordinatesLocationInfo
coordonnées GPS de l'emplacement de l'hôtel
- latitudeType: number | null
coordonnée de latitude de l'hôtel dans google maps
exemple :"latitude": 51.584091 - longitudeType: number | null
coordonnée de longitude de l'hôtel dans google maps
exemple :"longitude": -0.31365919999999997
- overviewType: array (string | null)[] | null
_images images en vedette d'un hôtel
- pricesType: object | null · Response36Afe1097B20_HotelPriceInfo
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 et informations de notation de l'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 - titleType: string | null
titre de l'hôtel
- typeType: string | null
type d'élément
- itemsType: integer | null Format: int64
_count types d'éléments
le nombre d'éléments du tableauitems - keywordType: string | null
mot-clé reçu dans un tableau POST
le mot-clé est renvoyé avec %## décodé (le caractère '+' sera décodé en espace) - languageType: string | null
_code code de langue dans un tableau POST
- locationType: integer | null
_code code de localisation dans un tableau POST
- 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_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]"
}
]
}
]
}
]
}