Google Hotels
Un résultat de recherche sur Google Hotels réunit le nom, la catégorie et la position d’un hôtel avec la note des voyageurs, le nombre d’avis, des photos et le prix par nuit le plus bas pour les dates et la devise choisies. Comparées côte à côte, ces données montrent comment l’offre hôtelière varie d’une destination à l’autre, comment prix et notes s’équilibrent et quels établissements méritent un examen plus poussé.
Fonctionnalités de la Google Hotels API
- Chercher comme un voyageurquery accepte une destination comme hotels in new york ou un nom d’hôtel ; les hôtels reviennent dans l’ordre affiché par Google Hotels et rank indique la position de chacun.
- Des prix pour un vrai séjourcheck_in, check_out et currency définissent le séjour qui vous intéresse ; chaque ligne reprend ces dates avec price.amount, price.currency et un prix mis en forme.
- Tri et fourchette de prixsort_by bascule entre relevance, lowest_price, highest_rating et most_reviewed, et min_price et max_price ne gardent que les hôtels compatibles avec votre budget.
- Des indicateurs de qualité pour chaque hôtelstars donne la catégorie de l’hôtel, rating la note moyenne des voyageurs de 1 à 5 et reviews_count le nombre d’avis sur lequel elle repose.
- Coordonnées et photoslocation fournit la latitude et la longitude, images les photos que Google affiche pour l’hôtel.
- Des identifiants pour la suiteL’id de chaque ligne se transmet tel quel à Google Hotel Details API et à Hotel Price Tracker API, et url pointe vers la fiche de l’hôtel sur Google Hotels.
- Jusqu’à 140 hôtels par requêteresults_limit va de 1 à 140, et is_sponsored distingue les emplacements sponsorisés des résultats classiques.
Paramètres de la Google Hotels API
| Paramètres | Obligatoire | Description |
|---|---|---|
query | Obligatoire | Recherche de destination ou d’hôtel, par exemple hotels in new york ou un nom d’hôtel. |
check_in | Facultatif | Date d’arrivée (YYYY-MM-DD, aujourd’hui ou plus tard). À indiquer avec check_out ; sans ces deux dates, les prix portent sur une nuit à partir de demain. |
check_out | Facultatif | Date de départ (YYYY-MM-DD). Doit suivre check_in ; 30 nuits au maximum. |
currency | Facultatif | Code de devise à trois lettres pour les prix et la fourchette de prix, par exemple USD ou EUR. |
sort_by | Facultatif | Ordre de tri : relevance, lowest_price, highest_rating ou most_reviewed. |
min_price | Facultatif | Prix minimum par nuit, dans la devise de currency. |
max_price | Facultatif | Prix maximum par nuit, dans la devise de currency. Ne peut pas être inférieur à min_price. |
location_code | Facultatif | Code de localisation du marché de recherche. Valeur par défaut : 2840 (États-Unis). |
language_code | Facultatif | Code de langue des résultats. Valeur par défaut : en. |
results_limit | Facultatif | Nombre d’hôtels à renvoyer (1 à 140). Valeur par défaut : 18. |
Comment utiliser la Google Hotels API
Lancez une recherche par destination et lisez les hôtels ligne par ligne.
- Envoyez {"query": "hotels in new york", "currency": "USD", "results_limit": 18} en POST à /v1/google-hotels/search.
- Interrogez GET /v1/tasks/{task_id} jusqu’à ce que status vaille succeeded.
- Lisez les hôtels dans results.items et utilisez results.next_cursor pour la page suivante tant que has_more vaut true.
curl -X POST "https://api.socq.ai/v1/google-hotels/search" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"hotels in new york","currency":"USD","results_limit":18}'Cas d’usage de la Google Hotels API
- Niveau de prix d’une destination : Placez price.amount à côté de stars et rating pour les mêmes dates et situez les prix hôteliers d’une ville selon la catégorie.
- Présélection d’hôtels : Gardez les hôtels de votre fourchette de prix dont rating et reviews_count atteignent votre seuil, puis transmettez leur id aux requêtes de détails et de prix.
- Comparaison de dates de voyage : Relancez la même query en changeant check_in et check_out, puis rapprochez les résultats par id pour voir l’évolution des prix d’une date à l’autre.
- Carte de l’offre hôtelière : Superposez stars et prix aux coordonnées de location pour repérer où se concentrent les hôtels abordables et haut de gamme dans un quartier.
Conseils d’expert pour la Google Hotels API
- Précisez toujours currency pour les recherches que vous comparez, afin que price.amount soit exprimé dans la même unité.
- Indiquez check_in et check_out ensemble. Un séjour de plus de 30 nuits ou un départ avant l’arrivée est refusé avant la création de la tâche.
- Rapprochez les requêtes suivantes par id plutôt que par nom : les hôtels d’une même chaîne dans une ville portent souvent des noms très proches.
- Chaque hôtel renvoyé coûte 0,15 crédit ; réglez donc results_limit sur le nombre d’hôtels que vous examinerez vraiment.
API associées
En complément de la Google Hotels API, utilisez ces API lorsque vous avez besoin d’un autre type de données publiques Google Hotels.
- Google Hotel Details API — Ouvrez la fiche Google Hotels d’un hôtel à partir de son identifiant, avec coordonnées, équipements, notes du quartier, répartition des notes, thèmes d’avis et offres par site de réservation.
- Hotel Price Tracker API — Récupérez le calendrier de prix Google Hotels d’un hôtel à partir de son identifiant, avec le prix par nuit le plus bas pour chaque date d’arrivée sur environ 6 à 8 semaines.