Guida per agenti IA

API per link alle recensioni Google per agenti IA

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

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.

Se la sede non è chiara, chiedi all’utente la posizione esatta. Non indovinare e non dichiarare che il risultato è verificato.

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

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

Riferimento API →

Errori e soluzioni

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

Errori e soluzioni →

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.