Riferimento API

API per link alle recensioni Google

Converti un URL di Google Maps in un link diretto alla recensione. Non servono registrazione o chiave API Google.

  1. Richiesta

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

Input supportato

  • Un URL Google Maps completo per un luogo specifico
  • Un link Condividi maps.app.goo.gl
  • Un vecchio link goo.gl/maps

Richiesta

Invia un oggetto JSON all’endpoint. Nomi di attività e Place ID senza URL non sono accettati.

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

Risposta

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

verification è sempre not_verified. Controlla la sede prima di fornire il link.

Errori e soluzioni

  • invalid_request (400)
    Invia JSON valido con una maps_url non vuota.
  • unsupported_url (422)
    Usa il link Condividi di un’attività specifica in Google Maps.
  • unsafe_redirect (422)
    Usa un link che reindirizza solo a Google Maps.
  • upstream_unresolved (502)
    Apri il link breve e invia l’URL Maps finale completo.
  • upstream_timeout (504)
    Attendi, riprova una volta o invia l’URL Maps finale completo.

Limiti di utilizzo

Il limite anonimo è circa 20 richieste al minuto per IP. Gli agenti con lo stesso IP condividono il limite.

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

Una risposta 429 generata all’edge può non avere JSON o Retry-After. Attendi almeno 60 secondi e aumenta il ritardo nei tentativi successivi.

Trova l’URL Maps corretto

  1. Apri la sede esatta in Google Maps.
  2. Controlla filiale e indirizzo, poi seleziona Condividi.
  3. Copia il link e invialo come maps_url.

Uso dei dati

Le chiamate riuscite registrano l’identificativo del luogo, la lingua, l’ora e la posizione approssimativa dell’attività, se disponibile. Gli URL brevi risolti vengono memorizzati nella cache per 24 ore.