API 목록으로 돌아가기
Google Play 공개 데이터

Google Play API

이미 알고 있는 스토어 URL에서 공개 Google Play 앱 상세 정보, 카테고리 순위, 리뷰를 정규화된 앱·리뷰 레코드로 수집합니다.

사용할 수 있는 Google Play API

이미 알고 있는 앱 페이지에는 App Detail, 공개 차트 URL에는 App Rankings, 이미 알고 있는 앱 URL의 공개 사용자 의견에는 App Reviews를 사용합니다.

어떤 Google Play 데이터를 가져올 수 있나요?

정규화된 앱 스키마는 공개 스토어 페이지의 필드를 null이 가능한 값으로 유지하며, 원본에 없는 값을 추측으로 채우지 않습니다.

앱 식별 정보와 설명

제공되는 경우 패키지 ID, 앱 이름, 공개 설명, 개발자, 카테고리, 출처 URL을 가져옵니다.

스토어에 표시되는 지표

제공되는 평점, 리뷰 수, 설치 수 범위, 가격, 순위를 특정 시점의 스토어 관측값으로 보존합니다.

미디어와 수집 정보

정규화된 앱 레코드에 미디어 필드와 collected_at을 함께 보존합니다.

Google Play API 사양 개요

각 엔드포인트는 이미 알고 있는 공개 Google Play URL에서 시작해, 비동기 작업 흐름으로 정규화된 레코드를 반환합니다.

엔드포인트입력원본 범위
App Detail비어 있지 않은 앱 URL 배열허용된 URL 하나당 앱 레코드 최대 1건
App Rankings카테고리 또는 순위 URL, 선택적 results_limit제출한 차트에 노출된 앱
App Reviews앱 URL, 선택적 country와 results_limit제출한 앱의 공개 리뷰

Google Play API 작동 방식

세 엔드포인트 모두 표준 비동기 작업 흐름을 따릅니다.

  1. 1. 알고 있는 URL 제출

    알맞은 엔드포인트를 골라 필수 urls 배열과 선택 옵션을 POST하고, task_id를 보관합니다.

  2. 2. 작업 추적

    처리가 성공하거나 실패할 때까지 /v1/tasks/{task_id}를 폴링합니다.

  3. 3. 저장된 레코드 읽기

    성공하면 data.results.items를 읽고, SocQ에 저장된 결과 페이지가 더 있을 때만 next_cursor를 따라갑니다.

Google Play 앱 상세 정보 가져오기

SocQ API 키로 인증하고 이미 알고 있는 공개 Google Play 앱 URL을 제출합니다.

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 data.results.items

Google Play API 주요 활용 사례

애플리케이션 카탈로그 정보 보강

이미 알고 있는 앱 링크에 정규화된 식별 정보, 공개 스토어 설명, 개발자, 카테고리, 출처 정보를 추가합니다.

선택한 앱 페이지 비교

직접 정한 URL 세트를 대상으로 공개된 가격, 평점, 리뷰, 설치 수, 미디어 필드를 비교합니다.

특정 시점 관측

반복 수집한 레코드를 collected_at과 함께 보관해, null이 가능한 공개 스토어 필드의 변화를 시간순으로 비교합니다.

제한 사항과 공개 데이터 정책

결과는 현재 공개된 스토어 페이지에서 보이는 내용에 따라 달라지며, 계정 관리나 게시 기능은 제공하지 않습니다.

  • 모든 입력 항목은 play.google.com 또는 그 하위 도메인으로 확인되어야 합니다.
  • 키워드나 패키지 ID만으로는 요청할 수 없으며, 지원하는 선택 필드는 엔드포인트마다 다릅니다.
  • App Detail은 URL 하나당 최대 1건을 반환하고, Rankings와 Reviews는 작업 전체에 적용되는 1~2,000 범위의 results_limit을 사용합니다.
  • 작업 결과 커서는 SocQ에 이미 저장된 레코드를 페이지로 나눌 뿐, Google Play의 추가 페이지를 가져오지 않습니다.
  • 최종 요금은 저장된 결과 1건당 0.15 크레딧이며 기본 요금은 없습니다. 예상 금액은 App Detail은 URL 수, Rankings와 Reviews는 요청한 결과 상한이나 기본 상한을 기준으로 계산합니다.

Google Play API 자주 묻는 질문

Google Play API란 무엇인가요?

Google Play API는 이미 알고 있는 Google Play URL에서 앱 상세 정보를 가져오고, 카테고리 순위와 공개 앱 리뷰를 수집합니다.

앱 URL을 여러 개 보낼 수 있나요?

네. 비어 있지 않은 문자열 배열을 제출하며, 각 항목은 play.google.com 호스트 또는 지원하는 하위 도메인을 사용해야 합니다.

API로 앱을 탐색할 수 있나요?

App Rankings는 제출한 차트 URL에 노출된 앱을 찾아 줍니다. 키워드 검색은 제공하지 않습니다.

결과 요금은 어떻게 부과되나요?

저장된 결과 1건당 0.15 SocQ 크레딧입니다. 최종 요금은 실제 결과 수를 기준으로 하며, 예상 금액은 선택한 엔드포인트에 따라 달라집니다.

여러 플랫폼의 공개 프로필, 콘텐츠, 참여도 데이터를 하나의 워크플로로 모으면 브랜드, 크리에이터, 주제를 추적하고 플랫폼 간 모니터링과 분석을 더 효율적으로 진행할 수 있습니다.

Amazon API

지원되는 마켓플레이스에서 공개 Amazon 상품을 검색하고, 정규화된 상품 상세 정보, Best Sellers, 리뷰, 판매자 프로필, 크리에이터 스토어 레코드를 수집합니다.

Apple App Store API

이미 알고 있는 스토어 URL에서 공개 Apple App Store 앱 상세 정보, 카테고리 순위, 리뷰를 정규화된 앱·리뷰 레코드로 수집합니다.

SEO API

실시간 Google 오가닉 검색 결과를 조회하고, 키워드 수요와 순위 난이도를 비교하고, 시드 키워드를 확장하고, 사이트의 검색 노출을 이끄는 키워드와 페이지를 찾고, 검색 의도를 분류하며, Google 뉴스·이미지·자동완성과 Bing, YouTube 결과를 모읍니다. 모든 엔드포인트가 같은 SocQ API 키, 비동기 작업 흐름, 정규화된 결과 형식을 사용합니다.

Telegram API

t.me 링크로 공개 텔레그램 채널을 읽습니다. 구독자 수가 담긴 채널 정보, 조회수와 반응이 담긴 게시물, 개별 게시물, 토론 그룹 댓글, 추천 채널, 전체 기록 검색을 지원합니다.

Link in Bio API

크리에이터가 Instagram, TikTok, YouTube 소개란에 넣는 링크 하나를 표시 이름, 소개, 프로필 사진, 공개된 연락처 이메일, 연결된 SNS 프로필, 각 버튼의 제목과 연결 주소라는 구조화된 데이터로 바꿉니다.

Creator API

Instagram, TikTok, YouTube, X, Facebook, Threads 프로필 하나에서 출발해 크리에이터의 공개 비즈니스 이메일, 다른 SNS 계정, 프로필 사진 기반 나이·성별 추정을 가져옵니다.