Google Hotel Details
La fiche d’un hôtel sur Google Hotels réunit adresse, téléphone, horaires d’arrivée et équipements avec ce que disent les voyageurs : la part de chaque note en étoiles, les mentions positives et négatives sur des thèmes comme l’emplacement ou le petit-déjeuner, et les notes d’autres sites d’avis. Avec les prix que chaque site de réservation et le site officiel de l’hôtel affichent pour le même séjour, elle sert au contrôle de la parité tarifaire, à la comparaison avec la concurrence et à l’enrichissement des fiches hôtel.
Fonctionnalités de la Google Hotel Details API
- Prix par site de réservationoffers donne pour chaque vendeur le prix par nuit et un lien de réservation ; is_official, is_sponsored et free_cancellation_until signalent le tarif direct, les emplacements sponsorisés et les tarifs annulables sans frais.
- Ce dont parlent les voyageursreview_topics renvoie positive_count, negative_count et mentions_count pour des thèmes comme Wellness ou Breakfast et montre quelles parties du séjour sont appréciées ou critiquées.
- Répartition des notes et autres sitesrating_distribution indique la part de chaque note en étoiles, other_reviews la note, le nombre d’avis et un extrait de sites comme Tripadvisor.
- Notes du quartierlocation_scores note de 1 à 5 l’emplacement global, les loisirs, les restaurants, les transports et l’accès à l’aéroport, avec le nom du quartier et les coordonnées.
- La fiche de l’hôtel en une ligneaddress, phone, website, check_in_time, check_out_time, les équipements disponibles, une description et des photos sont renvoyés ensemble.
- Des prix à vos datescheck_in, check_out et currency fixent le séjour auquel s’appliquent les prix ; sans dates, il s’agit d’une nuit à partir de demain.
Paramètres de la Google Hotel Details API
| Paramètres | Obligatoire | Description |
|---|---|---|
hotel_id | Obligatoire | Identifiant d’hôtel issu du champ id d’un résultat de Google Hotels API. |
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, par exemple USD ou EUR. |
location_code | Facultatif | Code de localisation du marché de recherche. Valeur par défaut : 2840 (États-Unis). |
language_code | Facultatif | Code de langue des détails de l’hôtel. Valeur par défaut : en. |
Comment utiliser la Google Hotel Details API
Envoyez un identifiant issu de la recherche d’hôtels et lisez l’hôtel sur une seule ligne.
- Envoyez {"hotel_id": "ChoIyKbJ6puqvPf8ARoNL2cvMTFqNHR2MjczeBAB", "currency": "USD"} en POST à /v1/google-hotels/hotel-details.
- Interrogez GET /v1/tasks/{task_id} jusqu’à ce que status vaille succeeded.
- Lisez l’hôtel dans results.items. has_more et results.next_cursor suivent les règles de pagination habituelles et restent vides pour ce résultat d’une seule ligne.
curl -X POST "https://api.socq.ai/v1/google-hotels/hotel-details" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"hotel_id":"ChoIyKbJ6puqvPf8ARoNL2cvMTFqNHR2MjczeBAB","currency":"USD"}'Cas d’usage de la Google Hotel Details API
- Contrôle de la parité tarifaire : Comparez le tarif direct marqué is_official aux prix des agences de voyage en ligne pour les mêmes dates et repérez les vendeurs qui proposent l’hôtel moins cher.
- Comparaison avec la concurrence : Placez côte à côte rating_distribution, review_topics et location_scores d’hôtels voisins pour voir où un établissement prend l’avantage et où il recule.
- Fiches hôtel complètes : Récupérez en une requête adresse, équipements, horaires d’arrivée, photos et notes du quartier pour enrichir les fiches hôtel d’un service de voyage.
- Analyse de l’avis des voyageurs : Triez review_topics par negative_count pour faire ressortir les thèmes qui suscitent le plus de plaintes, comme le bruit ou le petit-déjeuner.
Conseils d’expert pour la Google Hotel Details API
- Utilisez des identifiants issus d’une recherche récente avec Google Hotels API, pour que chaque requête à 2 crédits renvoie l’hôtel attendu.
- Reprenez les mêmes check_in, check_out et currency que pour la recherche afin que les prix des vendeurs correspondent au prix de la liste.
- Écartez les emplacements sponsorisés avec is_sponsored avant de comparer les vendeurs, pour une comparaison équilibrée.
- Traitez rating_distribution.share comme une part comprise entre 0 et 1 lorsque vous représentez la répartition des notes.
API associées
En complément de la Google Hotel Details API, utilisez ces API lorsque vous avez besoin d’un autre type de données publiques Google Hotels.
- Google Hotels API — 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 l’identifiant.
- 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.