Guía para agentes de IA

API de enlaces de reseñas de Google para agentes de IA

Convierte una URL de Google Maps en un enlace directo de reseña. No requiere registro ni clave de API de Google.

  1. Solicitud

    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. Respuesta 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

Busca la URL correcta de Maps

  1. Abre la ubicación exacta del negocio en Google Maps.
  2. Comprueba la sucursal y la dirección y selecciona Compartir.
  3. Copia el enlace y envíalo como maps_url.

Si la sucursal no está clara, pida al usuario la ubicación exacta. No adivine ni afirme que el resultado está verificado.

Solicitud

Envía un objeto JSON al endpoint. No se aceptan nombres de negocios ni Place IDs sueltos.

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"}'

Respuesta

verification siempre es not_verified. Comprueba la ubicación antes de entregar el enlace.

Referencia de la API →

Errores y solución

Una respuesta 429 generada en el borde puede no incluir JSON ni Retry-After. Espera al menos 60 segundos y aumenta la espera en cada reintento.

Errores y solución →

Uso de datos

Las solicitudes correctas registran el identificador del lugar, el idioma, la hora y la ubicación aproximada del negocio, si está disponible. Las URL cortas resueltas se guardan en caché durante 24 horas.