Guide for AI agents

Google Review Link API for AI Agents

Convert one Google Maps URL into a direct review link. No signup or Google API key is required.

  1. Request

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

Find the correct Maps URL

  1. Open the exact business location in Google Maps.
  2. Check the branch name and address, then select Share.
  3. Copy the link and send it as maps_url.

If the branch is unclear, ask the user for the exact location. Do not guess or claim that the result is verified.

Request

Send one JSON object to the endpoint. Business names and bare Place IDs are not accepted.

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

Response

verification is always not_verified. Check the location before you give the link to a user.

API reference →

Errors and recovery

An edge-generated 429 response can have no JSON body or Retry-After header. Wait at least 60 seconds, then retry with increasing delays.

Errors and recovery →

Data use

Successful calls record the place identifier, language, time, and coarse business location when available. Resolved short URLs are cached for 24 hours.