google-play/
app-detail

알고 있는 play.google.com URL에서 공개 Google Play 앱 상세 정보를 조회하여, 식별 정보, 스토어 텍스트, 개발자, 카테고리, 공개 지표, 가격, 미디어를 정규화된 레코드로 반환합니다.

Google Play App Detail API

알고 있는 앱 URL
일괄 상세 조회
결과 건별 과금
결과당 0.15 크레딧
준비됨
준비됨

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

README

SocQ 작성 · 업데이트

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을 제출하고, 비동기 작업을 추적한 뒤, 완료 후 정규화된 앱 레코드를 읽습니다.

  1. 파싱한 호스트 이름이 play.google.com이거나 지원되는 서브도메인인 앱 링크를 담은, 비어 있지 않은 urls 배열을 준비합니다.
  2. 배열을 /v1/google-play/app-detail로 POST하고, 반환된 task_id를 저장합니다.
  3. 작업이 성공하거나 실패할 때까지 /v1/tasks/{task_id}를 폴링합니다.
  4. 성공하면 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.items

Google 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 검색이나 원본 페이지 페이지네이션을 제공하지 않습니다.

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

다른 플랫폼 둘러보기

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

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

Google Play App Detail API는 알고 있는 Google Play 앱 URL에서 공개 스토어 등록 정보를 조회하는 프로그래밍 인터페이스입니다. 정규화된 앱 식별 정보, 등록 정보 문구, 개발자, 카테고리, 공개 지표, 가격, 미디어, 수집 정보를 확인 가능한 범위에서 반환합니다.

비어 있지 않은 urls 배열을 제출합니다. 모든 항목은 파싱한 호스트 이름이 play.google.com이거나 그 서브도메인인 문자열이어야 합니다.

아니요. 알고 있는 URL마다 상세 조회를 수행하며, URL 하나에 대해 정규화된 레코드를 최대 1건 반환합니다. 허용된 URL이라고 해서 공개 항목이 반드시 조회되는 것은 아닙니다.

앱 스키마에는 ID, 원본 URL, 패키지 ID, 이름, 텍스트, 개발자, 카테고리, 평점, 리뷰 수, 설치 수 구간, 가격, 순위, 미디어, 수집 시각이 포함될 수 있습니다. 확인할 수 없는 공개 필드는 null일 수 있습니다.

예상 요금은 제출한 URL 수에 건당 0.15 SocQ 크레딧을 곱해 계산합니다. 최종 청구는 반환된 결과 1건당 0.15 크레딧이고 기본 요금은 0 크레딧이므로, 성공했지만 반환된 레코드가 없는 작업의 최종 요금은 0 크레딧입니다.