Hotel Price Tracker
Le calendrier de prix de Google Hotels indique, pour un hôtel, le prix le plus bas d’une nuit pour une arrivée à chaque date des semaines à venir. Lus comme une série temporelle, ces prix par nuit révèlent l’écart entre semaine et week-end, les pics saisonniers et le meilleur moment pour réserver, et servent au suivi des prix, aux analyses de revenue management et à la préparation des voyages.
Fonctionnalités de la Hotel Price Tracker API
- Le calendrier en lignesChaque ligne correspond à une date d’arrivée ; check_out est le lendemain, et price.amount, price.currency et un prix mis en forme donnent le prix le plus bas de cette nuit.
- Plusieurs semaines par requêteUne requête couvre en général 6 à 8 semaines de dates d’arrivée, sans avoir à interroger chaque date séparément.
- Date de début au choixcheck_in fixe le début du calendrier et s’indique avec check_out ; sans précision, le calendrier commence demain.
- Des lignes repérées par hôtel et par dateChaque ligne contient hotel_id et name, et id combine l’identifiant de l’hôtel et la date d’arrivée, ce qui facilite la fusion de requêtes répétées.
Paramètres de la Hotel Price Tracker 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 de début du calendrier (YYYY-MM-DD, aujourd’hui ou plus tard). À indiquer avec check_out ; sans ces deux dates, le calendrier commence 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 nuit, 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 résultats. Valeur par défaut : en. |
Comment utiliser la Hotel Price Tracker API
Envoyez un identifiant d’hôtel et lisez une ligne par date d’arrivée.
- Envoyez {"hotel_id": "ChoIyKbJ6puqvPf8ARoNL2cvMTFqNHR2MjczeBAB", "currency": "USD"} en POST à /v1/google-hotels/hotel-prices.
- Interrogez GET /v1/tasks/{task_id} jusqu’à ce que status vaille succeeded.
- Lisez les prix par date 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/hotel-prices" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"hotel_id":"ChoIyKbJ6puqvPf8ARoNL2cvMTFqNHR2MjczeBAB","currency":"USD"}'Cas d’usage de la Hotel Price Tracker API
- Trouver la nuit la moins chère : Triez par price.amount et choisissez la date d’arrivée la moins chère des semaines à venir pour organiser votre voyage.
- Semaine contre week-end : Regroupez par jour de la semaine de check_in et calculez de combien les nuits du vendredi et du samedi dépassent celles de la semaine.
- Suivi des variations de prix : Récupérez le calendrier à intervalles réguliers, comparez le prix d’un même id d’une exécution à l’autre et repérez quand un hôtel augmente ou baisse ses tarifs.
- Comparaison avec la concurrence : Récupérez dans la même devise les calendriers de plusieurs hôtels voisins et alignez-les par check_in pour comparer l’avantage tarifaire nuit par nuit.
Conseils d’expert pour la Hotel Price Tracker API
- Enregistrez les lignes sous l’id qui combine hôtel et date d’arrivée : une exécution quotidienne met alors à jour la même nuit au lieu de créer des doublons.
- Pour voir des dates plus lointaines, décalez check_in et relancez la requête.
- Gardez la même currency lorsque vous comparez plusieurs hôtels ou plusieurs exécutions.
- Une requête coûte 4 crédits quel que soit le nombre de dates renvoyées : le calendrier revient donc moins cher que des requêtes date par date.
API associées
En complément de la Hotel Price Tracker 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.
- 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.