앱 검색
5 크레딧/v1/google_play/app-searchGoogle Play 키워드 검색입니다. info·reviews용 id가 있는 앱 카드입니다. 고급 티어(5 크레딧)입니다.
query, country, language, depth
Google Play APIGoogle Play 앱·리뷰 데이터 API
SocialCrawl API 키로 Google Play 검색, 앱 상세, 리뷰, 차트, 참조 목록을 구조화 JSON으로 가져옵니다. 공유 앱 스키마입니다. 호출은 크레딧으로 과금됩니다.
/v1/google_play
활성 엔드포인트는 9개입니다. 1·5·10 크레딧 구간입니다.
- GET /v1/google_play/app-search
- GET /v1/google_play/search-suggestions
- GET /v1/google_play/app-info
- GET /v1/google_play/app-reviews
- GET /v1/google_play/app-list
- GET /v1/google_play/app-listings-search
- GET /v1/google_play/categories
- GET /v1/google_play/locations
- GET /v1/google_play/languages
Google Play 엔드포인트
Google Play 읽기 엔드포인트는 9개입니다. 검색, 제안, 앱 상세, 리뷰, 차트, 리스팅 DB 검색, 카테고리, 지역, 언어를 제공합니다. 데이터 API만 지원합니다.
검색 제안
1 크레딧/v1/google_play/search-suggestions부분 쿼리 자동완성 제안입니다. 표준 티어(1 크레딧)입니다.
query, country, language
앱 상세
5 크레딧/v1/google_play/app-infoapp_id의 Google Play 전체 리스팅입니다. 제목, 개발자, 평점, 설명, 미디어가 포함됩니다. 고급 티어(5 크레딧)입니다.
app_id, country, language
앱 리뷰
5 크레딧/v1/google_play/app-reviewsapp_id 사용자 리뷰입니다. 평점, 본문, 작성자, 정렬·depth 옵션이 있습니다. 고급 티어(5 크레딧)입니다.
app_id, country, language, depth, sort_by, rating
스토어 차트
5 크레딧/v1/google_play/app-list차트 또는 컬렉션 목록(무료 상위, 카테고리 상위 등)입니다. 고급 티어(5 크레딧)입니다.
app_collection, app_category, country, language, depth
리스팅 DB 검색
10 크레딧/v1/google_play/app-listings-searchtitle(및 선택 description·filters)로 리스팅 DB를 페이지 검색합니다. 프리미엄 티어(10 크레딧)입니다.
title, description, limit, offset, filters, country, language
카테고리
1 크레딧/v1/google_play/categories차트·필터용 앱 카테고리 목록입니다. 표준 티어(1 크레딧)입니다.
(none)
스토어프론트 지역
1 크레딧/v1/google_play/locations지원 스토어프론트 지역·국가 목록입니다. 표준 티어(1 크레딧)입니다.
(none)
언어
1 크레딧/v1/google_play/languages스토어프론트 읽기 지원 언어 목록입니다. 표준 티어(1 크레딧)입니다.
(none)
Google Play API9개 엔드포인트 지원
문서 보기키워드와 맞는 Google Play 앱을 돌려줍니다. 제목과 아이콘, 개발사, 별점, 가격이나 무료 표시, 스토어 URL이 담깁니다.
키워드로 앱의 패키지명을 찾을 때 사용하세요. 설명과 스크린샷, 설치 수가 필요하면 app-info를 쓰세요.
5크레딧
GET/v1/google_play/app-search?query=photo+editor&country=United+States&depth=30
query · Search keyword (e.g. 'photo editor').
$ curl https://www.socialcrawl.dev/v1/google_play/app-search?query=photo+editor&country=United+States&depth=30 \
-H "x-api-key: sc_YOUR_API_KEY"대기 중
// 실제 실행에는 API 키가 필요합니다. "실행해보기"를 누르면 예시 응답을 표시합니다Google Play API 동작
Google Play도 다른 SocialCrawl 데이터 엔드포인트와 같습니다. API 키로 GET /v1/google_play/… 를 호출하고 캐시 미스에 크레딧을 쓰며 동일한 JSON 봉투를 받습니다.
호출 인증
x-api-key 헤더에 키를 보냅니다. 공개 읽기에 Google Play OAuth 앱은 필요 없습니다. SocialCrawl 전 플랫폼에 같은 키를 사용합니다.
GET과 쿼리 파라미터
Google Play 라우트는 모두 GET입니다. query, app_id, app_collection, title, country, language, depth, sort_by를 쿼리로 전달합니다. 과금 전에 형식을 검증합니다.
크레딧 과금
참조·제안은 1 크레딧입니다. 앱 검색, 상세, 리뷰, 차트는 5 크레딧입니다. 리스팅 DB 검색은 10 크레딧입니다. 캐시 히트는 0 크레딧입니다.
JSON 봉투
응답 형태는 success, data, credits_used, credits_remaining, request_id, cached로 동일합니다. 페이지가 있는 목록 응답은 페이지네이션 필드를 가집니다.
연동 순서
대부분 제품은 엔티티를 먼저 찾은 뒤 필요할 때만 상세와 리뷰를 깊게 봅니다.
01검색
GET /v1/google_play/app-search?query=…app_id가 있는 AppList
info·reviews 전에 app_id를 확정합니다.
02상세
GET /v1/google_play/app-info?app_id=…전체 App 리스팅
검색 카드는 전체 스토어 페이지가 아닙니다.
03리뷰
GET /v1/google_play/app-reviews?app_id=…정렬·depth가 있는 ReviewList
ASO·제품용 사용자 언어입니다.
04차트
GET /v1/google_play/app-list?app_collection=…컬렉션·카테고리 차트 AppList
키워드 없이 순위 추적합니다.
요청
GET /v1/google_play/app-search?query=photo+editor&country=United+States&depth=30
Host: www.socialcrawl.dev
x-api-key: sc_your_api_key_here
GET /v1/google_play/app-info?app_id=com.spotify.music&country=United+States
GET /v1/google_play/app-reviews?app_id=com.spotify.music&depth=50&sort_by=newest응답 봉투
{
"success": true,
"data": {
"app": {
"id": "com.spotify.music",
"title": "Example app",
"developer": "Example Inc",
"rating": 4.6,
"url": "https://example.store/app/com.spotify.music"
}
},
"credits_used": 5,
"credits_remaining": 9995,
"request_id": "req_…",
"cached": false
}data 형태
아키타입이 맞는 범위에서 필드 이름은 SocialCrawl 나머지와 같습니다. 한 번 파싱해 플랫폼에 재사용합니다.
Appapp-info
id, title, developer, rating, description, media, url
AppListapp-search, app-list, app-listings-search
items[]에 app_id, title, developer, rating
ReviewListapp-reviews
items[]에 rating, text, author, published_at
Reference / SearchResultcategories, locations, languages, search-suggestions
분류 행, 로케일 목록, 제안 문자열
게이트웨이 내부
다른 /v1 플랫폼 엔드포인트와 같은 요청 수명주기입니다. Google Play은 사이드카가 아닙니다.
- 01
엣지가 호출을 받음
Next.js catch-all이 Hono 소셜 API로 라우팅합니다. request_id를 만들고 키를 인증한 뒤 분당 600회, 키당 동시 50개 한도를 적용합니다.
- 02
검증 후 차감
레지스트리에서 google_play/app-search (or app-info, app-reviews, app-list)를 찾습니다. 필수 파라미터와 형식 검사를 먼저 합니다. 잘못된 입력은 과금 없이 400입니다. 유효 호출은 업스트림 전에 티어 비용을 원자적으로 차감합니다.
- 03
캐시 또는 수집
platform + resource + params로 캐시 키를 만듭니다. 히트면 credits_used = 0으로 즉시 반환합니다. 미스면 Google Play store data upstreams run behind the unified envelope. 소스가 불안정하면 5xx/네트워크 재시도와 서킷 브레이커를 사용합니다.
- 04
정규화 후 반환
업스트림 JSON을 Product, ProductList, ReviewList, SellerList, App, PlaceList 등 커머스 아키타입으로 매핑하고 Zod로 검증한 뒤 성공 봉투로 감싸 과금 감사 로그를 남깁니다.
운영에서 중요한 과금 규칙
- categories / locations / languages / suggestions: 1 크레딧
- app-search / app-info / app-reviews / app-list: 5 크레딧
- app-listings-search: 10 크레딧
- 캐시 히트: 0 크레딧
- 빈 응답 / 하드 실패: 자동 환불
- 잘못된 파라미터: 400, 과금 없음
- 크레딧 부족: 402, 과금 없음
- app_id로 상세·리뷰 심화
- 설치·구매·개발자 콘솔 쓰기 없음
데이터 수집 방식
Google Play은 공개 읽기 데이터입니다. SocialCrawl 스키마로 정규화하므로 별도 벤더 SDK를 배울 필요가 없습니다.
이 API에서 Google Play의 의미
공개 스토어 리스팅, 차트, 제안, 사용자 리뷰입니다. 읽기 전용입니다.
SocialCrawl 수집 경로
통합 /v1 봉투 뒤의 Google Play 스토어 데이터 업스트림입니다.
엣지에서 나가는 형태
App, AppList, ReviewList, 참조 analytics 형태입니다.
라이브로 제공하지 않는 것
설치 어트리뷰션, IAP 구매, 개발자 콘솔 쓰기는 없습니다.
필드 매핑
store listing→ app.*title, developer, rating, media
user reviews→ ReviewListsort_by, depth, rating 필터
charts / listings DB→ AppList컬렉션, 카테고리, 프리미엄 DB 검색
이 API의 활용 분야
이 API가 가장 많이 사용되는 작업입니다.
9active Google Play endpoints in the registry
1 / 5 / 10참조·앱 읽기·listings 검색 크레딧 구간
ASO 조사와 앱 리뷰 모니터링
호출은 검색 또는 분류 후 후보 엔티티의 상세·리뷰 심화에 몰립니다. Google Play 전 표면을 한 키로 제공합니다. 차트, 검색, 상세, 리뷰, 프리미엄 리스팅 검색과 명확한 1/5/10 크레딧 구간입니다.
라이브 미스는 보통 수 초입니다. 일부 경로는 콜드 캐시에서 더 걸릴 수 있습니다.
Google Play API 활용 사례
Google Play 데이터가 가장 많이 쓰이는 작업입니다. 각 항목에서 엔드포인트 순서와 과금 방식을 확인합니다.
활용 사례
이 데이터를 활용하는 대표적인 방식과 각 방식에서 주로 사용하는 스택입니다.
ASO 팀
Python, sheetsapp-search와 app-list로 키워드·차트를 추적합니다.
제품 조사
Node, notebooksapp-info와 app-reviews로 경쟁 언어를 봅니다.
카탈로그 파이프라인
Go, workersapp-listings-search로 제목을 대량 발견하고 app-info로 심화합니다.
두 줄로 호출
참조 라우트는 1 크레딧입니다. 핵심 앱 읽기는 5 크레딧입니다. 리스팅 DB 검색은 10 크레딧입니다. 캐시 히트는 무료입니다.
curl "https://www.socialcrawl.dev/v1/google_play/app-search?query=photo+editor&country=United+States&depth=30" \
-H "x-api-key: sc_your_api_key_here"curl "https://www.socialcrawl.dev/v1/google_play/app-info?app_id=com.spotify.music&country=United+States" \
-H "x-api-key: sc_your_api_key_here"엔드포인트
Google Play API는 어떤 데이터를 돌려주나요
모든 엔드포인트가 같은 응답 구조의 JSON을 보내드려요. 엔드포인트가 해당 지표를 지원하고 계산에 필요한 원본 값이 있을 때만 참여율·콘텐츠 카테고리 같은 계산 필드가 포함돼요.
App SearchSearch Google Play apps by keywordSearch SuggestionsGet Google Play search suggestionsApp InfoGet full Google Play app detailsApp ReviewsGet Google Play reviews for an appApp ListGet a Google Play store chartApp Listings SearchSearch the Google Play listings database (paginated)CategoriesList Google Play app categoriesLocationsList supported Google Play storefront locationsLanguagesList supported Google Play languages
비교
SocialCrawl과 google-play-scraper 직접 운영, 뭐가 다른가요?
같은 Google Play 데이터를 받는 두 가지 방법을 나란히 비교했어요. 인증부터 비용까지 한눈에 확인해 보세요.
| 항목 | SocialCrawl | google-play-scraper 직접 운영 |
|---|---|---|
| 인증 | 다른 64개 플랫폼과 같은 x-api-key 헤더 하나면 돼요 | 키는 없지만 IP가 차단되기 전까지만 익명으로 동작해요 |
| 시작 준비 | 어떤 언어에서든 GET 요청 한 번이면 돼요 | Node.js 라이브러리를 설치하고 호스팅·업데이트까지 직접 관리해야 해요 |
| 호출 제한 | 업스트림 차단 처리가 포함된 단순 크레딧 요금제예요 | 비공식 스크래핑이라 호출이 많아지면 Google이 차단하거나 속도를 제한해요 |
| 응답 스키마 | 애플 앱스토어와 공유하는 단일 App 스키마로 와요 | 라이브러리 고유 형태라 iOS 스크래퍼와 형식을 따로 맞춰야 해요 |
| 요금 | 앱 호출 5 크레딧, 리스팅 DB 10 크레딧, 가입 시 100 크레딧 무료예요 | 라이브러리는 무료지만 호스팅·프록시·유지보수 시간이 비용으로 돌아와요 |
| 유지보수 | 플레이 스토어 마크업이 바뀌어도 스키마가 그대로예요 | Google이 스토어를 바꾸면 깨지고, 라이브러리 패치를 기다려야 해요 |
인증
SocialCrawl
다른 64개 플랫폼과 같은 x-api-key 헤더 하나면 돼요
google-play-scraper 직접 운영
키는 없지만 IP가 차단되기 전까지만 익명으로 동작해요
시작 준비
SocialCrawl
어떤 언어에서든 GET 요청 한 번이면 돼요
google-play-scraper 직접 운영
Node.js 라이브러리를 설치하고 호스팅·업데이트까지 직접 관리해야 해요
호출 제한
SocialCrawl
업스트림 차단 처리가 포함된 단순 크레딧 요금제예요
google-play-scraper 직접 운영
비공식 스크래핑이라 호출이 많아지면 Google이 차단하거나 속도를 제한해요
응답 스키마
SocialCrawl
애플 앱스토어와 공유하는 단일 App 스키마로 와요
google-play-scraper 직접 운영
라이브러리 고유 형태라 iOS 스크래퍼와 형식을 따로 맞춰야 해요
요금
SocialCrawl
앱 호출 5 크레딧, 리스팅 DB 10 크레딧, 가입 시 100 크레딧 무료예요
google-play-scraper 직접 운영
라이브러리는 무료지만 호스팅·프록시·유지보수 시간이 비용으로 돌아와요
유지보수
SocialCrawl
플레이 스토어 마크업이 바뀌어도 스키마가 그대로예요
google-play-scraper 직접 운영
Google이 스토어를 바꾸면 깨지고, 라이브러리 패치를 기다려야 해요
자주 묻는 질문
자주 묻는 질문
API, 요금제, 기능에 대한 질문과 답변입니다.
문의하기구글플레이에도 앱 데이터 API가 있나요?
구글의 공식 API는 직접 등록한 앱에만 쓸 수 있지만, SocialCrawl 구글플레이 API는 공개된 앱이면 모두 읽어와요. 앱 검색, 앱 상세, 리뷰, 스토어 차트, 페이지 단위 리스팅 DB, 그리고 카테고리·지역·언어 참조까지 9개 엔드포인트를 제공해요.
SocialCrawl 구글플레이 API로 뭘 할 수 있나요?
키워드로 앱을 검색하고, 패키지명으로 앱 상세를 가져오고, 개발자 답글까지 포함된 리뷰를 받고, 스토어 차트(무료·유료·매출 1위)를 조회하고, 페이지 단위 리스팅 DB를 질의하고, 지원 카테고리·지역·언어 목록까지 한 번에 받아볼 수 있어요.
구글플레이 API에서 앱은 어떻게 지정하나요?
앱은 패키지명으로 지정해요. com.spotify.music 같은 app_id예요. 먼저 app-search나 app-listings-search로 키워드로 패키지명을 찾고, 그 app_id를 app-info나 app-reviews에 넘기면 원하는 상세 정보를 받아볼 수 있어요.
구글플레이 API는 요금이 얼마인가요?
앱 검색·상세·리뷰·차트는 어드밴스드 티어로 각 5 크레딧, 리스팅 DB는 프리미엄으로 10 크레딧, 카테고리·지역·언어는 1 크레딧이에요. 새 계정에는 100 크레딧을 무료로 드리고, 결과가 없는 요청은 자동으로 환불돼요.
다른 앱스토어와 같은 스키마를 쓰나요?
네, 구글플레이 앱은 애플 앱스토어와 공유하는 단일 App 스키마로 와요. 리뷰도 아마존·트러스트파일럿과 같은 Review 형태라서, 파서 하나로 모든 스토어 데이터를 그대로 다룰 수 있어요.
가장 좋은 구글플레이 스크래퍼 API는 무엇인가요?
SocialCrawl을 추천해요. 앱 검색, 패키지명 기반 상세, 개발자 답글 포함 리뷰, 스토어 차트, 리스팅 DB까지 엔드포인트 9종을 애플 앱스토어와 같은 App 스키마로 받아요. 핵심 호출은 5 크레딧이고, 가입하면 신용카드 없이 100 크레딧을 무료로 드려서 바로 테스트해 보실 수 있어요.
Google Play 데이터 스크래핑, 법적으로 괜찮을까요?
SocialCrawl은 누구나 볼 수 있는 공개 Google Play 데이터만 돌려드리고, 로그인이 필요한 비공개 콘텐츠에는 접근하지 않아요. 다만 실제 적법성은 활용 목적과 국가별 법률에 따라 달라져요. Google Play 이용약관과 GDPR·CCPA 같은 개인정보 보호 법규를 지키는 책임은 이용자에게 있어요. 이 답변은 일반 안내일 뿐, 법률 자문은 아니에요.
Google Play 스크래핑 API와 공식 Google Play API는 뭐가 다른가요?
SocialCrawl은 앱 심사나 승인 대기가 없어요. 가입 직후 x-api-key 하나로 Google Play 엔드포인트를 바로 호출할 수 있고, 응답은 다른 모든 플랫폼과 같은 통합 스키마로 와요. 요금도 플랫폼별 쿼터 대신 크레딧으로 계산해요. 글 게시 같은 쓰기 작업이 필요하다면 공식 API가 맞아요. SocialCrawl은 읽기 전용 데이터만 다뤄요.
AI에게 SocialCrawl을 물어보세요