Si vous cherchez une API Google Reviews, vous ne voulez probablement pas une énième explication générique sur les API. Vous voulez des données d’avis dans un tableau où vous pouvez les filtrer, les joindre, les visualiser et les partager avec les personnes qui prennent les décisions.
Cette demande revient souvent chez les agences, les équipes de franchises et les opérateurs multisites. Quelqu’un a besoin d’un tableau de bord Tableau, d’un script Python, d’un export CSV hebdomadaire ou d’un moyen fiable de récupérer les avis de plusieurs établissements Google sans ouvrir chaque profil manuellement.
La réponse courte est oui : vous pouvez récupérer les avis avec les API officielles Business Profile de Google lorsque le projet et l’utilisateur disposent de l’accès requis. Le workflow concret dépend de votre objectif : développer directement sur Google, utiliser Localith comme couche opérationnelle connectée ou exporter un CSV propre pour un outil de business intelligence.
Ce guide couvre ces trois voies réalistes et montre comment structurer les données d’avis Google pour Tableau, Power BI, Looker Studio, les tableurs ou Python.
Transformez l'activité des avis Google en rapports exploitables par votre équipe. Utilisez Localith pour comparer les établissements, exporter des rapports d'avis, suivre l'activité de réponse et faire ressortir les tendances derrière les changements de note.
Démarrer l'essai gratuitExiste-t-il une API Google Reviews ?
Oui, mais le nom prête à confusion. Google ne présente pas l’accès aux avis comme un produit distinct appelé API Google Reviews. Pour les avis sur les profils que vous détenez ou gérez, la voie officielle est l’API Google Business Profile.
La documentation de Google sur les données d’avis couvre la liste des avis, la récupération d’un avis, l’obtention des avis de plusieurs établissements, la réponse et la suppression d’une réponse d’entreprise. Si votre équipe a encore besoin de l’approbation du projet et de la configuration OAuth, commencez par ce guide d’accès à l’API Google Business Profile.
Pour les informations publiques sur les lieux, les développeurs envisagent parfois l’API Places ou des services de données tiers. Ces produits servent des cas d’usage différents. Ils ne remplacent pas l’export de l’historique complet des avis des Business Profiles que votre organisation gère.
API Google Business Profile vs API Places vs Localith
Commencez par la question de la propriété et du reporting : travaillez-vous avec des établissements que votre organisation gère, recherchez-vous des informations publiques sur les lieux ou créez-vous des rapports récurrents pour des profils connectés ?
| Option | Idéal pour | Accès aux avis | Limite principale |
|---|---|---|---|
| Rapports et workflows Localith | Reporting multisite et opérations sur les avis | Données d’avis GBP connectées, analyses, rapports PDF/CSV et intégrations de workflow | Les profils doivent être connectés et synchronisés dans Localith |
| API Google Places | Recherche de lieux publics et détails des lieux | Données publiques sur les lieux dans les règles de l’endpoint sélectionné | Pas un export complet des avis d’un profil détenu |
| API Google Business Profile | Établissements détenus ou gérés | Avis et réponses de l’entreprise pour les profils accessibles | Nécessite l’approbation de l’API, OAuth, des permissions sur le profil et de l’ingénierie |
Quelles données d’avis pouvez-vous récupérer ?
Pour le reporting, la forme des données compte plus que l’étiquette de l’API. Un bon export doit contenir des faits ligne par ligne que les analystes peuvent normaliser :
- Identifiant de l’avis
- Nom affiché de l’auteur
- Note en étoiles
- Texte de l’avis
- Date de création ou de mise à jour
- Établissement et identifiant d’établissement stable
- Texte de la réponse de l’entreprise et date de réponse, lorsqu’une réponse existe
- Note moyenne et nombre total d’avis pour l’établissement
La méthode de liste des avis de Google renvoie une collection d’avis paginée ainsi que la note moyenne et le nombre total d’avis de l’établissement. Les ressources d’avis individuelles exposent des champs tels que l’identifiant de l’avis, le commentaire, l’auteur, la note en étoiles, la date de création et la réponse.
Une fois les données centralisées, les équipes peuvent aussi rechercher les avis Google par mot-clé pour identifier les thèmes récurrents liés au produit, au service, au personnel ou à l’accessibilité.
Option 1 : exporter les données d’avis via Localith
Localith est la voie concrète lorsque la question métier est « Pouvons-nous obtenir chaque semaine des données d’avis multisites propres ? » plutôt que « Pouvons-nous maintenir une intégration d’API de plus ? ». Ses outils d’API Google Business Profile gérés gardent connectés les workflows d’avis, de fiches, de reporting et d’automatisation.
Le workflow est simple :
- Créez un compte Localith ou connectez-vous.
- Connectez les comptes et établissements Google Business Profile que vous gérez.
- Ouvrez la section de reporting.
- Sélectionnez la plage de dates, les établissements et le type de rapport d’avis.
- Téléchargez le rapport au format PDF ou CSV.
- Chargez le CSV dans votre tableur, votre entrepôt ou votre outil BI.
Les rapports d’avis Localith peuvent inclure des données d’avis brutes et des métriques de synthèse comme la répartition des étoiles, les groupes de sentiment, le total des avis, les réponses, la note moyenne et la date du dernier avis. Cela donne aux agences et aux équipes multisites un workflow de reporting d’avis en ligne reproductible, sans maintenir de code OAuth et de pagination.
Utiliser l’accès à l’API Localith et n8n pour des workflows récurrents
Pour les automatisations récurrentes, les équipes peuvent générer une clé API Localith et la connecter à n8n. Le node n8n de Localith prend en charge la récupération des avis, les opérations sur les fiches et les métriques de performance, qui peuvent alimenter Google Sheets, Airtable, Slack, l’e-mail ou d’autres outils de workflow.
Utilisez cette voie lorsque vous avez besoin d’une ingestion d’avis planifiée, d’alertes ou d’un workflow d’approbation, mais que vous ne voulez pas que chaque outil en aval s’authentifie directement auprès de Google.
Évitez la file d'attente de validation de l'API Google. Localith offre aux agences une couche GBP gérée pour les fiches, les avis, les métriques et la publication chez chaque client, sans projet Cloud, OAuth ni gestion des quotas.
Démarrer l'essai gratuitOption 2 : exporter les avis Google au format CSV pour Tableau
Si le besoin est un tableau de bord Tableau, vérifiez si un CSV résout le problème avant de consacrer du temps d’ingénierie à un build d’API. Pour de nombreux rapports mensuels ou hebdomadaires, c’est le cas.
Utilisez ce workflow :
- Exportez les données au niveau de l’avis au format CSV depuis Localith.
- Ouvrez Tableau et sélectionnez Fichier texte comme source de données.
- Choisissez l’export d’avis.
- Définissez le champ de la note comme un nombre et la date de l’avis comme une date.
- Créez un graphique de répartition des notes en comptant les avis par note.
- Ajoutez le nom de l’établissement ou son identifiant comme filtre.
- Créez une tendance mensuelle du volume d’avis et de la note moyenne.
- Ajoutez le statut de réponse ou le délai de réponse lorsque ces champs sont disponibles.
- Publiez le classeur et actualisez la source selon votre cadence de reporting.
Le CSV fonctionne particulièrement bien lorsque la cadence de reporting est quotidienne, hebdomadaire ou mensuelle plutôt qu’en temps réel. Il donne aussi aux analystes un fichier source visible qu’ils peuvent inspecter avant l’actualisation d’un tableau de bord.
Option 3 : récupérer les avis via l’API Google Business Profile
Choisissez la voie directe de l’API lorsque vous disposez de ressources d’ingénierie, que les profils se trouvent sous la bonne structure de compte et que votre application a besoin d’un contrôle total sur l’ingestion et le stockage.
L’endpoint de liste actuel est :
GET https://mybusiness.googleapis.com/v4/{parent=accounts/*/locations/*}/reviewsL’établissement doit être validé. La méthode renvoie jusqu’à 50 avis par page, prend en charge le tri et fournit nextPageToken lorsque d’autres pages existent. Elle nécessite un scope OAuth tel que https://www.googleapis.com/auth/business.manage.
Google fournit également une méthode par lot pour les établissements accessibles :
POST https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations:batchGetReviewsLes équipes qui gèrent les avis Google sur plusieurs établissements doivent résoudre la propriété du compte, l’accès aux établissements et les identifiants stables avant de concevoir le tableau de bord.
Exemple de workflow Python
Un workflow de production suit généralement ces étapes :
- Créez ou sélectionnez un projet Google Cloud approuvé pour l’accès à l’API Business Profile.
- Configurez OAuth avec le scope
business.manage. - Listez les comptes disponibles pour l’utilisateur connecté.
- Listez les établissements du compte sélectionné.
- Demandez les avis de chaque établissement.
- Suivez
nextPageTokenjusqu’à ce que chaque page soit collectée. - Normalisez chaque avis en une ligne.
- Enregistrez les lignes dans un CSV, BigQuery, un entrepôt ou une table d’ingestion BI.
La structure de pagination de base ressemble à ceci :
import requests
def fetch_reviews(access_token, location_name):
url = f"https://mybusiness.googleapis.com/v4/{location_name}/reviews"
params = {"pageSize": 50, "orderBy": "updateTime desc"}
headers = {"Authorization": f"Bearer {access_token}"}
reviews = []
while True:
response = requests.get(
url,
headers=headers,
params=params,
timeout=30,
)
response.raise_for_status()
payload = response.json()
reviews.extend(payload.get("reviews", []))
page_token = payload.get("nextPageToken")
if not page_token:
return reviews
params["pageToken"] = page_token
# location_name example: accounts/123/locations/456Considérez ceci comme un modèle d’intégration, pas comme un client de production complet. Une implémentation réelle a aussi besoin du rafraîchissement du jeton, de nouvelles tentatives avec backoff, de la découverte des comptes et des établissements, d’un stockage sécurisé des identifiants, de la journalisation et de la gestion des erreurs de permission.
Modèle de données d’avis recommandé pour la BI
Gardez le modèle délibérément simple : une ligne stable par avis et un identifiant stable par établissement.
| Champ | Type | Pourquoi c’est important |
|---|---|---|
review_id |
Texte | Déduplique les imports et les mises à jour |
location_id |
Texte | Joint les avis aux fiches, régions et clients |
location_name |
Texte | Fournit un filtre lisible dans le tableau de bord |
rating |
Nombre | Prend en charge les moyennes et la répartition des étoiles |
review_text |
Texte | Permet l’analyse des thèmes, du sentiment et qualitative |
review_date |
Date/heure | Prend en charge les tendances et les périodes de reporting |
reply_text |
Texte | Indique si l’entreprise a répondu |
reply_date |
Date/heure | Prend en charge le reporting des délais de réponse |
source |
Texte | Aide à combiner plusieurs plateformes d’avis |
Ne mélangez pas les lignes de synthèse par établissement et les lignes d’avis individuelles dans la même table. Gardez les faits d’avis dans une table et les instantanés au niveau de l’établissement dans une autre, puis joignez-les par location_id.
Que pouvez-vous créer avec les données d’avis Google exportées ?
C’est là que l’export prend tout son sens. Une fois que chaque avis se trouve dans une table normalisée unique, une petite équipe peut construire un reporting qui demandait auparavant un développeur. Voici les réalisations que les agences et les opérateurs multisites mettent en place le plus souvent, des plus simples aux plus complexes :
- Un tableau de bord des avis multisites. Une vue unique de la note moyenne, du volume d’avis et du taux de réponse par établissement, pour voir quelles agences décrochent avant le point mensuel.
- Rapports clients d’agence. Un rapport propre et reproductible par client montrant la tendance de la note, les nouveaux avis et le taux de réponse. Planifiez-le et arrêtez de reconstruire des présentations à la main.
- Alertes sur les avis négatifs. Une règle qui signale chaque nouvel avis 1 ou 2 étoiles par établissement, pour que le bon responsable en soit informé le jour même.
- Suivi du SLA de réponse. Le taux de réponse et le délai moyen de réponse par établissement, pour que « nous répondons à chaque avis » devienne un chiffre auquel vous pouvez tenir les équipes.
- Analyse du sentiment et des thèmes. Regroupez le texte des avis en thèmes comme le personnel, les temps d’attente, les prix et la propreté pour voir ce que les clients mentionnent réellement.
- Comparaisons de performance des établissements. Classez les établissements ou les régions les uns par rapport aux autres pour repérer les cas atypiques qui méritent un examen plus approfondi.
- Sauvegardes et archives des avis. Un enregistrement daté de chaque avis et réponse, ce qui compte lorsqu’un avis change ou disparaît.
Vous n’avez pas besoin de tout cela dès le premier jour. La plupart des équipes commencent par le tableau de bord et l’alerte sur les avis négatifs, puis ajoutent le reste une fois l’habitude de reporting installée.
Les données d’avis sont les plus utiles lorsqu’elles restent connectées aux opérations. Un tableau de bord peut révéler les avis sans réponse, tandis qu’un processus documenté explique comment répondre aux avis Google et qu’un workflow de réponse automatique aux avis Google traite les cas appropriés à grande échelle. Il peut aussi compléter le suivi du classement local lorsque vous voulez comparer les tendances des avis aux changements de visibilité plutôt que de traiter la réputation et la recherche locale comme des programmes séparés.
Créer un tableau de bord des avis Google dans Claude (sans code)
Si vous n’avez pas d’analyste ni de licence BI, il existe une voie plus rapide : connectez Localith à Claude et demandez le tableau de bord en langage naturel. Localith publie un connecteur Claude MCP en lecture seule qui permet à Claude de récupérer directement vos données d’avis Google connectées, ce qui vous épargne la configuration de l’API, les exports CSV et les formules de tableur.
C’est l’option la plus concrète pour les agences et les opérateurs qui veulent des réponses, pas de l’infrastructure. Voici le workflow complet :
- Dans Localith, connectez les établissements Google Business Profile que vous gérez.
- Dans Claude, ouvrez Paramètres, Connecteurs et ajoutez Localith. Vous pouvez parcourir le répertoire des connecteurs ou l’ajouter comme connecteur personnalisé.
- Posez à Claude une question en langage naturel, par exemple : « Récupère les avis des 90 derniers jours pour tous mes établissements et construis un tableau de bord avec la note moyenne, le volume d’avis et le taux de réponse par établissement. »
- Claude utilise le connecteur pour récupérer vos avis et métriques, puis construit un graphique ou un tableau que vous pouvez lire directement dans la conversation.
- Poursuivez dans la même conversation : « Quels sont les trois établissements avec le taux de réponse le plus bas ? » ou « Liste chaque avis 1 étoile du mois dernier avec l’établissement et la date. »
Comme le connecteur est en lecture seule, Claude peut lire et analyser vos données d’avis mais ne peut pas modifier les avis ni publier de réponses. Cela permet de le confier en toute sécurité à un membre junior de l’équipe. Lorsque vous voulez agir sur ce que vous trouvez, déplacez les réponses dans l’agent IA de réponse aux avis ou dans votre workflow d’avis habituel.
Pour un rapport récurrent, enregistrez le prompt et relancez-le chaque mois, ou alimentez les mêmes données dans un workflow Localith et n8n planifié. Dans tous les cas, le résultat est le même : une agence peut monter un tableau de bord d’avis fonctionnel en un après-midi, sans écrire une ligne de code.
Quand utiliser Google directement ou Localith ?
| Scénario | Meilleure voie |
|---|---|
| Application personnalisée avec accès approuvé à l’API Google | API Google Business Profile |
| Reporting d’avis multisites | Rapports Localith ou workflow API |
| Tableau de bord Tableau ou Power BI | Export CSV ou ingestion planifiée |
| Automatisation Slack, Sheets, Airtable ou e-mail | Localith avec n8n |
| Rapports d’avis prêts pour le client | Rapports PDF/CSV Localith |
| Travail opérationnel de réponse aux avis | Workflows d’avis Localith |
Utilisez Google directement lorsqu’une infrastructure personnalisée est l’exigence du produit et que votre équipe peut la prendre en charge. Utilisez Localith lorsque l’entreprise a besoin de reporting, d’exports, d’alertes et d’opérations sur les avis sans maintenir l’ensemble de la pile d’intégration Google.
Pour les équipes qui ont aussi besoin de gouverner les profils, le workflow plus large pour gérer plusieurs Google Business Profiles couvre la structure de compte, les permissions, les mises à jour en masse et les contrôles opérationnels.
Pièges courants de l’API Google Reviews
La plupart des échecs viennent d’hypothèses sur le workflow plutôt que de la syntaxe Python :
- Confondre l’API Places avec l’API Google Business Profile
- Demander les avis d’un profil auquel l’utilisateur OAuth ne peut pas accéder
- Tenter de lister les avis d’un établissement non validé
- Sauter la pagination et n’exporter que les 50 premiers avis
- Ne pas stocker un identifiant d’avis et un identifiant d’établissement stables
- Mélanger les données d’avis ligne par ligne avec les métriques agrégées
- Ignorer le rafraîchissement du jeton, les nouvelles tentatives et le comportement des quotas
- Supposer que chaque outil de reporting a besoin d’une API en temps réel
Le dernier risque est organisationnel : construire un tableau de bord sans désigner quiconque pour agir sur les données. Les exports d’avis doivent alimenter un processus clair de gestion de la réputation Google avec des responsables, des attentes de réponse, des règles d’escalade et un reporting récurrent.
Transformez les avis Google en reporting fiable
Un workflow d’API Google Reviews n’a de valeur que lorsqu’il donne à l’entreprise un moyen fiable d’agir sur les données d’avis. Le résultat doit montrer l’évolution de la note, le volume d’avis, les thèmes récurrents, les avis sans réponse et les cas atypiques au niveau de l’établissement.
Si vous disposez de ressources d’ingénierie et d’un accès approuvé à l’API Google Business Profile, vous pouvez construire ce pipeline directement. Si vous voulez aller plus vite, utilisez Localith pour connecter les profils, exporter les données d’avis, construire des workflows de reporting et garder l’analyse liée au même système où l’équipe gère les avis et la performance des établissements.
Avant de construire quoi que ce soit, vérifiez que votre équipe peut voir les avis Google liés à ses profils, accéder à chaque établissement requis et définir les décisions de reporting que le tableau de bord doit soutenir.
