google-hotels/
search

Recherchez des hôtels sur Google Hotels par destination et obtenez pour chacun le prix par nuit à vos dates, les étoiles, la note des voyageurs, le nombre d’avis, les coordonnées et un identifiant pour aller plus loin.

Google Hotels API

Recherche par destination
Prix à vos dates
Étoiles et note des voyageurs
Identifiant d’hôtel réutilisable
0,15 crédit par résultat
Prêt
Prêt

Saisissez des paramètres et envoyez une requête. L’état de la tâche et les résultats normalisés s’afficheront ici.

README

Par SocQ · Mis à jour le

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ètresObligatoireDescription
queryObligatoireRecherche de destination ou d’hôtel, par exemple hotels in new york ou un nom d’hôtel.
check_inFacultatifDate 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_outFacultatifDate de départ (YYYY-MM-DD). Doit suivre check_in ; 30 nuits au maximum.
currencyFacultatifCode de devise à trois lettres pour les prix et la fourchette de prix, par exemple USD ou EUR.
sort_byFacultatifOrdre de tri : relevance, lowest_price, highest_rating ou most_reviewed.
min_priceFacultatifPrix minimum par nuit, dans la devise de currency.
max_priceFacultatifPrix maximum par nuit, dans la devise de currency. Ne peut pas être inférieur à min_price.
location_codeFacultatifCode de localisation du marché de recherche. Valeur par défaut : 2840 (États-Unis).
language_codeFacultatifCode de langue des résultats. Valeur par défaut : en.
results_limitFacultatifNombre 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.

  1. Envoyez {"query": "hotels in new york", "currency": "USD", "results_limit": 18} en POST à /v1/google-hotels/search.
  2. Interrogez GET /v1/tasks/{task_id} jusqu’à ce que status vaille succeeded.
  3. 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.

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.

Explorer d’autres plateformes

Combinez les données Google Hotels avec les données publiques d’autres plateformes sociales prises en charge.

Google Hotels API — FAQ

Google Hotels API recherche des hôtels sur Google Hotels par destination ou par nom et renvoie pour chacun le prix par nuit à vos dates, les étoiles, la note des voyageurs, le nombre d’avis, les coordonnées, des photos et un identifiant d’hôtel.

Aux dates check_in et check_out que vous indiquez, dans la limite de 30 nuits. Sans ces deux dates, les prix portent sur une nuit à partir de demain ; chaque ligne précise les dates de son prix.

Oui. min_price et max_price encadrent le prix par nuit, et sort_by trie par relevance, lowest_price, highest_rating ou most_reviewed.

La recherche renvoie les champs d’une liste. Transmettez l’id d’un hôtel à Google Hotel Details API pour l’adresse, les équipements, les thèmes d’avis et les prix par site de réservation, ou à Hotel Price Tracker API pour les prix par date d’arrivée.

0,15 crédit par hôtel renvoyé, soit 2,7 crédits pour 18 hôtels. Une recherche qui ne trouve aucun hôtel n’est pas facturée.