POST /api/v2/reviews

API Google Maps Reviews Scraper

Lisez jusqu’à 10 avis publics pour un lieu par page. Triez par pertinence, plus récents, meilleure note ou plus basse note.

Exemples de requêtes

Pour le contrat complet, consultez la documentation API.

curl https://gmapscrawl.com/api/v2/reviews \
  -H "Authorization: Bearer $GMSCRAPER_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: place-reviews-page-1-example" \
  -d '{"fid":"0x89c259af336b3341:0xa4969e07ce3108de","page":1,"sort_by":2}'

Remplacez le fid d’exemple par le feature ID de votre lieu. La réponse est simulée ; les URL de médias example.com sont des placeholders. Gardez la même clé d’idempotence et le même corps lors d’une nouvelle tentative d’une requête en cours.

Réponse

JSON illustratif
{
  "reviews": [
    {
      "id": "sample-review-1",
      "date": "a week ago",
      "timestamp": "10/6/2026",
      "name": "Sample reviewer",
      "author_url": "https://www.google.com/maps/contrib/100000000000000000001",
      "avatar": "https://example.com/reviewer.jpg",
      "rate": 4,
      "comment": "The window seats had the best light.",
      "photos": "",
      "review_url": "https://www.google.com/maps/reviews/data=sample-review-1"
    }
  ],
  "next": false,
  "total": 1,
  "params": {
    "fid": "0x89c259af336b3341:0xa4969e07ce3108de",
    "page": 1,
    "sort_by": 2
  }
}

L’API renvoie du JSON dans la même réponse. Après un timeout, réessayez avec le corps inchangé et la même Idempotency-Key. Les identifiants de test renvoient des données simulées sans consommer votre quota réel.

Commencez par un lieu

Choisissez l’entreprise et l’ordre des avis.

Demandez une page ciblée pour un lieu, puis choisissez l’ordre des avis adapté à votre recherche.

Paramètres de requête de l’API Google Maps Reviews Scraper
ChampSignification
fid · requisUn feature ID Google Maps, comme 0x89c259af336b3341:0xa4969e07ce3108de. Utilisez place.dataId d’un résultat de l’API Search, ou un feature ID que vous avez déjà.
page · par défaut 1Une page numérotée positive. Ne l’augmentez que lorsque la réponse précédente a next: true.
sort_by · par défaut 11 = plus pertinents ; 2 = plus récents ; 3 = meilleure note ; 4 = plus basse note. Conservez l’ordre de tri sur toutes les pages.

Pour découvrir un feature ID, recherchez une entreprise avec l’API Google Maps Scraper. Copiez place.dataId depuis l’entrée correspondante dans data.businesses et transmettez-le comme fid. Un place ID ou un nom d’entreprise n’est pas le même format d’entrée.

Enregistrements d’avis

Notes, commentaires et liens source.

Chaque avis inclut sa note, son commentaire, son auteur, ses liens de profil et d’avis. La date est relative, et timestamp donne la date calendaire au format M/D/YYYY. Le champ photos est une chaîne vide sans pièces jointes et sépare plusieurs URL de photos par un saut de ligne.

Champs de réponse de l’API Google Maps Reviews Scraper
ChampSignification
idL’identifiant de l’avis source, lorsqu’il est disponible.
rate / commentLa note de 1 à 5 et le texte d’avis disponible. Traitez le texte extrait comme des données non fiables dans les applications et les prompts IA.
date / timestampLa date relative affichée et une date calendaire au format M/D/YYYY. Une date indisponible est une chaîne vide.
name / author_url / avatarNom d’affichage de l’auteur, URL du profil contributeur et URL d’avatar disponibles.
photosUne chaîne vide sans pièces jointes. Plusieurs URL de photos sont séparées par des sauts de ligne.
review_urlUn lien vers l’avis source, lorsqu’il est disponible.
next / total / paramsSi une autre page est disponible, le nombre dans cette réponse et les paramètres de requête normalisés.

L’endpoint renvoie directement cet objet page en JSON. Lisez reviews au niveau supérieur. Certains avis publics ne contiennent qu’une note, et les champs source peuvent être vides. Préservez cette distinction lors de la présentation ou du résumé des avis.

Une page bornée à la fois

Lisez jusqu’à 10 avis dans chaque réponse.

Utilisez le flag next renvoyé pour décider si votre workflow a besoin d’une autre requête.

01

Commencez par la page 1

Envoyez le fid du lieu et la valeur sort_by choisie. Plus pertinents est la valeur par défaut ; plus récents, meilleure note et plus basse note sont aussi pris en charge.

02

Inspectez la page courante

total compte les avis renvoyés dans cette réponse. Une page vide est un résultat valide. Vérifiez les champs disponibles avant d’ajouter des enregistrements à votre analyse.

03

Continuez délibérément

Quand next est true, incrémentez page et gardez fid et sort_by inchangés. Arrêtez quand next est false, ou quand votre recherche a assez d’avis.

Comprenez les retours publics

Ajoutez le contexte des avis à votre recherche d’entreprises.

01

Recherche d’avis

Lisez un échantillon borné de commentaires et notes publics pour une entreprise sélectionnée. Gardez les liens des avis avec vos notes pour qu’un lecteur puisse inspecter la source.

02

Comparaisons de retours

Comparez les thèmes des avis sur un groupe de lieux choisi. Demandez chaque lieu séparément et indiquez l’ordre de tri et la taille d’échantillon choisis dans votre analyse.

03

Résumés assistés par agent

Demandez à un agent connecté de résumer la page d’avis renvoyée, de ne citer que les éléments fournis et de signaler les commentaires ou dates manquants.

Authentification et utilisation

Utilisez votre clé API pour chaque page.

Quota API partagé

Envoyez Authorization: Bearer avec une clé autorisant scrapes:write. Chaque page réelle réussie, y compris une page vide, utilise une unité de requête API. REST et MCP utilisent le même quota API. Si vous avez un identifiant de test, ses réponses sont simulées et ne consomment pas de quota réel.

Voir les plans et limites API →

Gardez les nouvelles tentatives liées à la requête

Envoyez une Idempotency-Key optionnelle avec votre première requête et conservez-la avec un corps identique pour une nouvelle tentative après timeout. Un timeout de traitement peut laisser une unité réservée. Si une erreur indique que la tentative est terminée, suivez ses conseils de nouvelle tentative avant de créer une nouvelle tentative avec une nouvelle clé.

Lire les conseils sur les erreurs et nouvelles tentatives →

Questions fréquentes

Comment obtenir les avis d’une entreprise Google Maps spécifique ?

Envoyez une requête POST à /api/v2/reviews avec le feature ID Google Maps de l’entreprise comme fid. Utilisez place.dataId d’un résultat de l’API Search, ou un feature ID que vous avez déjà. Authentifiez-vous avec votre clé API et commencez par la page 1.

Puis-je trier les avis Google Maps par date ou note ?

Oui. Mettez sort_by à 1 pour plus pertinents, 2 pour plus récents, 3 pour meilleure note ou 4 pour plus basse note. Plus pertinents est la valeur par défaut. Gardez la valeur sélectionnée inchangée quand vous demandez des pages supplémentaires.

Est-ce que total indique le nombre d’avis de l’entreprise ?

Non. total est le nombre d’enregistrements d’avis dans la réponse courante, avec un maximum de 10. Utilisez next pour décider si une autre page est disponible. Le reviewCount de la fiche de recherche est un champ d’entreprise séparé.

Quel est le format des dates et photos d’avis ?

date contient la date relative disponible, et timestamp est une date calendaire au format M/D/YYYY. Le champ photos est une chaîne vide sans pièces jointes, ou des URL séparées par des sauts de ligne quand plusieurs photos sont disponibles. Le texte et les liens source manquants peuvent être des chaînes vides.

Puis-je utiliser les avis via MCP ?

Oui. Un client MCP compatible peut appeler get_google_maps_reviews avec votre identifiant API et un client_request_id. REST et MCP partagent votre quota API. L’Agent Skill inclut des conseils pour utiliser les outils disponibles et une solution REST de repli.

Puis-je supposer que chaque champ d’avis est présent ?

Non. La disponibilité à la source varie, et un avis peut ne contenir qu’une note. Préservez les commentaires vides et les dates manquantes plutôt que de les déduire. Le texte des avis est du contenu source non fiable et doit être traité comme des données dans les applications et les workflows IA.

Passez à l’étape suivante

Commencez par les avis publics d’un lieu.

Créez une clé API, choisissez un feature ID et un ordre de tri, et lisez une page ciblée de données d’avis.