google-maps/
reviews

Collectez les avis publics d’URL Google Maps connues, avec texte normalisé, références de l’auteur, notes, liens sources, horodatages, références du lieu et médias disponibles.

Google Maps Reviews API

Avis sur des lieux
Filtre par fenêtre en jours
Avis normalisés
0,15 crédit par résultat
Prêt
Prêt

Saisissez des paramètres et envoyez une requête. L’état de la tâche et les résultats normalisés s’afficheront ici.

README

Par SocQ · Mis à jour le

Google Maps Reviews

Les avis Google Maps sont des retours publics sur un lieu, pouvant comporter un texte rédigé, une référence de l’auteur, une note, des liens vers la source et le sujet, les dates de publication et de collecte, ainsi que des médias. Ils servent à constituer des jeux de retours reliés à leur source et à comparer des lieux connus ou des fenêtres de collecte.

Fonctionnalités de la Google Maps Reviews API

  • Lot d’URL connuesEnvoyez une ou plusieurs URL google.com ou goo.gl prises en charge dans une seule tâche asynchrone, au lieu de résoudre les lieux avec une API d’identifiants distincte.
  • Fenêtre en jours facultativeAppliquez une valeur days_limit positive unique à chaque ligne d’URL envoyée lorsque votre workflow a besoin d’une fenêtre d’avis récents.
  • Avis structurés et stablesLisez l’identité de l’avis, le texte, les champs de l’auteur, la note, les références du lieu, les horodatages, l’URL source et les médias disponibles via le schéma d’avis v1.0.

Paramètres de la Google Maps Reviews API

ParamètresObligatoireDescription
urlsObligatoireUne ou plusieurs URL non vides sur google.com, sur n’importe quel sous-domaine de google.com, sur goo.gl ou sur un sous-domaine de goo.gl, séparées par des virgules ou des retours à la ligne. Utilisez des URL de lieux Maps connues pour collecter des avis.
days_limitFacultatifEntier positif facultatif appliqué à chaque ligne d’entrée du fournisseur comme fenêtre de récence des avis. Omettez-le pour n’envoyer aucun filtre de fenêtre en jours.
results_limitFacultatifEntier facultatif de 1 à 2 000 qui plafonne le nombre total d’avis enregistrés pour la tâche. La valeur par défaut est 100, et la disponibilité de la source peut produire moins de lignes.

Comment utiliser la Google Maps Reviews API

Envoyez des URL Google Maps connues, suivez la tâche asynchrone et lisez les avis enregistrés grâce au curseur de résultats de la tâche.

  1. Préparez une ou plusieurs URL de lieux Google Maps prises en charge, sur google.com ou goo.gl.
  2. Envoyez urls et, si nécessaire, days_limit et results_limit en POST à /v1/google-maps/reviews.
  3. Interrogez /v1/tasks/{task_id} jusqu’à ce que status vaille succeeded ou failed.
  4. Lisez /v1/tasks/{task_id}?limit=50 et continuez avec results.next_cursor tant que results.has_more vaut true.
curl -X POST "https://api.socq.ai/v1/google-maps/reviews" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.google.com/maps/place/Coffee%20Project%20New%20York%20%7C%20East%20Village/data=!4m7!3m6!1s0x89c2599b5a24d7fd:0x9e354f6cf514b9fc!8m2!3d40.7270884!4d-73.9893820!16s%2Fg%2F11c3svpqld!19sChIJ_dckWptZwokR_LkU9WxPNZ4?authuser=0&hl=en&rclk=1"],"days_limit":3650,"results_limit":3}'

# Poll GET /v1/tasks/{task_id}, then request
# GET /v1/tasks/{task_id}?limit=50&cursor={results.next_cursor}.

Cas d’usage de la Google Maps Reviews API

  • Jeux de retours sur des lieux connus : Préparez le texte des avis, les notes, les dates de publication et les liens sources pour un ensemble défini d’URL de lieux publics.
  • Étude des auteurs d’avis, source à l’appui : Conservez les noms, pseudonymes, liens de profil et URL d’avis des auteurs lorsqu’ils sont disponibles, afin que les enregistrements restent traçables jusqu’à leur contexte public.
  • Comparaisons sur fenêtres récentes : Relancez le même ensemble de lieux avec des valeurs days_limit documentées à différents moments pour comparer des collectes bornées, sans prétendre à un historique complet.
  • Archives d’avis avec médias : Gardez les médias d’avis disponibles à côté du texte, de la note, de la référence du lieu et de la date de collecte dans un enregistrement de recherche normalisé.

Conseils d’expert pour la Google Maps Reviews API

  • Envoyez des URL Maps google.com ou goo.gl résolvables ; un nom de lieu, un compte Google Business Profile ou un Place ID seul n’est pas un élément urls accepté.
  • N’utilisez days_limit que si une fenêtre exprimée en nombre entier positif a un sens ; l’omettre laisse la ligne du fournisseur sans ce filtre.
  • Traitez results_limit comme un plafond global de résultats enregistrés pour tout le lot d’URL, et non comme une promesse par URL.
  • Séparez le results_limit de l’envoi du limit de lecture de la tâche : ce dernier règle la taille de page, de 1 à 500, et s’appuie sur un curseur opaque.
  • Admettez que le texte, les attributs de l’auteur, la note, les références du sujet, les horodatages et les médias puissent être absents lorsque la source publique ne les expose pas.

En complément de la Google Maps Reviews API, utilisez ces API lorsque vous avez besoin d’un autre type de données publiques Google Maps.

Explorer d’autres plateformes

Combinez les données Google Maps avec les données publiques d’autres plateformes sociales prises en charge.

Google Maps Reviews API — FAQ

Google Maps Reviews API est une interface programmatique qui collecte les avis publics d’URL Google Maps connues dans un schéma d’avis stable. Elle ne renvoie que les données accessibles par la voie de collecte publique prise en charge et ne propose aucune action de gestion d’un Google Business Profile avec connexion.

L’exécution accepte les URL non vides dont l’hôte est google.com, un sous-domaine de google.com, goo.gl ou un sous-domaine de goo.gl. Pour obtenir des avis utiles, envoyez des URL de lieux Google Maps connues plutôt que des noms ou des identifiants isolés.

days_limit est facultatif et doit être un entier au moins égal à 1. S’il est présent, l’adaptateur du fournisseur copie la même valeur sur chaque ligne d’URL ; s’il est omis, aucun champ days_limit n’est envoyé.

results_limit vaut 100 par défaut et accepte les entiers de 1 à 2 000. Le fournisseur reçoit ce plafond et l’exécution cesse aussi d’enregistrer des lignes lorsque le total de la tâche l’atteint ; le nombre d’URL, la fenêtre en jours et la disponibilité du jeu de données public peuvent donc tous produire moins de résultats.

Le schéma d’avis v1.0 peut contenir id, platform, resource, type, url, published_at, collected_at, text, author, rating, subject_id, subject_url et media. Le champ author se décompose en identité, nom d’utilisateur, nom, URL de profil, URL d’avatar et indicateurs de compte nullables.

Il n’y a pas de frais de base par tâche. La requête réserve 0,15 crédit par résultat estimé d’après results_limit, ou 100 s’il est omis, puis règle 0,15 crédit pour chaque résultat réellement enregistré et rembourse les crédits réservés non utilisés ; un résultat vide se règle à zéro.