Référence de l’API

API de liens d’avis Google

Convertissez une URL Google Maps en lien direct d’avis. Aucune inscription ni clé API Google n’est requise.

  1. Requête

    application/json { "maps_url": "https://www.google.com/maps/place/PRODUCTMATE/data=!1s0x47b18f1cae867bab:0xb6f8b3a3753ba1a2!8m2" }
  2. POST /api/v1/google-review-link productmate.com

  3. Réponse 200

    application/json { "place_id": "ChIJq3uGrhyPsUcRoqE7daOz-LY", "review_url": "https://search.google.com/local/writereview?placeid=ChIJq3uGrhyPsUcRoqE7daOz-LY", "verification": "not_verified" }
POST/api/v1/google-review-link

Entrées acceptées

  • Une URL Google Maps complète pour un lieu précis
  • Un lien de partage maps.app.goo.gl
  • Un ancien lien de partage goo.gl/maps

Requête

Envoyez un objet JSON au point de terminaison. Les noms d’entreprise et les Place IDs seuls ne sont pas acceptés.

curl -X POST https://productmate.com/api/v1/google-review-link \
  -H "Content-Type: application/json" \
  -d '{"maps_url":"https://www.google.com/maps/place/PRODUCTMATE/data=!1s0x47b18f1cae867bab:0xb6f8b3a3753ba1a2!8m2"}'

Réponse

{
  "place_id": "ChIJq3uGrhyPsUcRoqE7daOz-LY",
  "review_url": "https://search.google.com/local/writereview?placeid=ChIJq3uGrhyPsUcRoqE7daOz-LY",
  "verification": "not_verified"
}

verification vaut toujours not_verified. Vérifiez le lieu avant de transmettre le lien.

Erreurs et solutions

  • invalid_request (400)
    Envoyez un JSON valide avec une maps_url non vide.
  • unsupported_url (422)
    Utilisez le lien de partage d’un établissement précis sur Google Maps.
  • unsafe_redirect (422)
    Utilisez un lien qui redirige uniquement vers Google Maps.
  • upstream_unresolved (502)
    Ouvrez le lien court et envoyez son URL Maps complète finale.
  • upstream_timeout (504)
    Attendez, réessayez une fois ou envoyez l’URL Maps complète finale.

Limites d’utilisation

La limite anonyme est d’environ 20 requêtes par minute et par IP. Les agents qui partagent une IP partagent cette limite.

Content-Length: 16 KiB
maps_url: 8 KiB
short_url_resolution_deadline: 10 s

Une réponse 429 générée en périphérie peut ne contenir ni JSON ni en-tête Retry-After. Attendez au moins 60 secondes, puis augmentez le délai.

Trouver la bonne URL Maps

  1. Ouvrez l’établissement exact dans Google Maps.
  2. Vérifiez l’agence et l’adresse, puis sélectionnez Partager.
  3. Copiez le lien et envoyez-le dans maps_url.

Utilisation des données

Les appels réussis enregistrent l’identifiant du lieu, la langue, l’heure et la position approximative de l’établissement, si disponible. Les URL courtes résolues sont mises en cache pendant 24 heures.