google-maps/
reviews

알고 있는 Google Maps URL에서 공개 리뷰를 수집하여, 정규화된 텍스트, 작성자 참조 정보, 평점, 원본 링크, 타임스탬프, 장소 참조 정보, 확인 가능한 미디어를 반환합니다.

Google Maps Reviews API

장소 리뷰
일 단위 기간 필터
정규화된 리뷰 레코드
결과당 0.15 크레딧
준비됨
준비됨

매개변수를 입력하고 요청을 전송하세요. 작업 상태와 정규화된 결과가 여기에 표시됩니다.

README

SocQ 작성 · 업데이트

Google Maps Reviews

Google Maps 리뷰는 작성된 텍스트, 작성자 참조 정보, 평점, 원본 및 대상 링크, 게시 시각과 수집 시각, 미디어를 포함할 수 있는 공개 장소 피드백 기록입니다. 출처가 연결된 피드백 데이터셋을 만들고, 알고 있는 장소 또는 수집 기간별로 비교하는 데 활용할 수 있습니다.

Google Maps Reviews API 주요 기능

  • 알고 있는 URL 일괄 입력별도의 식별자 API로 장소를 찾지 않고, 지원되는 google.com 또는 goo.gl URL을 하나 이상 비동기 작업 하나로 제출합니다.
  • 선택 가능한 일 단위 기간최근 리뷰 기간이 필요한 워크플로에서는 양수 days_limit 값 하나를 제출한 모든 URL 행에 적용할 수 있습니다.
  • 안정적인 리뷰 레코드리뷰 식별 정보, 텍스트, 작성자 필드, 평점, 장소 참조 정보, 타임스탬프, 원본 URL, 확인 가능한 미디어를 리뷰 v1.0 스키마로 읽습니다.

Google Maps Reviews API 매개변수

매개변수필수설명
urls필수google.com, google.com의 모든 서브도메인, goo.gl 또는 goo.gl의 서브도메인에 있는 비어 있지 않은 URL을 쉼표나 줄바꿈으로 구분해 하나 이상 지정합니다. 리뷰 수집에는 알고 있는 Maps 장소 URL을 사용하세요.
days_limit선택리뷰의 최근 기간으로 모든 제공처 입력 행에 적용되는 양의 정수이며, 선택 값입니다. 생략하면 일 단위 기간 필터를 보내지 않습니다.
results_limit선택작업에 저장할 전체 리뷰 수의 상한으로, 1 이상 2,000 이하의 정수이며 선택 값입니다. 기본값은 100이고, 원본에서 제공되는 양에 따라 더 적은 행이 반환될 수 있습니다.

Google Maps Reviews API 사용 방법

알고 있는 Google Maps URL을 제출하고, 비동기 작업을 추적한 뒤, 작업 결과 커서로 저장된 리뷰 레코드를 읽습니다.

  1. google.com 또는 goo.gl에 있는 지원되는 Google Maps 장소 URL을 하나 이상 준비합니다.
  2. urls를 /v1/google-maps/reviews로 POST하고, 필요하면 days_limit 값과 results_limit 값도 함께 보냅니다.
  3. status가 succeeded 또는 failed가 될 때까지 /v1/tasks/{task_id}를 폴링합니다.
  4. /v1/tasks/{task_id}?limit=50을 읽고, results.has_more가 true이면 results.next_cursor로 이어서 가져옵니다.
curl -X POST "https://api.socq.ai/v1/google-maps/reviews" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.google.com/maps/place/Coffee%20Project%20New%20York%20%7C%20East%20Village/data=!4m7!3m6!1s0x89c2599b5a24d7fd:0x9e354f6cf514b9fc!8m2!3d40.7270884!4d-73.9893820!16s%2Fg%2F11c3svpqld!19sChIJ_dckWptZwokR_LkU9WxPNZ4?authuser=0&hl=en&rclk=1"],"days_limit":3650,"results_limit":3}'

# Poll GET /v1/tasks/{task_id}, then request
# GET /v1/tasks/{task_id}?limit=50&cursor={results.next_cursor}.

Google Maps Reviews API 추천 활용 사례

  • 알고 있는 장소의 피드백 데이터셋: 정해 둔 공개 장소 URL 집합을 대상으로 리뷰 텍스트, 평점, 게시 시각, 원본 링크를 준비합니다.
  • 출처를 고려한 작성자 조사: 확인 가능한 작성자 이름, 사용자 이름, 프로필 링크, 리뷰 URL을 보존해 레코드를 공개된 맥락까지 추적할 수 있게 합니다.
  • 최근 기간 비교: 같은 장소 집합을 기록해 둔 days_limit 값으로 시점을 달리해 수집하고, 전체 이력을 확보했다고 주장하지 않으면서 범위가 정해진 수집 결과끼리 비교합니다.
  • 미디어가 연결된 리뷰 아카이브: 확인 가능한 리뷰 미디어를 텍스트, 평점, 장소 참조 정보, 수집 시각과 함께 정규화된 조사용 레코드에 담아 둡니다.

Google Maps Reviews API 활용 팁

  • 확인 가능한 google.com 또는 goo.gl Maps URL을 제출하세요. 장소 이름, Google Business Profile 계정, Place ID만으로는 urls 항목으로 허용되지 않습니다.
  • days_limit 값은 양의 정수로 기간을 정하는 것이 의미가 있을 때만 사용하세요. 생략하면 제공처 행에 해당 필터가 적용되지 않습니다.
  • results_limit은 URL마다 보장되는 값이 아니라 URL 묶음 전체에 적용되는 하나의 저장 결과 상한으로 취급하세요.
  • 제출 시의 results_limit과 작업 결과를 읽을 때의 limit은 별개입니다. 후자는 페이지 크기를 1~500으로 조절하며 불투명한 커서를 사용합니다.
  • 공개 원본에 노출되지 않으면 텍스트, 작성자 속성, 평점, 대상 참조 정보, 타임스탬프, 미디어가 없을 수 있다는 점을 감안하세요.

Google Maps Reviews API 외에 Google Maps의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.

다른 플랫폼 둘러보기

Google Maps 데이터를 지원되는 다른 소셜 플랫폼의 공개 데이터와 함께 활용하세요.

Google Maps Reviews API — 자주 묻는 질문

Google Maps Reviews API는 알고 있는 Google Maps URL에서 공개 리뷰 레코드를 수집해 안정적인 리뷰 스키마로 제공하는 프로그래밍 인터페이스입니다. 지원되는 공개 수집 경로로 확인할 수 있는 데이터만 반환하며, 로그인이 필요한 Google Business Profile 관리 기능은 제공하지 않습니다.

런타임은 호스트가 google.com, google.com의 서브도메인, goo.gl 또는 goo.gl의 서브도메인인 비어 있지 않은 URL을 받습니다. 쓸 만한 리뷰 결과를 얻으려면 이름이나 단독 식별자가 아니라 알고 있는 Google Maps 장소 URL을 제출하세요.

days_limit 값은 선택 사항이며 1 이상의 정수여야 합니다. 지정하면 제공처 어댑터가 같은 값을 모든 URL 입력 행에 복사하고, 생략하면 days_limit 필드를 보내지 않습니다.

results_limit의 기본값은 100이며 1 이상 2,000 이하의 정수를 받습니다. 제공처 요청에 상한이 전달되고, 작업 전체의 저장 건수가 상한에 도달하면 런타임도 행 저장을 멈추므로, URL 수, 일 단위 기간, 공개 데이터셋의 제공 범위에 따라 결과가 더 적을 수 있습니다.

리뷰 v1.0 스키마에는 id, platform, resource, type, url, published_at, collected_at, text, author, rating, subject_id, subject_url, media가 포함될 수 있습니다. author는 식별 정보, 사용자 이름, 이름, 프로필 URL, 아바타 URL, null 가능한 계정 플래그로 펼쳐집니다.

기본 작업 요금은 없습니다. 요청 시 results_limit(생략하면 100)을 기준으로 예상 결과 1건당 0.15 크레딧을 확보해 두었다가, 실제로 저장된 결과 1건당 0.15 크레딧으로 정산하고 사용하지 않은 크레딧은 환불하며, 결과가 비어 있으면 0 크레딧으로 정산됩니다.