AI 에이전트용 가이드

AI 에이전트용 Google 리뷰 링크 API

Google 지도 URL 하나를 직접 리뷰 링크로 변환합니다. 가입이나 Google API 키가 필요하지 않습니다.

  1. 요청

    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. 응답 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

올바른 지도 URL 찾기

  1. Google 지도에서 정확한 업체 위치를 엽니다.
  2. 지점 이름과 주소를 확인한 후 공유를 선택합니다.
  3. 링크를 복사하여 maps_url로 전송합니다.

지점이 불분명하면 사용자에게 정확한 위치를 물어보세요. 추측하거나 결과가 검증되었다고 주장하지 마세요.

요청

엔드포인트에 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"}'

응답

verification은 항상 not_verified입니다. 사용자에게 링크를 제공하기 전에 위치를 확인하세요.

API 참조 →

오류 및 해결 방법

에지에서 생성된 429 응답에는 JSON 또는 Retry-After가 없을 수 있습니다. 최소 60초 기다린 후 대기 시간을 늘리세요.

오류 및 해결 방법 →

데이터 사용

성공한 호출은 장소 식별자, 언어, 시간 및 가능한 경우 사업장의 대략적인 위치를 기록합니다. 확인된 단축 URL은 24시간 동안 캐시됩니다.