Google 리뷰 링크 API

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

먼저 위치를 확인하세요
API는 식별자를 추출하고 링크를 만듭니다. 업체 이름, 주소 또는 리뷰 가능 여부는 확인하지 않습니다.

지원 입력
1. 특정 장소의 전체 Google 지도 URL
2. maps.app.goo.gl 공유 링크
3. 기존 goo.gl/maps 공유 링크

올바른 지도 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"}'

응답
{
  "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/ko/developers/google-review-link

AI 에이전트용 가이드: https://productmate.com/ko/agents/google-review-link

리뷰 링크 생성기 열기: https://productmate.com/ko/google-ribyu-link-saengseonggi