API-Referenz

Google-Bewertungslink-API

Wandeln Sie eine Google-Maps-URL in einen direkten Bewertungslink um. Keine Registrierung und kein Google-API-Schlüssel erforderlich.

  1. Anfrage

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

Unterstützte Eingabe

  • Eine vollständige Google-Maps-URL für einen bestimmten Ort
  • Ein Share-Link von maps.app.goo.gl
  • Ein älterer Share-Link von goo.gl/maps

Anfrage

Senden Sie ein JSON-Objekt an den Endpunkt. Unternehmensnamen und einzelne Place IDs werden nicht akzeptiert.

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

Antwort

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

verification ist immer not_verified. Prüfen Sie den Standort, bevor Sie den Link weitergeben.

Fehler und Lösungen

  • invalid_request (400)
    Senden Sie gültiges JSON mit einer nicht leeren maps_url.
  • unsupported_url (422)
    Verwenden Sie den Share-Link eines bestimmten Unternehmens in Google Maps.
  • unsafe_redirect (422)
    Verwenden Sie einen Share-Link, der nur zu Google Maps weiterleitet.
  • upstream_unresolved (502)
    Öffnen Sie den Kurzlink und senden Sie die vollständige Maps-Ziel-URL.
  • upstream_timeout (504)
    Warten Sie, versuchen Sie es einmal erneut oder senden Sie die vollständige Maps-Ziel-URL.

Nutzungslimits

Das anonyme Limit beträgt ungefähr 20 Anfragen pro Minute und Client-IP. Gemeinsam genutzte Agent-IP-Adressen teilen dieses Kontingent.

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

Eine am Netzwerkrand erzeugte 429-Antwort kann keinen JSON-Inhalt und keinen Retry-After-Header haben. Warten Sie mindestens 60 Sekunden und erhöhen Sie danach die Wartezeit.

Die richtige Maps-URL finden

  1. Öffnen Sie den genauen Unternehmensstandort in Google Maps.
  2. Prüfen Sie Filialname und Adresse und wählen Sie Teilen.
  3. Kopieren Sie den Link und senden Sie ihn als maps_url.

Datennutzung

Erfolgreiche Aufrufe speichern die Ortskennung, Sprache, Uhrzeit und, sofern verfügbar, den ungefähren Geschäftsstandort. Aufgelöste Kurz-URLs werden 24 Stunden zwischengespeichert.