Google クチコミリンク API

1 件の Google マップ URL をクチコミ投稿用の直接リンクに変換します。登録や Google API キーは不要です。

先に場所を確認してください
API は識別子を抽出してリンクを作成します。店舗名、住所、クチコミ投稿の可否は確認しません。

対応する入力
1. 特定の場所を示す完全な Google マップ URL
2. maps.app.goo.gl の共有リンク
3. 従来の goo.gl/maps 共有リンク

正しいマップ URL の取得方法
1. Google マップで正確な店舗を開きます。
2. 支店名と住所を確認し、共有を選択します。
3. リンクをコピーし、maps_url として送信します。

リクエスト
エンドポイントに 1 つの JSON オブジェクトを送信します。店舗名や Place ID だけの入力には対応していません。

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

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

verification は常に not_verified です。ユーザーに渡す前に場所を確認してください。

エラーと対処方法
- invalid_request (400): 空でない maps_url を含む有効な JSON を送信してください。
- unsupported_url (422): Google マップの特定店舗の共有リンクを使用してください。
- unsafe_redirect (422): Google マップだけに転送される共有リンクを使用してください。
- upstream_unresolved (502): 短縮リンクを開き、最終的な完全なマップ URL を送信してください。
- upstream_timeout (504): 待ってから一度再試行するか、最終的な完全なマップ URL を送信してください。

利用制限
匿名利用はクライアント IP ごとに毎分約 20 リクエストです。同じ IP を使うエージェントはこの枠を共有します。

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

エッジで生成された 429 レスポンスには JSON や Retry-After がない場合があります。60 秒以上待ち、その後は待機時間を延ばしてください。

データの利用
成功した呼び出しでは、場所の識別子、言語、時刻、および取得できる場合は店舗のおおよその位置を記録します。展開した短縮 URL は24時間キャッシュされます。

Postman コレクション: https://productmate.com/developers/google-review-link/postman.json

OpenAPI: https://productmate.com/developers/google-review-link/openapi.json

API リファレンス: https://productmate.com/ja/developers/google-review-link

AI エージェント向けガイド: https://productmate.com/ja/agents/google-review-link

クチコミリンク作成ツールを開く: https://productmate.com/ja/google-kuchikomi-link-sakusei