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.
POST /api/v2/reviews
Lisez jusqu’à 10 avis publics pour un lieu par page. Triez par pertinence, plus récents, meilleure note ou plus basse note.
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.
{
"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
Demandez une page ciblée pour un lieu, puis choisissez l’ordre des avis adapté à votre recherche.
| Champ | Signification |
|---|---|
| fid · requis | Un 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 1 | Une page numérotée positive. Ne l’augmentez que lorsque la réponse précédente a next: true. |
| sort_by · par défaut 1 | 1 = 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
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.
| Champ | Signification |
|---|---|
| id | L’identifiant de l’avis source, lorsqu’il est disponible. |
| rate / comment | La 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 / timestamp | La date relative affichée et une date calendaire au format M/D/YYYY. Une date indisponible est une chaîne vide. |
| name / author_url / avatar | Nom d’affichage de l’auteur, URL du profil contributeur et URL d’avatar disponibles. |
| photos | Une chaîne vide sans pièces jointes. Plusieurs URL de photos sont séparées par des sauts de ligne. |
| review_url | Un lien vers l’avis source, lorsqu’il est disponible. |
| next / total / params | Si 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
Utilisez le flag next renvoyé pour décider si votre workflow a besoin d’une autre requête.
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.
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.
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
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.
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.
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
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.
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é.
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.
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.
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é.
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.
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.
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
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.