자체 방문 통계는 항상 수집됩니다. 사용자가 공개 페이지를 어떻게 이용하는지 파악하는 데 쓰이는 Google Analytics(로그인한 워크스페이스는 제외)는 동의한 경우에만 사용됩니다. 자세한 내용은 개인정보 처리방침을 참고하세요.

Google Play API

애플리케이션 패키지 이름으로 모바일 앱 세부 정보, 버전 정보, 개발자 답변, 사용자 리뷰를 가져옵니다.

앱 프로필과 리뷰에는 Android 패키지 이름을 사용합니다. 전체 스토어 URL은 패키지 식별자를 대신하지 않습니다.

플랫폼 가용성

24시간 상태
정상
정상

최근 30일

제공 기능

각 Google Play 액션의 기능, 가격, 최근 24시간 상태를 확인할 수 있습니다. 액션을 열면 파라미터, 응답 필드, 코드 예제를 볼 수 있습니다.

기능설명1,000건당24시간 상태
검색search앱 이름이나 용도로 Google Play 앱을 검색합니다.요청 1,000개당 $1.39정상
앱 상세 정보profile패키지 이름으로 Google Play의 Android 앱 하나를 조회합니다.요청 1,000개당 $1.39정상
리뷰reviewsGoogle Play에서 Android 앱의 사용자 리뷰를 가져오며, 리뷰별 점수, 본문, 좋아요 수, 앱 버전, 언어, 개발자 답변이 포함됩니다.요청 1,000개당 $1.39정상
앱 키워드 순위keywords_for_appapp_id에 패키지 이름을 넣어 Android 앱 하나가 순위에 오른 Google Play 검색 키워드를 나열합니다.요청 1,000개당 $11.51정상
지표 일괄 조회bulk_metricsapp_ids에 com.spotify.music 같은 패키지 이름을 넣어 Android 앱 최대 20개의 키워드 순위 집계를 한 번의 요청으로 가져옵니다.요청 1,000개당 $11.51정상
경쟁사competitorsapp_id에 패키지 이름을 넣어 같은 검색 키워드를 두고 Android 앱 하나와 경쟁하는 Google Play 앱을 나열합니다.요청 1,000개당 $11.51정상
도서bookskeyword에 제목, 저자, 주제를 넣어 Google Play 도서 섹션을 검색합니다.요청 1,000개당 $0.56정상
게임games인기 차트(무료, 유료, 최고 매출), GAME_PUZZLE 같은 게임 카테고리, 검색어로 Google Play Android 게임을 탐색합니다.요청 1,000개당 $0.56정상
키워드 교집합keyword_intersection공통으로 순위에 오른 Google Play 검색 키워드로 Android 앱 2~10개를 비교하며, 패키지 이름은 app_ids에 전달합니다.요청 1,000개당 $11.51정상

기능을 열면 파라미터, 응답 필드, 코드 샘플을 확인하고 직접 사용해 볼 수 있습니다.

Google Play 액션별로 어떤 입력을 받나요?

아래 각 답변은 호출 가능한 액션 하나와 실제 입력값을 짝지어 보여 줍니다. 파라미터의 의미와 허용 값은 액션마다 다릅니다. 익숙한 이름이라도 모든 플랫폼에서 같은 의미를 갖지는 않습니다.

공식 출처 링크는 옆에 있는 플랫폼 용어를 설명하기 위한 것입니다. 플랫폼의 승인이나 보증을 의미하지 않으며, 이 페이지에 명시되지 않은 공식 사이트의 기능은 EveryInfra API에 포함되지 않습니다.

액션필수선택전달 방식한도1,000건당응답 필드
search

검색

앱 이름이나 용도로 Google Play 앱을 검색합니다. 패키지 ID, 개발자, 평점, 설치 수 구간, 가격, 카테고리, 콘텐츠 등급, 최종 업데이트일을 가져옵니다. 상세 정보와 리뷰를 조회할 때는 반환된 app_id를 사용하세요. installs는 정확한 수가 아닌 구간의 하한값입니다.

keywordcountry, language, page_tokenSync 응답카탈로그 값: defaultLimit=20, maxLimit=100. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. 다음 페이지를 가져오려면 next_page_token을 page_token으로 전달하고 다른 파라미터는 그대로 두세요. 페이지 하나당 호출 1회입니다. 한 페이지는 최대 100행입니다.요청 1,000개당 $1.39app_id · url · name · summary · description · developer · developer_email · developer_website · score · rating_count · review_count · installs · min_installs · price · is_free · currency · category · content_rating · contains_ads · offers_iap · version · released · updated_at · android_version · icon_url · header_image_url · privacy_policy · platform · screenshots · rating_histogram
profile

앱 상세 정보

패키지 이름으로 Google Play의 Android 앱 하나를 조회합니다. 버전, 최소 Android 버전, 가격, 광고 포함 여부, 인앱 구매, 평점 분포, 개인정보 처리방침을 가져옵니다. 전체 링크가 아닌 Play URL의 ?id= 뒤 값(예: com.example.app)을 전달하세요.

app_idcountry, languageSync 응답—요청 1,000개당 $1.39app_id · url · name · summary · description · developer · developer_email · developer_website · score · rating_count · review_count · installs · min_installs · price · is_free · currency · category · content_rating · contains_ads · offers_iap · version · released · updated_at · android_version · icon_url · header_image_url · privacy_policy · platform · screenshots · rating_histogram
reviews

리뷰

Google Play에서 Android 앱의 사용자 리뷰를 가져오며, 리뷰별 점수, 본문, 좋아요 수, 앱 버전, 언어, 개발자 답변이 포함됩니다. newest 또는 top_rated로 정렬하고 page_token으로 페이지를 넘기며, 최대 200행까지 가져올 수 있습니다.

app_idcountry, language, page_token, sortSync 응답카탈로그 값: defaultLimit=40, maxLimit=200. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. 다음 페이지를 가져오려면 next_page_token을 page_token으로 전달하고 다른 파라미터는 그대로 두세요. 페이지 하나당 호출 1회입니다. 한 페이지는 최대 200행입니다.요청 1,000개당 $1.39id · app_id · text · title · score · author_name · author_avatar_url · thumbs_up · reply_text · reply_at · app_version · language · url · posted_at · platform
keywords_for_app

앱 키워드 순위

app_id에 패키지 이름을 넣어 Android 앱 하나가 순위에 오른 Google Play 검색 키워드를 나열합니다. 키워드별 검색량, 검색 결과 내 앱 순위, 수치의 최종 업데이트 시점이 앱의 평점, 가격과 함께 제공됩니다. 미국 스토어만 지원하며, 키워드별 전체 결과 수는 제공되지 않습니다. 기본 20개, 최대 100개입니다.

app_idcountrySync 응답카탈로그 값: defaultLimit=20, maxLimit=100. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. 더 큰 limit도 허용되지만 최대 100까지만 적용됩니다.요청 1,000개당 $11.51keyword · search_volume · search_rank · search_result_count · ranked_at · app_id · title · url · icon_url · developer · rating · rating_scale · rating_count · is_free · price · currency · total_keywords · platform
bulk_metrics

지표 일괄 조회

app_ids에 com.spotify.music 같은 패키지 이름을 넣어 Android 앱 최대 20개의 키워드 순위 집계를 한 번의 요청으로 가져옵니다. 각 행에는 앱이 순위에 오른 Google Play 검색 키워드 수, 그중 1위·상위 3위·상위 10위 키워드 수, 합산 검색량이 포함됩니다. 미국 스토어만 지원하며, 키워드 데이터가 없는 앱은 행이 생성되지 않습니다.

app_idscountrySync 응답—요청 1,000개당 $11.51app_id · keyword_count · top1_keywords · top3_keywords · top10_keywords · keywords_search_volume · platform
competitors

경쟁사

app_id에 패키지 이름을 넣어 같은 검색 키워드를 두고 Android 앱 하나와 경쟁하는 Google Play 앱을 나열합니다. 각 행에는 공유 키워드, 해당 키워드의 평균 순위, 공유 상위 10위 키워드, 공유 검색량이 경쟁 앱 자체의 키워드 집계와 함께 표시됩니다. 미국 스토어만 지원하며 앱 이름 대신 패키지 ID가 제공됩니다. 기본 20개, 최대 100개입니다.

app_idcountrySync 응답카탈로그 값: defaultLimit=20, maxLimit=100. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. 더 큰 limit도 허용되지만 최대 100까지만 적용됩니다.요청 1,000개당 $11.51app_id · shared_keywords · avg_position · shared_top10_keywords · shared_search_volume · keyword_count · top10_keywords · target_app_id · platform
books

도서

keyword에 제목, 저자, 주제를 넣어 Google Play 도서 섹션을 검색합니다. 도서별 ID, 저자, 형식, 카테고리, 평점, 가격과 통화, 표지, 설명이 포함됩니다. country로 스토어를, language로 언어를 선택하세요. 최대 40권이 한 페이지로 제공되며 페이지네이션은 없습니다.

keywordcountry, languageSync 응답카탈로그 값: defaultLimit=20, maxLimit=40. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. 더 큰 limit도 허용되지만 최대 40까지만 적용됩니다.요청 1,000개당 $0.56book_id · title · author · url · format · category · rating · rating_scale · price · currency · cover_url · description · platform
games

게임

인기 차트(무료, 유료, 최고 매출), GAME_PUZZLE 같은 게임 카테고리, 검색어로 Google Play Android 게임을 탐색합니다. chart, category, keyword 중 하나만 지정하세요. 아무것도 지정하지 않으면 무료 인기 차트가 반환됩니다. 게임별 순위, 패키지 ID, 개발자, 점수, 설치 수 구간, 가격, 설명이 포함됩니다. 기본 20개, 최대 50개이며 한 페이지만 제공됩니다.

category, chart, country, keyword, languageSync 응답카탈로그 값: defaultLimit=20, maxLimit=50. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. 더 큰 limit도 허용되지만 최대 50까지만 적용됩니다.요청 1,000개당 $0.56rank · app_id · name · url · developer · category · score · installs · price · is_free · currency · icon_url · description · platform
keyword_intersection

키워드 교집합

공통으로 순위에 오른 Google Play 검색 키워드로 Android 앱 2~10개를 비교하며, 패키지 이름은 app_ids에 전달합니다. 각 행은 공유 keyword 하나와 그 검색량, 그리고 rankings에 담긴 앱별 순위와 제목으로 구성됩니다. 미국 스토어만 지원하며, Google Play는 키워드별 결과 수를 제공하지 않습니다. 기본 20개, 최대 100개입니다.

app_idscountrySync 응답카탈로그 값: defaultLimit=20, maxLimit=100. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. 더 큰 limit도 허용되지만 최대 100까지만 적용됩니다.요청 1,000개당 $11.51keyword · search_volume · ranked_at · rankings · total_keywords · platform

Google Play search 파라미터는 각각 무엇을 의미하나요?

앱 이름이나 용도로 Google Play 앱을 검색합니다. 패키지 ID, 개발자, 평점, 설치 수 구간, 가격, 카테고리, 콘텐츠 등급, 최종 업데이트일을 가져옵니다. 상세 정보와 리뷰를 조회할 때는 반환된 app_id를 사용하세요. installs는 정확한 수가 아닌 구간의 하한값입니다.

전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태
keyword필수
Google Play 앱 이름 또는 용도 쿼리입니다(예: note taking). 정확한 패키지 이름 조회가 아닙니다. 앱 상세 정보와 리뷰에는 app_id를 사용하세요.
country선택
us 같은 소문자 코드로 Google Play 스토어의 국가 또는 지역을 선택합니다. 기본값은 us입니다. search와 profile에서는 조회할 스토어를 바꿀 뿐, 사용자의 휴대폰 지역이나 개발자 국적을 바꾸지 않습니다. reviews에서는 반환되는 리뷰가 바뀌지 않습니다. 리뷰는 language에 따라서만 달라지므로, 언어가 같으면 us와 gb는 같은 리뷰를 반환합니다. 시장별 리뷰를 비교하려면 country만 바꾸지 말고 language를 바꾸세요.
language선택
Play 스토어 콘텐츠와 리뷰 조회에 사용할 언어를 선택합니다(예: en, zh). 기본값은 en입니다. 국가를 자동으로 바꾸지 않으며, 반환된 모든 리뷰가 해당 언어로 작성되었다고 보장하지 않습니다.
page_token선택
페이지네이션 토큰입니다. 다음 페이지를 가져오려면 이전 응답의 next_page_token을 다시 전달하고, 첫 페이지에서는 생략하세요. 다른 파라미터는 모두 그대로 유지하세요. 토큰은 24시간 동안 유효하며 각 페이지는 호출 1건입니다.

Google Play profile 파라미터는 각각 무엇을 의미하나요?

패키지 이름으로 Google Play의 Android 앱 하나를 조회합니다. 버전, 최소 Android 버전, 가격, 광고 포함 여부, 인앱 구매, 평점 분포, 개인정보 처리방침을 가져옵니다. 전체 링크가 아닌 Play URL의 ?id= 뒤 값(예: com.example.app)을 전달하세요.

전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태
app_id필수
Play 스토어 URL의 ?id= 값에 해당하는 Android 패키지 이름입니다(예: com.example.app). Apple App Store 숫자 ID가 아닙니다. 전체 Play URL이 아닌 패키지 이름을 전달하세요.
country선택
us 같은 소문자 코드로 Google Play 스토어의 국가 또는 지역을 선택합니다. 기본값은 us입니다. search와 profile에서는 조회할 스토어를 바꿀 뿐, 사용자의 휴대폰 지역이나 개발자 국적을 바꾸지 않습니다. reviews에서는 반환되는 리뷰가 바뀌지 않습니다. 리뷰는 language에 따라서만 달라지므로, 언어가 같으면 us와 gb는 같은 리뷰를 반환합니다. 시장별 리뷰를 비교하려면 country만 바꾸지 말고 language를 바꾸세요.
language선택
Play 스토어 콘텐츠와 리뷰 조회에 사용할 언어를 선택합니다(예: en, zh). 기본값은 en입니다. 국가를 자동으로 바꾸지 않으며, 반환된 모든 리뷰가 해당 언어로 작성되었다고 보장하지 않습니다.

Google Play reviews 파라미터는 각각 무엇을 의미하나요?

Google Play에서 Android 앱의 사용자 리뷰를 가져오며, 리뷰별 점수, 본문, 좋아요 수, 앱 버전, 언어, 개발자 답변이 포함됩니다. newest 또는 top_rated로 정렬하고 page_token으로 페이지를 넘기며, 최대 200행까지 가져올 수 있습니다.

전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태
app_id필수
Play 스토어 URL의 ?id= 값에 해당하는 Android 패키지 이름입니다(예: com.example.app). Apple App Store 숫자 ID가 아닙니다. 전체 Play URL이 아닌 패키지 이름을 전달하세요.
Google Play: 앱 평점, 사용자 리뷰, 개발자 답변 — 공식 문서에 따르면 평점과 리뷰는 사용자가 수정할 수 있으며, 리뷰는 앱 버전, ‘도움이 됨’ 투표, 개발자 답변과 연결될 수 있습니다. 공개 리뷰는 검토로 인해 게시가 지연될 수 있으며, 테스트 피드백은 공개되지 않습니다. 공식 콘솔과 답변 API의 기능이 이 엔드포인트의 기능과 같은 것은 아닙니다. · 확인일
country선택
us 같은 소문자 코드로 Google Play 스토어의 국가 또는 지역을 선택합니다. 기본값은 us입니다. search와 profile에서는 조회할 스토어를 바꿀 뿐, 사용자의 휴대폰 지역이나 개발자 국적을 바꾸지 않습니다. reviews에서는 반환되는 리뷰가 바뀌지 않습니다. 리뷰는 language에 따라서만 달라지므로, 언어가 같으면 us와 gb는 같은 리뷰를 반환합니다. 시장별 리뷰를 비교하려면 country만 바꾸지 말고 language를 바꾸세요.
language선택
Play 스토어 콘텐츠와 리뷰 조회에 사용할 언어를 선택합니다(예: en, zh). 기본값은 en입니다. 국가를 자동으로 바꾸지 않으며, 반환된 모든 리뷰가 해당 언어로 작성되었다고 보장하지 않습니다.
page_token선택
페이지네이션 토큰입니다. 다음 페이지를 가져오려면 이전 응답의 next_page_token을 다시 전달하고, 첫 페이지에서는 생략하세요. 다른 파라미터는 모두 그대로 유지하세요. 토큰은 24시간 동안 유효하며 각 페이지는 호출 1건입니다.
sort선택
앱 리뷰 정렬 순서로, newest(최신 리뷰) 또는 top_rated(평점 높은 리뷰) 중 하나이며, reviews의 기본값은 newest입니다. 카탈로그에서는 search와 profile에도 이 이름이 표시되지만, 앱 검색 순위나 전체 평점 필터가 아닙니다.
허용 값:newesttop_rated

Google Play keywords_for_app 파라미터는 각각 무엇을 의미하나요?

app_id에 패키지 이름을 넣어 Android 앱 하나가 순위에 오른 Google Play 검색 키워드를 나열합니다. 키워드별 검색량, 검색 결과 내 앱 순위, 수치의 최종 업데이트 시점이 앱의 평점, 가격과 함께 제공됩니다. 미국 스토어만 지원하며, 키워드별 전체 결과 수는 제공되지 않습니다. 기본 20개, 최대 100개입니다.

전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태
app_id필수
Android 패키지 이름(예: com.spotify.music) 또는 ?id=가 포함된 앱의 play.google.com 링크입니다. Apple 숫자 ID가 아니며, 패키지 이름이 아닌 값은 호출이 실행되기 전에 거부됩니다.
country선택
keywords_for_app의 스토어 국가입니다. 미국 스토어만 지원하므로 생략하거나 us를 전달해야 합니다. 다른 국가는 호출이 실행되기 전에 거부됩니다.

Google Play bulk_metrics 파라미터는 각각 무엇을 의미하나요?

app_ids에 com.spotify.music 같은 패키지 이름을 넣어 Android 앱 최대 20개의 키워드 순위 집계를 한 번의 요청으로 가져옵니다. 각 행에는 앱이 순위에 오른 Google Play 검색 키워드 수, 그중 1위·상위 3위·상위 10위 키워드 수, 합산 검색량이 포함됩니다. 미국 스토어만 지원하며, 키워드 데이터가 없는 앱은 행이 생성되지 않습니다.

전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태
app_ids필수
bulk_metrics(1~20개) 또는 keyword_intersection(2~10개)에 사용할 앱으로, Android 패키지 이름(Play 스토어 링크에서 ?id= 뒤의 값, 예: com.spotify.music)을 배열 또는 쉼표로 구분한 문자열로 입력합니다. 미국 스토어만 지원합니다. bulk_metrics에서는 앱마다 행 하나가 반환되며 데이터가 없는 앱은 제외됩니다. keyword_intersection에서는 각 행이 모든 앱이 순위에 오른 키워드 하나입니다. 개수가 이 범위를 벗어나면 호출이 실행되기 전에 거부됩니다.
country선택
bulk_metrics의 스토어 국가입니다. 미국 스토어만 지원하므로 생략하거나 us를 전달해야 합니다. 다른 국가는 호출이 실행되기 전에 거부됩니다.

Google Play competitors 파라미터는 각각 무엇을 의미하나요?

app_id에 패키지 이름을 넣어 같은 검색 키워드를 두고 Android 앱 하나와 경쟁하는 Google Play 앱을 나열합니다. 각 행에는 공유 키워드, 해당 키워드의 평균 순위, 공유 상위 10위 키워드, 공유 검색량이 경쟁 앱 자체의 키워드 집계와 함께 표시됩니다. 미국 스토어만 지원하며 앱 이름 대신 패키지 ID가 제공됩니다. 기본 20개, 최대 100개입니다.

전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태
app_id필수
경쟁 앱을 조회할 앱의 Android 패키지 이름(예: com.spotify.music) 또는 ?id=가 포함된 play.google.com 링크입니다. Apple 숫자 ID 등 패키지 이름이 아닌 값은 호출이 실행되기 전에 거부됩니다.
country선택
competitors의 스토어 국가입니다. 미국 스토어만 지원하므로 생략하거나 us를 전달해야 합니다. 다른 국가는 호출이 실행되기 전에 거부됩니다.

Google Play books 파라미터는 각각 무엇을 의미하나요?

keyword에 제목, 저자, 주제를 넣어 Google Play 도서 섹션을 검색합니다. 도서별 ID, 저자, 형식, 카테고리, 평점, 가격과 통화, 표지, 설명이 포함됩니다. country로 스토어를, language로 언어를 선택하세요. 최대 40권이 한 페이지로 제공되며 페이지네이션은 없습니다.

전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태
keyword필수
Google Play 북에서 찾을 내용: 제목, 저자 또는 주제입니다(예: stoicism).
country선택
us 같은 소문자 코드로 Google Play 스토어의 국가 또는 지역을 선택합니다. 기본값은 us입니다. search와 profile에서는 조회할 스토어를 바꿀 뿐, 사용자의 휴대폰 지역이나 개발자 국적을 바꾸지 않습니다. reviews에서는 반환되는 리뷰가 바뀌지 않습니다. 리뷰는 language에 따라서만 달라지므로, 언어가 같으면 us와 gb는 같은 리뷰를 반환합니다. 시장별 리뷰를 비교하려면 country만 바꾸지 말고 language를 바꾸세요.
language선택
Play 스토어 콘텐츠와 리뷰 조회에 사용할 언어를 선택합니다(예: en, zh). 기본값은 en입니다. 국가를 자동으로 바꾸지 않으며, 반환된 모든 리뷰가 해당 언어로 작성되었다고 보장하지 않습니다.

Google Play games 파라미터는 각각 무엇을 의미하나요?

인기 차트(무료, 유료, 최고 매출), GAME_PUZZLE 같은 게임 카테고리, 검색어로 Google Play Android 게임을 탐색합니다. chart, category, keyword 중 하나만 지정하세요. 아무것도 지정하지 않으면 무료 인기 차트가 반환됩니다. 게임별 순위, 패키지 ID, 개발자, 점수, 설치 수 구간, 가격, 설명이 포함됩니다. 기본 20개, 최대 50개이며 한 페이지만 제공됩니다.

전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태
category선택
games에 사용할 게임 카테고리입니다(예: GAME_PUZZLE, GAME_ACTION). puzzle, action 같은 짧은 형식도 사용할 수 있습니다. chart 또는 keyword 대신 사용하며, 함께 지정하지 마세요.
chart선택
games에 사용할 게임 차트로, top_free(다른 값이 없을 때의 기본값), top_paid, top_grossing 중 하나입니다. category 또는 keyword 대신 사용하며, 함께 지정하지 마세요.
country선택
us 같은 소문자 코드로 Google Play 스토어의 국가 또는 지역을 선택합니다. 기본값은 us입니다. search와 profile에서는 조회할 스토어를 바꿀 뿐, 사용자의 휴대폰 지역이나 개발자 국적을 바꾸지 않습니다. reviews에서는 반환되는 리뷰가 바뀌지 않습니다. 리뷰는 language에 따라서만 달라지므로, 언어가 같으면 us와 gb는 같은 리뷰를 반환합니다. 시장별 리뷰를 비교하려면 country만 바꾸지 말고 language를 바꾸세요.
keyword선택
게임 검색어입니다(예: chess). chart나 category 대신 사용하며, 함께 사용하지 않습니다.
language선택
Play 스토어 콘텐츠와 리뷰 조회에 사용할 언어를 선택합니다(예: en, zh). 기본값은 en입니다. 국가를 자동으로 바꾸지 않으며, 반환된 모든 리뷰가 해당 언어로 작성되었다고 보장하지 않습니다.

Google Play keyword_intersection 파라미터는 각각 무엇을 의미하나요?

공통으로 순위에 오른 Google Play 검색 키워드로 Android 앱 2~10개를 비교하며, 패키지 이름은 app_ids에 전달합니다. 각 행은 공유 keyword 하나와 그 검색량, 그리고 rankings에 담긴 앱별 순위와 제목으로 구성됩니다. 미국 스토어만 지원하며, Google Play는 키워드별 결과 수를 제공하지 않습니다. 기본 20개, 최대 100개입니다.

전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태
app_ids필수
bulk_metrics(1~20개) 또는 keyword_intersection(2~10개)에 사용할 앱으로, Android 패키지 이름(Play 스토어 링크에서 ?id= 뒤의 값, 예: com.spotify.music)을 배열 또는 쉼표로 구분한 문자열로 입력합니다. 미국 스토어만 지원합니다. bulk_metrics에서는 앱마다 행 하나가 반환되며 데이터가 없는 앱은 제외됩니다. keyword_intersection에서는 각 행이 모든 앱이 순위에 오른 키워드 하나입니다. 개수가 이 범위를 벗어나면 호출이 실행되기 전에 거부됩니다.
country선택
keyword_intersection의 스토어 국가입니다. 미국 스토어만 지원하므로 생략하거나 us를 전달해야 합니다. 다른 국가는 호출이 실행되기 전에 거부됩니다.

Google Play API 사용 방법

  1. 01공개 카탈로그에서 플랫폼 액션을 선택합니다.
  2. 02플랫폼, 액션, 필수 파라미터를 POST /api/v1/social로 보냅니다.
  3. 03응답에서 결과를 읽습니다. 비동기 액션이면 반환된 작업 ID를 폴링합니다.
  4. 04애플리케이션에 필요한 응답 필드를 저장합니다.
google_play_search.sh
curl -X POST https://api.everyinfra.com/api/v1/social \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"platform":"google_play","action":"search","params":{"keyword":"<keyword>"}}'

Google Play 가이드

이 액션을 활용한 실제 예제와 방법입니다. 먼저 이 페이지에서 현재 액션, 파라미터, 필드를 확인하세요. 글에 나온 예제와 제한 사항은 최신 카탈로그를 대신할 수 없습니다.

Blog

리뷰 데이터를 유료 제품으로 만드는 법: 앱스토어 피드백에서 버전 결정까지

스크래핑한 리뷰로 어떻게 과금 가능한 제품을 만들 수 있을까요? 이 글은 앱스토어 리뷰 분석에서 출발해 감성 점수와 워드 클라우드를 제공하는 데 그치지 않고, 근거 카드, 지원 티켓, 버전 리뷰, 서비스 범위, 갱신 검증을 하나씩 살펴봅니다.

글 읽기
Build

통합 데이터 API 시작하기: 기능 카탈로그에서 사용 가능한 첫 결과까지

platform, action, params로 여러 플랫폼의 데이터에 접근합니다. 기능 카탈로그를 읽고, 최소한의 요청을 완료하고, 비동기 작업과 부분 결과, 과금을 처리하며, 추적 가능한 데이터 기록을 만듭니다.

글 읽기

Google Play API 자주 묻는 질문

Google Play API로 무엇을 가져올 수 있나요?

platform을 google_play 값으로 설정하세요. 현재 카탈로그에 등록된 항목은 검색, 앱 상세 정보, 리뷰, 앱 키워드 순위, 지표 일괄 조회 및 more입니다. 각 액션 이름은 서로 다른 Google Play 객체나 뷰를 가리키며, 서로 바꿔 쓸 수 있는 검색 모드가 아닙니다.

Google Play search 요청에는 어떤 입력이 필요한가요?

Google Play 앱 이름 또는 용도 쿼리입니다(예: note taking). 정확한 패키지 이름 조회가 아닙니다. 앱 상세 정보와 리뷰에는 app_id를 사용하세요. params 안의 keyword 필드로 전달하세요.

Google Play search 액션은 어떤 필드를 반환하나요?

선언된 스키마에 포함된 필드는 app_id, name, summary 및 description입니다. 선언된 필드라도 개별 레코드에는 없을 수 있으며, 다른 액션은 각각 고유한 필드 목록을 가집니다.

모든 Google Play 액션이 즉시 결과를 반환하나요?

비동기로 표시된 액션은 폴링할 작업 ID를 반환합니다. 그 밖의 모든 액션도 비동기로 실행할 수 있습니다. 요청 본문에 "mode": "async"를 추가하면 작업 ID를 즉시 받을 수 있어, 오래 걸리는 작업이나 조회 한도가 큰 요청에 유용합니다. 현재 카탈로그의 액션 구성은 sync 응답입니다.