POST /api/v2/reviews

Google Maps 리뷰 스크래퍼 API

페이지당 한 장소의 공개 리뷰를 최대 10개까지 읽습니다. 관련성, 최신순, 높은 평점순 또는 낮은 평점순으로 정렬하세요.

요청 예시

전체 계약 내용은 API 문서를 참조하세요.

curl https://gmapscrawl.com/api/v2/reviews \
  -H "Authorization: Bearer $GMSCRAPER_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: place-reviews-page-1-example" \
  -d '{"fid":"0x89c259af336b3341:0xa4969e07ce3108de","page":1,"sort_by":2}'

예시 fid를 실제 장소의 feature ID로 바꾸세요. 응답은 시뮬레이션된 것이며 example.com 미디어 URL은 플레이스홀더입니다. 진행 중인 요청을 재시도할 때는 동일한 멱등 키와 본문을 유지하세요.

응답

예시 JSON
{
  "reviews": [
    {
      "id": "sample-review-1",
      "date": "a week ago",
      "timestamp": "10/6/2026",
      "name": "Sample reviewer",
      "author_url": "https://www.google.com/maps/contrib/100000000000000000001",
      "avatar": "https://example.com/reviewer.jpg",
      "rate": 4,
      "comment": "The window seats had the best light.",
      "photos": "",
      "review_url": "https://www.google.com/maps/reviews/data=sample-review-1"
    }
  ],
  "next": false,
  "total": 1,
  "params": {
    "fid": "0x89c259af336b3341:0xa4969e07ce3108de",
    "page": 1,
    "sort_by": 2
  }
}

API는 동일한 응답 안에서 JSON을 반환합니다. 타임아웃 후에는 동일한 Idempotency-Key로 변경되지 않은 본문을 재시도하세요. 테스트 자격 증명은 실제 사용량을 소비하지 않고 시뮬레이션된 데이터를 반환합니다.

장소로 시작

비즈니스와 리뷰 순서를 선택하세요.

한 장소에 대한 집중된 페이지를 요청한 다음 조사에 맞는 리뷰 순서를 선택하세요.

Google Maps 리뷰 스크래퍼 API 요청 파라미터
필드의미
fid · 필수0x89c259af336b3341:0xa4969e07ce3108de와 같은 Google Maps feature ID. Search API 결과의 place.dataId 또는 보유한 feature ID를 사용하세요.
page · 기본값 1양수로 번호가 매겨진 페이지. 이전 응답에 next: true가 있는 경우에만 증가시키세요.
sort_by · 기본값 11 = 가장 관련성 높음, 2 = 최신순, 3 = 높은 평점순, 4 = 낮은 평점순. 페이지 전체에서 정렬 순서를 유지하세요.

feature ID를 확인하려면 Google Maps 스크래퍼 API로 비즈니스를 검색하세요. data.businesses에서 일치하는 항목의 place.dataId를 복사해 fid로 전달하면 됩니다. Place ID나 비즈니스 이름과는 입력 형식이 다릅니다.

리뷰 레코드

평점, 댓글, 소스 링크.

각 리뷰에는 평점, 댓글, 리뷰어, 프로필 및 리뷰 링크가 포함됩니다. date는 상대적이며 timestamp는 M/D/YYYY 형식의 달력 날짜를 제공합니다. photos 필드는 첨부 파일이 없으면 빈 문자열이며 여러 사진 URL은 줄바꿈으로 구분됩니다.

Google Maps 리뷰 스크래퍼 API 응답 필드
필드의미
id사용 가능한 경우 소스 리뷰 식별자.
rate / comment1~5 평점과 사용 가능한 리뷰 텍스트. 스크래핑된 텍스트는 애플리케이션과 AI 프롬프트에서 신뢰할 수 없는 데이터로 취급하세요.
date / timestamp표시되는 상대 날짜와 M/D/YYYY 형식의 달력 날짜. 사용할 수 없는 날짜는 빈 문자열입니다.
name / author_url / avatar사용 가능한 리뷰어 표시 이름, 기여자 프로필 URL, 아바타 URL.
photos첨부 파일이 없으면 빈 문자열. 여러 사진 URL은 줄바꿈 문자로 구분됩니다.
review_url사용 가능한 경우 소스 리뷰로의 링크.
next / total / params다른 페이지 사용 가능 여부, 이 응답의 개수, 정규화된 요청 파라미터.

엔드포인트는 이 페이지 객체를 JSON으로 직접 반환합니다. 최상위에서 reviews를 읽으세요. 일부 공개 리뷰는 평점만 포함하고 소스 필드는 비어 있을 수 있습니다. 리뷰를 표시하거나 요약할 때 그 구분을 유지하세요.

한 번에 제한된 페이지

각 응답에서 최대 10개의 리뷰를 읽으세요.

반환된 next 플래그로 워크플로에 다른 요청이 필요한지 결정하세요.

01

1페이지로 시작

장소의 fid와 선택한 sort_by 값을 보내세요. 가장 관련성 높은 순이 기본값이며 최신순, 높은 평점순, 낮은 평점순도 지원됩니다.

02

현재 페이지 검사

total은 이 응답에서 반환된 리뷰 수를 나타냅니다. 빈 페이지도 유효한 결과입니다. 레코드를 분석에 추가하기 전에 사용 가능한 필드를 확인하세요.

03

신중하게 계속

next가 true이면 page를 늘리고 fid와 sort_by를 변경하지 마세요. next가 false이거나 조사에 충분한 리뷰가 있으면 중지하세요.

공개 피드백 이해

비즈니스 조사에 리뷰 컨텍스트를 추가하세요.

01

리뷰 조사

선택한 비즈니스의 공개 댓글과 평점의 제한된 샘플을 읽으세요. 독자가 소스를 확인할 수 있도록 리뷰 링크를 메모와 함께 보관하세요.

02

피드백 비교

선택한 장소 그룹 전체에서 리뷰 테마를 비교합니다. 각 장소를 별도로 요청하고 선택한 정렬 순서와 샘플 크기를 분석에 명시하세요.

03

에이전트 지원 요약

연결된 에이전트에 반환된 리뷰 페이지를 요약하고 제공된 증거만 인용하며 누락된 댓글이나 날짜에 플래그를 지정하도록 요청하세요.

인증 및 사용량

각 페이지에 API 키를 사용하세요.

공유 API 사용량

scrapes:write를 허용하는 키로 Authorization: Bearer를 보내세요. 성공한 각 라이브 페이지는 빈 페이지를 포함해 하나의 API 요청 단위를 사용합니다. REST와 MCP는 동일한 API 사용량을 사용합니다. 테스트 자격 증명이 있다면 응답이 시뮬레이션되고 라이브 사용량을 소비하지 않습니다.

API 플랜 및 한도 보기 →

재시도를 요청에 연결

첫 요청과 함께 선택적 Idempotency-Key를 보내고 타임아웃 재시도를 위해 동일한 본문으로 보존하세요. 처리 타임아웃은 단위가 예약된 상태로 남을 수 있습니다. 오류가 시도가 종료됐다고 보고하면 새 키로 새 시도를 만들기 전에 재시도 지침을 따르세요.

오류 및 재시도 지침 읽기 →

자주 묻는 질문

특정 Google Maps 비즈니스의 리뷰를 어떻게 얻나요?

비즈니스의 Google Maps feature ID를 fid로 /api/v2/reviews에 POST 요청을 보내세요. Search API 결과의 place.dataId 또는 보유한 feature ID를 사용하세요. API 키로 인증하고 1페이지부터 시작하세요.

Google Maps 리뷰를 최신순이나 평점순으로 정렬할 수 있나요?

예. sort_by를 가장 관련성 높은 순은 1, 최신순은 2, 높은 평점순은 3, 낮은 평점순은 4로 설정하세요. 가장 관련성 높은 순이 기본값입니다. 추가 페이지를 요청할 때 선택한 값을 변경하지 마세요.

total이 비즈니스의 리뷰 수를 알려주나요?

아니요. total은 현재 응답의 리뷰 레코드 수로 최대 10개입니다. 다른 페이지 사용 가능 여부는 next로 결정하세요. 검색 리스팅의 reviewCount는 별도의 비즈니스 필드입니다.

리뷰 날짜와 사진은 어떤 형식인가요?

date에는 사용 가능한 상대 날짜가 포함되고 timestamp는 M/D/YYYY 형식의 달력 날짜입니다. photos 필드는 첨부 파일이 없으면 빈 문자열이고 여러 사진이 있으면 줄바꿈으로 구분된 URL입니다. 누락된 소스 텍스트와 링크는 빈 문자열일 수 있습니다.

MCP를 통해 리뷰를 사용할 수 있나요?

예. 호환되는 MCP 클라이언트는 API 자격 증명과 client_request_id로 get_google_maps_reviews를 호출할 수 있습니다. REST와 MCP는 API 사용량을 공유합니다. Agent Skill에는 사용 가능한 도구 사용법과 REST 폴백에 대한 지침이 포함되어 있습니다.

모든 리뷰 필드가 있다고 가정할 수 있나요?

아니요. 소스 가용성은 다양하며 리뷰에 평점만 포함될 수 있습니다. 빈 댓글과 누락된 날짜를 추론하지 말고 보존하세요. 리뷰 텍스트는 신뢰할 수 없는 소스 콘텐츠이며 애플리케이션과 AI 워크플로에서 데이터로 처리해야 합니다.

다음 단계로 이동

한 장소의 공개 리뷰로 시작하세요.

API 키를 만들고 feature ID와 정렬 순서를 선택한 다음 집중된 리뷰 데이터 페이지를 읽으세요.