Obtenir les résultats de Google Hotel Searches par id
DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Obtenir les résultats de Google Hotel Searches par id
Récupère par id une recherche Google Hotels en file d'attente. 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_BusinessDataGoogleHotelSearchesTaskGetResponseInfo200
- 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_BusinessDataGoogleHotelSearchesTaskGetTaskInfo
- 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
- 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) ;
afin d'obtenir des résultats de recherche précis, le nom du lieu est ajouté automatiquement au mot-clé - 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/task_get/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": [
{
"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]"
}
]
}
]
}
]
}