Google Hotels réunit sur une seule page les étoiles, les notes des clients, les prix par nuit et les offres des sites de réservation pour une destination. Les produits de voyage, les outils de comparaison tarifaire et les revenue managers veulent ces données sous forme de lignes : une liste d’hôtels à comparer, la fiche complète d’un établissement et l’évolution de son prix selon les dates.
Le 2026-11-17, SocQ a lancé la plateforme Google Hotels avec trois endpoints qui font exactement cela. Ils s’enchaînent grâce à un seul champ, l’id de l’hôtel. Ce guide présente ce que renvoie chacun d’eux, la requête, le prix et le moment où l’utiliser.
Réponse rapide : recherchez une destination avec
POST /v1/google-hotels/searchet conservez l’idde chaque hôtel. Passez-le commehotel_idàPOST /v1/google-hotels/hotel-detailspour obtenir les équipements, les thèmes des avis et les offres des sites de réservation, ou àPOST /v1/google-hotels/hotel-pricespour obtenir le prix le plus bas par nuit selon la date d’arrivée. InterrogezGET /v1/tasks/{task_id}pour récupérer les résultats.
Les nouveaux endpoints Google Hotels
1 crédit SocQ = $0,005.
| Endpoint | Ce qu’il renvoie | Prix |
|---|---|---|
| Google Hotels API | Les hôtels d’une destination avec étoiles, note des clients, nombre d’avis, prix le plus bas par nuit pour vos dates, localisation, photos et id de l’hôtel | 0,15 crédit ($0,00075) par hôtel |
| Google Hotel Details API | L’adresse, le téléphone, le site web, les équipements, les scores de localisation, la répartition des notes, les thèmes des avis, les notes sur d’autres sites et l’offre de chaque site de réservation pour un hôtel | 2 crédits ($0,01) par appel |
| Hotel Price Tracker API | Une ligne par date d’arrivée avec le prix le plus bas de l’hôtel pour une nuit, généralement sur six à huit semaines de dates | 4 crédits ($0,02) par appel |
Authentification et flux de tâches asynchrones
Toutes les requêtes SocQ s’authentifient avec une clé API, et le même en-tête sert pour l’envoi, le statut de la tâche et la récupération des résultats :
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Chaque collecte s’exécute comme une tâche en arrière-plan :
submit -> task_id -> queued -> running -> succeeded
\-> failed
La réponse à l’envoi contient data.task_id et data.status. Interrogez la tâche avec cet ID :
curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=50" \
-H "Authorization: Bearer $SOCQ_API_KEY"
Lorsque status vaut succeeded, la réponse contient la première page d’enregistrements normalisés dans data.results.items. limit vaut 50 par défaut et peut aller jusqu’à 500 ; si has_more est vrai, passez results.next_cursor comme cursor pour lire la page suivante. Tant qu’une tâche est queued, running ou failed, l’endpoint renvoie les métadonnées de la tâche sans results.
Un callback_url facultatif dans le corps de l’envoi permet à SocQ d’envoyer un POST contenant un résumé de la tâche lorsqu’elle se termine ; lisez ensuite les enregistrements avec GET /v1/tasks/{task_id}. Un délai d’expiration côté client n’annule pas une tâche : reprenez avec le même ID de tâche plutôt que de payer un doublon. 402 signifie que les crédits sont insuffisants ; 429 signifie que la clé a atteint une limite de débit ou de crédits.
Google Hotels API : rechercher une destination
La Google Hotels API recherche des hôtels comme le font les voyageurs sur Google. Indiquez une destination ou une recherche d’hôtel dans query.
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
}'
Champs facultatifs :
check_inetcheck_out(YYYY-MM-DD, fournis ensemble, jusqu’à 30 nuits) indiquent le prix d’un séjour précis. Sans eux, les prix portent sur une nuit à partir de demain.currency: un code à trois lettres commeUSDouEUR.sort_by:relevance,lowest_price,highest_ratingoumost_reviewed.min_priceetmax_price: la fourchette de prix par nuit, dans la devise choisie.location_code(2840 par défaut, États-Unis) etlanguage_code(enpar défaut).results_limit: de 1 à 140, 18 par défaut.
Chaque ligne d’hôtel contient id, name, stars (1 à 5), rating (1 à 5), reviews_count, price (amount, currency, formatted), les check_in et check_out auxquels correspond le prix, is_sponsored, location avec latitude et longitude, images et rank dans les résultats. Les 18 hôtels par défaut coûtent 2,7 crédits ($0,0135) ; le maximum de 140 coûte 21 crédits ($0,105). Documentation : recherche Google Hotels.
Google Hotel Details API : tout sur un établissement
La Google Hotel Details API renvoie une ligne avec tout ce que Google Hotels sait d’un établissement. Passez l’id d’un résultat de recherche comme hotel_id. Ajoutez check_in et check_out pour obtenir les offres à ces dates ; sinon, les offres portent sur une nuit à partir de demain.
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"
}'
En plus des champs de la recherche, la ligne détaillée renseigne :
address,phone,website,check_in_time,check_out_timeetamenities.location_scoresde 1 à 5 pouroverall,things_to_do,restaurants,transitetairport_access.rating_distribution, la part des avis pour chaque nombre d’étoiles.review_topics, comme Location ou Breakfast, avec le nombre de mentions positives, négatives et totales.other_reviews, la note et le nombre d’avis de l’hôtel sur d’autres sites d’avis.offers, une par site de réservation, avecseller,price, l’urlde réservation,is_official,is_sponsoredetfree_cancellation_until.
offers est ce dont ont besoin les contrôles de parité tarifaire : comparez l’offre officielle avec celles des agences de voyage en ligne pour les mêmes dates. Chaque requête coûte 2 crédits ($0,01). Un hotel_id inconnu ne renvoie aucune ligne et reste facturé. Documentation : Google Hotel Details.
Hotel Price Tracker API : prix le plus bas par date d’arrivée
La Hotel Price Tracker API renvoie sous forme de lignes le calendrier de prix qui se cache derrière le sélecteur de dates de Google Hotels. Pour un hôtel, vous obtenez le prix le plus bas pour chaque nuit d’arrivée, généralement sur six à huit semaines de dates à partir de votre date d’arrivée.
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"
}'
check_in définit la première date du calendrier (demain s’il est omis) ; fournissez check_out avec lui. Chaque ligne contient un id composé de l’ID de l’hôtel et de la date, hotel_id, name, check_in, check_out et price. Utilisez-le pour repérer les nuits les moins chères, comparer en graphique les prix du week-end et de la semaine, ou alimenter un rapport de comparaison tarifaire. Chaque requête coûte 4 crédits ($0,02), quel que soit le nombre de dates. Documentation : Hotel Price Tracker.
Un workflow simple pour un panel concurrentiel
- Recherchez la destination une fois avec
sort_by: "most_reviewed"et choisissez votre panel concurrentiel parmi les résultats. - Récupérez Hotel Details pour chaque hôtel afin de comparer équipements, scores de localisation, thèmes des avis et offres des sites de réservation.
- Lancez Hotel Price Tracker pour chaque hôtel selon un calendrier et stockez chaque ligne avec son
collected_at.
Pour un panel de 10 hôtels choisis dans une recherche par défaut de 18 hôtels, une exécution représente 2,7 crédits pour la recherche, 20 crédits pour les fiches détaillées et 40 crédits pour les calendriers de prix : 62,7 crédits, soit environ $0,31. Les prix changent : considérez chaque exécution comme un instantané. Pour les données d’établissements locaux, comme les lieux et les avis sur Google Maps, consultez les API de scraping Google Maps.
FAQ
Qu’est-ce que l’API Google Hotels ?
Un ensemble d’endpoints SocQ qui renvoient les données de Google Hotels sous forme de lignes structurées : les résultats de recherche d’une destination, la fiche complète d’un hôtel et un calendrier de prix par nuit. Ce sont des endpoints SocQ, pas un produit officiel de Google.
Où obtenir un hotel_id ?
Dans le champ id des résultats de recherche Google Hotels. La même valeur fonctionne pour Hotel Details et Hotel Price Tracker.
À quelles dates correspondent les prix ?
Si vous envoyez check_in et check_out (YYYY-MM-DD, jusqu’à 30 nuits), les prix portent sur ce séjour. Sans eux, la recherche et les fiches détaillées indiquent le prix d’une nuit à partir de demain, et le suivi des prix commence son calendrier demain.
Puis-je obtenir les prix dans une autre devise ?
Oui. Envoyez un currency à trois lettres comme EUR. Chaque objet de prix contient amount, currency et une chaîne formatted comme USD 176.
Suis-je facturé pour un hotel_id invalide ?
Oui. Hotel Details ne renvoie aucune ligne pour un hotel_id inconnu et facture tout de même 2 crédits : vérifiez donc d’abord les ID à partir d’une recherche récente.
GOOGLE HOTELS API
Tester le workflow avec une URL publique Google Hotels
Envoyez des entrées publiques et recevez des enregistrements normalisés, avec un contexte de source traçable.
Découvrir les API Google Hotels