Google Play App Detail
Google Play 앱 상세 정보는 앱 식별 정보, 설명, 개발자와 카테고리, 공개된 평점과 리뷰 수, 설치 수 구간, 가격, 미디어를 담은 공개 스토어 등록 정보입니다. 이러한 필드는 카탈로그 정보 보강, 선택한 앱 비교, 특정 시점 모니터링에 활용할 수 있습니다.
Google Play App Detail API 주요 기능
- 알고 있는 URL 일괄 처리 범위play.google.com 앱 URL을 하나 이상 제출해 직접 상세 조회하며, 요청이 키워드 탐색으로 바뀌지 않습니다.
- 등록 정보 식별 및 문구패키지 식별자, 앱 이름, 공개 스토어 설명, 개발자, 카테고리, 원본 URL, 수집 시각을 정규화합니다.
- 공개된 시장 지표확인 가능한 평점, 리뷰 수, 설치 수 구간, 가격, 순위 필드를 공개 등록 정보에서 관찰한 null 가능 값으로 유지합니다.
- 미디어를 포함한 앱 레코드안정적인 앱 스키마와 함께 미디어를 반환하므로, 등록 정보 레코드를 다른 SocQ 데이터와 같은 비동기 결과 워크플로로 처리할 수 있습니다.
Google Play App Detail API 매개변수
| 매개변수 | 필수 | 설명 |
|---|---|---|
urls | 필수 | 파싱한 호스트 이름이 play.google.com이거나 그 서브도메인인 알고 있는 앱 URL의 문자열 배열로, 비어 있지 않아야 하는 필수 값입니다. 허용된 URL 하나가 상세 조회 한 건입니다. |
Google Play App Detail API 사용 방법
알고 있는 Google Play URL을 제출하고, 비동기 작업을 추적한 뒤, 완료 후 정규화된 앱 레코드를 읽습니다.
- 파싱한 호스트 이름이 play.google.com이거나 지원되는 서브도메인인 앱 링크를 담은, 비어 있지 않은 urls 배열을 준비합니다.
- 배열을 /v1/google-play/app-detail로 POST하고, 반환된 task_id를 저장합니다.
- 작업이 성공하거나 실패할 때까지 /v1/tasks/{task_id}를 폴링합니다.
- 성공하면 data.results.items를 읽습니다. next_cursor는 has_more가 true일 때만 따라가세요. 이 커서는 SocQ에 이미 저장된 레코드를 넘기는 것이며, 다른 Google Play 원본 페이지를 탐색하지 않습니다.
curl -X POST "https://api.socq.ai/v1/google-play/app-detail" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://play.google.com/store/apps/details?id=com.openai.chatgpt"]}'
# Poll GET /v1/tasks/{task_id}
# Read normalized app records from data.results.itemsGoogle Play App Detail API 추천 활용 사례
- 알고 있는 앱 카탈로그 정보 보강: 저장해 둔 Google Play 링크를 정규화된 패키지 ID, 제목, 설명, 개발자, 카테고리, 원본 URL, 수집 타임스탬프로 바꿉니다.
- 선택한 등록 정보 비교: 승인된 앱 URL 집합에서 확인 가능한 평점, 리뷰 수, 설치 수 구간, 가격, 카테고리, 미디어 필드를 나란히 맞춰 비교합니다.
- 등록 정보 스냅샷 모니터링: 정해 둔 일정으로 조회를 반복하고, null 가능한 등록 정보 필드를 collected_at과 함께 비교해 특정 시점의 변경을 찾아냅니다.
Google Play App Detail API 활용 팁
- 전체 Google Play 앱 URL을 사용하고, 제출 전에 배열의 중복을 제거해야 예상 요금이 의도한 조회 수를 반영합니다.
- 입력 URL 하나당 결과는 최대 1건으로 보세요. 허용된 URL도 항목이 없을 수 있으므로 반환된 레코드는 url 또는 app_id로 대조해야 합니다.
- 공개 등록 정보 필드는 없을 수도 있고 수집 후 바뀔 수도 있으므로, 평점, 리뷰 수, 설치 수 구간, 가격, 순위, 미디어는 방어적으로 저장하세요.
- next_cursor는 완료된 작업의 저장된 SocQ 결과를 이어서 읽을 때만 사용하세요. 이 상세 조회 엔드포인트는 Google Play 검색이나 원본 페이지 페이지네이션을 제공하지 않습니다.
관련 API
Google Play App Detail API 외에 Google Play의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.
- Google Play App Rankings API
- Google Play App Reviews API — play.google.com URL에서 공개 앱 리뷰를 수집하며, 선택적인 국가 맥락과 정규화된 텍스트, 리뷰어, 평점, 시각, 앱 참조 필드를 포함합니다.