Obtenir les résultats d'Advanced Google Hotel Info par id
DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Obtenir les résultats d'Advanced Google Hotel Info par id
Récupère par id une fiche d'hôtel en file d'attente, analysée. 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. 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 taille de la réponse a été fixée par le depth ou la limite définie lors de la soumission et ne peut pas être réduite ici ; si elle est trop grande, soumettez à nouveau avec une valeur plus petite plutôt que de paginer.
Référence tarifaire
- Facturation : coût de réponse déclaré.
- Estimation de référence par requête : USD 0.012.
- 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: object | null · Response36Afe1097B20_BusinessDataGoogleHotelInfoTaskGetAdvancedResponseInfo200
- 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_BusinessDataGoogleHotelInfoTaskGetAdvancedTaskInfo
- 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 unique de l'hôtel
ce champ contiendra le paramètrehotel_identifier;
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/task_get/advanced/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": [
{
"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]"
]
}
}
]
}
]
}