Retour aux API
Données Google Hotels

Google Hotels Data APIs

Recherchez des hôtels par destination, ouvrez la fiche complète de n’importe quel hôtel sur Google Hotels et récupérez son calendrier de prix par nuit, le tout relié par un même identifiant.

API Google Hotels disponibles

Commencez par Google Hotels API pour trouver des hôtels et leur identifiant, puis utilisez Google Hotel Details API pour la fiche et les offres d’un hôtel, ou Hotel Price Tracker API pour ses prix par date d’arrivée.

Quelles données Google Hotels pouvez-vous récupérer ?

Chaque ligne décrit un hôtel ou une nuit, avec des prix dans la devise choisie et un identifiant d’hôtel qui relie les trois API.

Listes d’hôtels avec prix

Nom, rang, prix par nuit le plus bas à vos dates, indicateur d’emplacement sponsorisé et lien vers la page de l’hôtel sur Google Hotels.

Notes et avis des voyageurs

Étoiles, note moyenne des voyageurs de 1 à 5, nombre d’avis, part de chaque note en étoiles et mentions positives et négatives par thème.

Offres par site de réservation

Prix par nuit et lien de réservation de chaque vendeur, avec repérage du site officiel, des offres sponsorisées et de l’annulation gratuite.

Emplacement et quartier

Adresse, coordonnées, nom du quartier et notes de 1 à 5 pour les loisirs, les restaurants, les transports et l’accès à l’aéroport.

Calendrier des prix par nuit

Le prix le plus bas pour chaque date d’arrivée d’un hôtel, généralement sur les 6 à 8 semaines à venir.

Quelle API Google Hotels choisir

Les trois API partagent le même identifiant d’hôtel : un résultat de recherche alimente directement une requête de fiche ou de calendrier.

APIPoint de départCe que vous obtenez
Google Hotels APIUne destination ou un nom d’hôtel dans queryJusqu’à 140 hôtels avec prix par nuit, étoiles, note, nombre d’avis, coordonnées et identifiant
Google Hotel Details APIUn hotel_idUne ligne avec coordonnées, équipements, notes du quartier, répartition des notes, thèmes d’avis et offres par site
Hotel Price Tracker APIUn hotel_idUne ligne par date d’arrivée avec le prix le plus bas de la nuit, en général sur 6 à 8 semaines

Fonctionnement de l’API Google Hotels

Les trois API suivent le même flux de tâches asynchrones.

  1. 1. Trouver des hôtels

    Envoyez une destination en POST à /v1/google-hotels/search et conservez l’id des hôtels à suivre.

  2. 2. Approfondir

    Envoyez un hotel_id à /v1/google-hotels/hotel-details pour la fiche et les offres, ou à /v1/google-hotels/hotel-prices pour le calendrier des prix.

  3. 3. Lire les résultats

    Interrogez GET /v1/tasks/{task_id} jusqu’à ce que status vaille succeeded, puis lisez les lignes de results.items.

Rechercher des hôtels dans une destination

Authentifiez-vous avec votre clé API SocQ et envoyez une destination. Chaque hôtel renvoyé coûte 0,15 crédit.

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}'

# Poll GET /v1/tasks/{task_id}
# Read the hotels in results.items

Cas d’usage courants de l’API Google Hotels

Repères de prix par destination

Comparez les prix par nuit selon les étoiles et la note entre plusieurs villes pour les mêmes dates.

Contrôle de la parité tarifaire

Comparez le tarif officiel d’un hôtel aux offres des agences de voyage en ligne pour le même séjour.

Veille concurrentielle

Suivez côte à côte les calendriers de prix, la répartition des notes et les thèmes d’avis d’hôtels voisins.

Contenus de voyage et fiches hôtel

Complétez vos fiches avec adresse, équipements, horaires d’arrivée, photos et notes du quartier.

Préparation de voyage

Repérez les dates d’arrivée les moins chères des semaines à venir avant de réserver.

Règles de requête et tarifs

Ces règles s’appliquent aux trois API Google Hotels.

  • Indiquez check_in et check_out ensemble, au format YYYY-MM-DD à partir d’aujourd’hui, pour un séjour de 30 nuits au plus ; sans ces dates, les prix portent sur une nuit à partir de demain.
  • Renseignez currency avec un code à trois lettres comme USD ou EUR pour que les prix restent comparables d’une requête à l’autre.
  • Google Hotels API renvoie de 1 à 140 hôtels par requête, 18 par défaut, et coûte 0,15 crédit par hôtel renvoyé.
  • Google Hotel Details API prend un hotel_id issu d’une recherche et coûte 2 crédits par requête.
  • Hotel Price Tracker API prend un hotel_id et coûte 4 crédits par requête pour le calendrier complet.

Questions fréquentes sur l’API Google Hotels

Qu’est-ce que Google Hotels API ?

Google Hotels API recherche des hôtels sur Google Hotels par destination et renvoie leurs prix par nuit à vos dates, leurs étoiles, la note des voyageurs, le nombre d’avis, les coordonnées et un identifiant pour les requêtes suivantes.

Quelles API Google Hotels sont disponibles ?

Google Hotels API pour la recherche, Google Hotel Details API pour la fiche et les offres par site d’un hôtel, et Hotel Price Tracker API pour ses prix par date d’arrivée.

D’où vient le hotel_id ?

Chaque ligne de Google Hotels API contient l’identifiant de l’hôtel dans le champ id. Passez cette valeur dans hotel_id aux API de fiche et de calendrier.

À quelles dates correspondent les prix ?

La recherche et la fiche utilisent vos dates check_in et check_out, jusqu’à 30 nuits, ou une nuit à partir de demain sans dates. Le calendrier liste une nuit par date d’arrivée sur environ 6 à 8 semaines.

Comment les requêtes Google Hotels sont-elles facturées ?

La recherche coûte 0,15 crédit par hôtel renvoyé, la fiche hôtel 2 crédits par requête et le calendrier des prix 4 crédits par requête.

Réunissez dans un même workflow les profils publics, les contenus et les données d’engagement de différentes plateformes pour suivre des marques, des créateurs et des sujets, et mener plus efficacement une veille et des analyses multiplateformes.

Brand Monitoring API

Trouvez les pages web qui citent une marque, un produit ou un sujet, notez chacune selon le sentiment et l’émotion, et résumez la façon dont le web en parle.

AI Search API

Suivez comment AI Overviews, ChatGPT et Google AI Mode répondent aux questions de votre marché : les réponses qui citent votre marque, votre niveau de visibilité, et les domaines et pages qu’ils citent.

Instagram API

Recherchez ou trouvez des profils publics et collectez enregistrements de listes d’abonnés, relations d’abonnement, publications publiées, publications où un profil est identifié, résultats par hashtag, Reels, transcriptions, commentaires, nombres de comptes, indicateurs d’engagement et métadonnées de médias dans un seul workflow asynchrone.

TikTok API

Collectez des profils TikTok publics pris en charge, les métadonnées de vidéos directes, les commentaires de premier niveau, des résultats de recherche de vidéos et les vidéos de hashtags précis dans un seul flux asynchrone normalisé.

YouTube API

Collectez les profils de chaînes YouTube publics pris en charge, les détails de vidéos, les vidéos de chaînes, les commentaires, les Shorts, les résultats par mot-clé et par hashtag, ainsi que les transcriptions disponibles, dans un seul flux asynchrone normalisé.

Facebook API

Collectez des profils de Pages Facebook publiques, des publications, des publications de groupes, des commentaires, des événements correspondant à un mot-clé et les transcriptions vidéo disponibles, avec des champs normalisés d’identité, de contenu, de source, de format, de lieu, de médias, de réactions, de participation et d’engagement.