google-play/
app-reviews

play.google.com 앱 URL과 선택 국가 정보로 공개 Google Play 앱 리뷰를 수집하여, 리뷰 텍스트, 작성자, 평점, 타임스탬프, 앱 참조 정보를 정규화된 레코드로 반환합니다.

Google Play App Reviews API

앱 URL 일괄 입력
리뷰 텍스트와 평점
국가 정보
결과당 0.15 크레딧
준비됨
준비됨

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

README

SocQ 작성 · 업데이트

Google Play App Reviews

Google Play 앱 리뷰는 작성된 의견과 별점을 작성자 정보, 게시 시각, 리뷰 대상 앱 참조 정보와 함께 담은 공개 앱스토어 평가입니다. 이러한 레코드는 의견 조사, 평점 비교, 릴리스 모니터링, 출처가 연결된 리뷰 데이터셋 구축에 활용할 수 있습니다.

Google Play App Reviews API 주요 기능

  • 여러 앱 URL 입력play.google.com 앱 URL을 하나 이상 받아, 요청한 리뷰 수를 제출한 앱들에 나누어 할당합니다.
  • 리뷰 내용과 평점확인 가능한 리뷰마다 텍스트와 숫자 평점을 일관된 리뷰 레코드로 반환합니다.
  • 작성자 및 시간 정보확인 가능한 작성자 식별 정보, 프로필 참조 정보, 게시 시각, 수집 시각을 피드백과 함께 보존합니다.
  • 리뷰 대상 앱 추적subject_id와 subject_url을 통해 정규화된 리뷰를 확인 가능한 앱 식별자와 공개 앱 URL에 연결합니다.

Google Play App Reviews API 매개변수

매개변수필수설명
urls필수play.google.com 또는 그 서브도메인에 있는, 비어 있지 않은 앱 URL을 하나 이상 담은 배열로, 필수 값입니다.
country선택국가 정보로 리뷰 원본에 전달되는 문자열이며, 선택 값입니다. 시장 정보가 필요하지 않으면 생략하세요.
results_limit선택1 이상 2,000 이하의 양의 정수이며, 선택 값입니다. 기본값은 100이고, 제출한 모든 URL에 걸쳐 저장되는 전체 결과 수의 상한을 정합니다.

Google Play App Reviews API 사용 방법

Google Play 앱 URL을 제출하고, 비동기 작업을 추적한 뒤, SocQ에 저장된 정규화 레코드를 페이지 단위로 읽습니다.

  1. 호스트 이름이 play.google.com이거나 그 서브도메인인 공개 앱 URL을 하나 이상 준비합니다.
  2. urls와 선택 항목인 country, results_limit을 /v1/google-play/app-reviews로 POST하고, 반환된 task_id를 저장합니다.
  3. 작업이 성공하거나 실패할 때까지 /v1/tasks/{task_id}를 폴링합니다. 폴링하는 동안에는 다른 작업을 제출하지 마세요.
  4. 성공하면 data.results.items를 읽고, has_more가 true인 동안 next_cursor를 작업 경로에 다시 전달합니다.
curl -X POST "https://api.socq.ai/v1/google-play/app-reviews" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://play.google.com/store/apps/details?id=com.example.notes"],"country":"US","results_limit":100}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Google Play App Reviews API 추천 활용 사례

  • 피드백 주제 조사: 리뷰 텍스트와 평점으로 정성 코딩이나 이후 텍스트 분석에 쓸 출처 연결형 코퍼스를 준비합니다.
  • 평점과 텍스트 비교: 선택한 공개 앱 페이지들에서 작성된 의견을 그에 대응하는 숫자 평점과 비교합니다.
  • 리뷰 시계열 모니터링: 게시 시각과 수집 시각을 함께 활용해, 제품 릴리스 전후로 따로 수집한 리뷰 샘플을 비교합니다.
  • 앱 연결형 데이터셋 정보 보강: subject_id와 subject_url을 이용해 작성자, 텍스트, 평점, 타임스탬프 필드를 앱 레코드에 붙입니다.

Google Play App Reviews API 활용 팁

  • play.google.com의 완전한 공개 앱 URL을 사용하세요. 다른 호스트는 수집이 시작되기 전에 입력 검증에서 실패합니다.
  • URL을 여러 개 제출할 때는 results_limit을 작업 전체의 목표치로 정하세요. 원본 할당량이 앱 입력들에 나뉘어 적용되고 최종 저장은 전체 기준으로 제한되기 때문입니다.
  • country는 시장 정보가 중요할 때만 설정하고, 비교할 반복 수집에서는 같은 값을 유지하세요.
  • 추가로 저장된 레코드는 작업 응답의 next_cursor를 따라 가져오세요. 이 값은 SocQ 결과 커서이며 리뷰 원본이 받는 커서가 아닙니다.
  • 작성자, 원본 링크, 미디어 같은 선택 필드는 없는 값을 임의의 기본값으로 바꾸지 말고 null 가능 값으로 다루세요.

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

  • Google Play App Detail API — 알고 있는 앱 URL에서 정규화된 공개 Google Play 등록 정보를 가져오며, 앱 정보, 스토어 문구, 개발자, 카테고리, 공개된 지표, 가격, 미디어, 수집 맥락을 포함합니다.
  • Google Play App Rankings API

다른 플랫폼 둘러보기

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

Google Play App Reviews API — 자주 묻는 질문

Google Play App Reviews API는 제출한 하나 이상의 Google Play 앱 URL에서 선택 국가 정보와 함께 공개 앱 리뷰를 수집하는 프로그래밍 인터페이스입니다. 정규화된 리뷰 텍스트, 작성자 정보, 평점, 게시 시각, 미디어, 리뷰 대상 앱 참조 정보를 반환합니다.

urls는 호스트 이름이 play.google.com이거나 그 서브도메인인, 비어 있지 않은 URL의 필수 배열입니다. country는 원본 요청에 전달되는 선택 문자열이며 생략할 수 있습니다.

results_limit의 기본값은 100이며 1 이상 2,000 이하의 정수를 받습니다. 원본 요청은 요청한 개수를 제출한 URL들에 나누어 할당하고, SocQ는 작업 전체의 저장 결과를 요청한 제한으로 제한합니다.

정규화된 레코드에는 리뷰 ID, 원본 URL, 텍스트, 작성자 식별 정보, 숫자 평점, 게시 시각과 수집 시각, 앱 식별자, 앱 URL, 미디어 참조 정보가 포함될 수 있습니다. 공개 결과에서 제공되지 않는 선택 필드는 null이거나 비어 있습니다.

아니요. 호출자가 제공하는 원본 커서는 받지 않습니다. 비동기 작업이 성공한 뒤에는 next_cursor와 has_more로 SocQ에 이미 저장된 결과 행을 페이지 단위로 읽습니다.

results_limit을 생략하면 작업은 결과 100건으로 예상되며, 저장된 결과 1건당 0.15 SocQ 크레딧이 차감됩니다. 최종 청구는 실제 결과 수를 기준으로 하고, 성공했지만 결과가 비어 있으면 기본 요금 0 크레딧으로 정산됩니다.