Referencia de la API

API de enlaces de reseñas de Google

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

Entrada compatible

  • Una URL completa de Google Maps para un lugar concreto
  • Un enlace para compartir de maps.app.goo.gl
  • Un enlace antiguo de goo.gl/maps

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

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

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

Errores y solución

  • invalid_request (400)
    Envía JSON válido con una maps_url no vacía.
  • unsupported_url (422)
    Usa el enlace Compartir de un negocio concreto en Google Maps.
  • unsafe_redirect (422)
    Usa un enlace que redirija solo a Google Maps.
  • upstream_unresolved (502)
    Abre el enlace corto y envía la URL final completa de Maps.
  • upstream_timeout (504)
    Espera, reintenta una vez o envía la URL final completa de Maps.

Límites de uso

El límite anónimo es de aproximadamente 20 solicitudes por minuto y por IP. Las IP compartidas por agentes comparten este límite.

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

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.

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.

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.