API-referentie

API voor Google-reviewlinks

Zet één Google Maps-URL om in een rechtstreekse reviewlink. Registratie en een Google API-sleutel zijn niet nodig.

  1. Aanvraag

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

Ondersteunde invoer

  • Een volledige Google Maps-URL voor een specifieke plaats
  • Een maps.app.goo.gl-deellink
  • Een oudere goo.gl/maps-deellink

Aanvraag

Stuur één JSON-object naar het endpoint. Bedrijfsnamen en losse Place ID's worden niet geaccepteerd.

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

Antwoord

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

verification is altijd not_verified. Controleer de locatie voordat u de link doorgeeft.

Fouten en herstel

  • invalid_request (400)
    Stuur geldige JSON met een niet-lege maps_url.
  • unsupported_url (422)
    Gebruik de deellink van een specifiek bedrijf in Google Maps.
  • unsafe_redirect (422)
    Gebruik een deellink die alleen naar Google Maps verwijst.
  • upstream_unresolved (502)
    Open de korte link en stuur de uiteindelijke volledige Maps-URL.
  • upstream_timeout (504)
    Wacht, probeer één keer opnieuw of stuur de uiteindelijke volledige Maps-URL.

Gebruikslimieten

De anonieme limiet is ongeveer 20 aanvragen per minuut per IP-adres. Agenten met hetzelfde IP-adres delen deze limiet.

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

Een 429-antwoord van de edge bevat mogelijk geen JSON of Retry-After. Wacht minstens 60 seconden en verleng daarna de wachttijd.

Vind de juiste Maps-URL

  1. Open de exacte bedrijfslocatie in Google Maps.
  2. Controleer de vestiging en het adres en kies Delen.
  3. Kopieer de link en verstuur deze als maps_url.

Gegevensgebruik

Geslaagde aanroepen slaan de plaats-ID, taal, tijd en, indien beschikbaar, de geschatte bedrijfslocatie op. Opgeloste korte URL’s worden 24 uur in de cache bewaard.