Configurer les tâches Google Hotel Searches
DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Configurer les tâches Google Hotel Searches
Met en file d'attente une recherche Google Hotels et renvoie un id de tâche. 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. Récupérez avec get_dataforseo_business_google_hotel_searches_fetch.
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",
"all_inclusive_available",
"bar",
"free_breakfast",
"fitness_center",
"kid_friendly",
"free_parking",
"pets_allowed",
"pool",
"restaurant",
"room_service",
"spa",
"free_wifi",
"parking",
"indoor_pool",
"outdoor_pool",
"wheelchair_accessible",
"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 - pingbackType: string | null
_url URL de notification d'une tâche terminée
champ facultatif
lorsqu'une tâche est terminée, nous vous en informons par une requête GET envoyée à l'URL que vous avez spécifiée
vous pouvez utiliser la chaîne ‘$id’ comme variable$idet ‘$tag’ comme variable$tagencodée pour URL. Nous définirons les valeurs nécessaires avant d'envoyer la requête.
exemple :http://your-server.com/pingscript?id=$idhttp://your-server.com/pingscript?id=$id&tag=$tag
Remarque : les caractères spéciaux depingback_urlseront encodés pour URL ;
notamment, le caractère#sera encodé en%23 - postbackType: string | null
_url URL d'envoi des résultats de la tâche
champ facultatif
une fois la tâche terminée, nous enverrons une requête POST avec ses résultats compressés au formatgzipà l'adressepostback_urlque vous avez spécifiée
vous pouvez utiliser la chaîne ‘$id’ comme variable$idet ‘$tag’ comme variable$tagencodée pour URL. Nous définirons les valeurs nécessaires avant d'envoyer la requête.
exemple :http://your-server.com/postbackscript?id=$idhttp://your-server.com/postbackscript?id=$id&tag=$tag
Remarque : les caractères spéciaux depostback_urlseront encodés pour URL ;
notamment, le caractère#sera encodé en%23 - priorityType: integer | null
- 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_BusinessDataGoogleHotelSearchesTaskPostResponseInfo200
- 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_BusinessDataGoogleHotelSearchesTaskPostTaskInfo
- 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: object | null
tableau de résultats
dans ce cas, la valeur seranull - 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_post \
--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": null
}
]
}