플랫폼 가용성
- 24시간 상태
- 정상
최근 30일
제공 기능
각 App Store 액션의 기능, 가격, 최근 24시간 상태를 확인할 수 있습니다. 액션을 열면 파라미터, 응답 필드, 코드 예제를 볼 수 있습니다.
| 기능 | 설명 | 1,000건당 | 24시간 상태 |
|---|---|---|---|
검색search | 앱 이름이나 카테고리로 App Store를 검색합니다. | 요청 1,000개당 $1.39 | 정상 |
앱 상세 정보profile | 숫자 app_id로 앱 하나의 App Store 등록 정보를 가져옵니다. | 요청 1,000개당 $1.39 | 정상 |
리뷰reviews | App Store 앱의 사용자 리뷰를 읽어 옵니다. | 요청 1,000개당 $1.39 | 정상 |
앱 키워드 순위keywords_for_app | 숫자 app_id로 앱 하나가 순위에 오른 App Store 검색 키워드를 나열합니다. | 요청 1,000개당 $11.51 | 정상 |
지표 일괄 조회bulk_metrics | app_ids에 숫자 ID를 전달해 최대 20개 App Store 앱의 키워드 순위 합계를 한 번에 가져옵니다. | 요청 1,000개당 $11.51 | 정상 |
경쟁사competitors | 숫자 app_id로 지정한 앱과 같은 검색 키워드에서 순위에 오른 App Store 앱을 찾습니다. | 요청 1,000개당 $11.51 | 정상 |
키워드 교집합keyword_intersection | app_ids에 숫자 ID를 전달해 2~10개 앱이 모두 순위에 오른 App Store 검색 키워드를 확인합니다. | 요청 1,000개당 $11.51 | 정상 |
기능을 열면 파라미터, 응답 필드, 코드 샘플을 확인하고 직접 사용해 볼 수 있습니다.
App Store 액션별로 어떤 입력을 받나요?
아래 각 답변은 호출 가능한 액션 하나와 실제 입력값을 짝지어 보여 줍니다. 파라미터의 의미와 허용 값은 액션마다 다릅니다. 익숙한 이름이라도 모든 플랫폼에서 같은 의미를 갖지는 않습니다.
공식 출처 링크는 옆에 있는 플랫폼 용어를 설명하기 위한 것입니다. 플랫폼의 승인이나 보증을 의미하지 않으며, 이 페이지에 명시되지 않은 공식 사이트의 기능은 EveryInfra API에 포함되지 않습니다.
| 액션 | 필수 | 선택 | 전달 방식 | 한도 | 1,000건당 | 응답 필드 |
|---|---|---|---|---|---|---|
search검색 앱 이름이나 카테고리로 App Store를 검색합니다. 각 앱의 ID, 번들 ID, 개발자, 버전, 가격, 평점, 출시일을 가져옵니다. | keyword | country | Sync 응답 | 카탈로그 값: defaultLimit=20, maxLimit=200. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $1.39 | app_id · name · url · bundle_id · developer · developer_id · developer_url · description · release_notes · version · price · currency · formatted_price · rating · rating_scale · rating_count · current_version_rating · current_version_rating_count · content_rating · category · icon_url · min_os · file_size_bytes · released_at · updated_at · platform · genres · languages · screenshot_urls |
profile앱 상세 정보 숫자 | app_id | country | Sync 응답 | — | 요청 1,000개당 $1.39 | app_id · name · url · bundle_id · developer · developer_id · developer_url · description · release_notes · version · price · currency · formatted_price · rating · rating_scale · rating_count · current_version_rating · current_version_rating_count · content_rating · category · icon_url · min_os · file_size_bytes · released_at · updated_at · platform · genres · languages · screenshot_urls |
reviews리뷰 App Store 앱의 사용자 리뷰를 읽어 옵니다. 제목, 본문, 별점, 작성자, 앱 버전, 유용성 투표 수, 날짜가 포함됩니다. | app_id | country, sort | Sync 응답 | 카탈로그 값: defaultLimit=30, maxLimit=500. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $1.39 | id · title · text · rating · rating_scale · author · app_version · helpful_count · posted_at · app_id · app_name · platform |
keywords_for_app앱 키워드 순위 숫자 | app_id | country | Sync 응답 | 카탈로그 값: defaultLimit=20, maxLimit=100. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. 더 큰 limit도 허용되지만 최대 100까지만 적용됩니다. | 요청 1,000개당 $11.51 | keyword · 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 | country | Sync 응답 | — | 요청 1,000개당 $11.51 | app_id · keyword_count · top1_keywords · top3_keywords · top10_keywords · keywords_search_volume · platform |
competitors경쟁사 숫자 | app_id | country | Sync 응답 | 카탈로그 값: defaultLimit=20, maxLimit=100. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. 더 큰 limit도 허용되지만 최대 100까지만 적용됩니다. | 요청 1,000개당 $11.51 | app_id · shared_keywords · avg_position · shared_top10_keywords · shared_search_volume · keyword_count · top10_keywords · target_app_id · platform |
keyword_intersection키워드 교집합
| app_ids | country | Sync 응답 | 카탈로그 값: defaultLimit=20, maxLimit=100. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. 더 큰 limit도 허용되지만 최대 100까지만 적용됩니다. | 요청 1,000개당 $11.51 | keyword · search_volume · search_result_count · ranked_at · rankings · total_keywords · platform |
App Store search 파라미터는 각각 무엇을 의미하나요?
앱 이름이나 카테고리로 App Store를 검색합니다. 각 앱의 ID, 번들 ID, 개발자, 버전, 가격, 평점, 출시일을 가져옵니다. country로 스토어 국가를 선택합니다(기본값 US). 다운로드 수, 매출, 키워드 순위 이력은 포함되지 않습니다.
keyword필수- Bundle ID가 아니라 습관 트래커나 앱 이름 같은 App Store 검색어를 지정합니다. 이후 앱 상세 정보와 리뷰 요청에는 검색 결과로 반환된 숫자 app_id를 사용하세요.
country선택- search, profile, reviews에 사용할 App Store 스토어프런트를 us, cn, jp 같은 소문자 두 글자 국가 코드로 선택합니다. 기본값은 us입니다. 조회하는 스토어프런트만 바뀌며, 계정 지역이나 EveryInfra 과금은 바뀌지 않습니다.
App Store profile 파라미터는 각각 무엇을 의미하나요?
숫자 app_id로 앱 하나의 App Store 등록 정보를 가져옵니다. 개발자, 번들 ID, 버전, 릴리스 노트, 가격, 연령 등급, 현재 버전 평점이 포함됩니다. 전체 앱 링크도 사용할 수 있지만 번들 ID는 사용할 수 없습니다. 이 레코드는 App Store Connect나 이전 버전이 아닌 현재 공개된 등록 정보를 보여 줍니다.
app_id필수- Apple의 숫자 앱 식별자를 지정합니다(예: 앱 링크에서 id 뒤에 있는 숫자). App Store 앱 URL 전체를 전달해도 플랫폼이 숫자 ID를 추출합니다. com.example.app 형식의 Bundle ID는 전달하지 마세요.Apple: App Store Connect의 앱 정보 살펴보기 — Apple은 앱의 Apple ID와 번들 ID를 별도로 정의하며, Apple ID는 App Store 앱 URL에도 사용됩니다. · 확인일
country선택- search, profile, reviews에 사용할 App Store 스토어프런트를 us, cn, jp 같은 소문자 두 글자 국가 코드로 선택합니다. 기본값은 us입니다. 조회하는 스토어프런트만 바뀌며, 계정 지역이나 EveryInfra 과금은 바뀌지 않습니다.
App Store reviews 파라미터는 각각 무엇을 의미하나요?
App Store 앱의 사용자 리뷰를 읽어 옵니다. 제목, 본문, 별점, 작성자, 앱 버전, 유용성 투표 수, 날짜가 포함됩니다. newest(기본값) 또는 most_helpful로 정렬하고, country로 스토어 국가를 선택하세요.
app_id필수- Apple의 숫자 앱 식별자를 지정합니다(예: 앱 링크에서 id 뒤에 있는 숫자). App Store 앱 URL 전체를 전달해도 플랫폼이 숫자 ID를 추출합니다. com.example.app 형식의 Bundle ID는 전달하지 마세요.Apple: App Store Connect의 앱 정보 살펴보기 — Apple은 앱의 Apple ID와 번들 ID를 별도로 정의하며, Apple ID는 App Store 앱 URL에도 사용됩니다. · 확인일
country선택- search, profile, reviews에 사용할 App Store 스토어프런트를 us, cn, jp 같은 소문자 두 글자 국가 코드로 선택합니다. 기본값은 us입니다. 조회하는 스토어프런트만 바뀌며, 계정 지역이나 EveryInfra 과금은 바뀌지 않습니다.
sort선택- App Store 리뷰 표시 순서를 지정하며, 최신 리뷰는 newest, 유용한 리뷰는 most_helpful을 사용합니다. 생략하면 reviews 액션은 newest를 기본값으로 사용합니다. 이 파라미터는 앱 검색 순위나 별점을 필터링하지 않으므로, search나 profile 요청의 결과를 바꾸는 데 사용하지 마세요.허용 값:
most_helpfulnewest
App Store keywords_for_app 파라미터는 각각 무엇을 의미하나요?
숫자 app_id로 앱 하나가 순위에 오른 App Store 검색 키워드를 나열합니다. 각 키워드에는 검색량, 검색 결과에서 앱의 순위, 해당 검색이 반환하는 앱 수, 수치가 마지막으로 업데이트된 시각이 포함되며, 앱의 평점과 가격도 함께 제공됩니다. US 스토어만 지원합니다. 기본 20개, 최대 100개 키워드를 반환합니다.
app_id필수- Apple의 숫자 앱 ID(예:
324684580) 또는 앱의 apps.apple.com 링크입니다. 링크에서는 id 뒤의 숫자를 가져옵니다. com.example.app 같은 Bundle ID는 받지 않으며, 호출이 실행되기 전에 거부됩니다. country선택keywords_for_app의 스토어 국가입니다. 미국 스토어만 지원하므로 생략하거나 us를 전달해야 합니다. 다른 국가는 호출이 실행되기 전에 거부됩니다.
App Store bulk_metrics 파라미터는 각각 무엇을 의미하나요?
app_ids에 숫자 ID를 전달해 최대 20개 App Store 앱의 키워드 순위 합계를 한 번에 가져옵니다. 각 행에는 앱의 keyword_count, 그중 1위·상위 3위·상위 10위에 오른 키워드 수, 해당 키워드들의 검색량인 keywords_search_volume이 포함됩니다. US 스토어만 지원하며, 키워드 데이터가 없는 앱은 행이 반환되지 않습니다.
app_ids필수bulk_metrics(1~20개) 또는keyword_intersection(2~10개)에 쓰는 앱 목록으로, Apple 숫자 ID(앱 링크에서 id 뒤에 있는 숫자, 예:324684580)를 배열이나 쉼표로 구분한 문자열로 전달합니다. 미국 스토어만 지원합니다.bulk_metrics에서는 앱마다 행이 하나씩 생기며, 데이터가 없는 앱은 제외됩니다.keyword_intersection에서는 각 행이 모든 앱이 순위에 오른 키워드 하나입니다. 개수가 이 범위를 벗어나면 호출이 실행되기 전에 거부됩니다.country선택bulk_metrics의 스토어 국가입니다. 미국 스토어만 지원하므로 생략하거나 us를 전달해야 합니다. 다른 국가는 호출이 실행되기 전에 거부됩니다.
App Store competitors 파라미터는 각각 무엇을 의미하나요?
숫자 app_id로 지정한 앱과 같은 검색 키워드에서 순위에 오른 App Store 앱을 찾습니다. 각 경쟁 앱에는 두 앱이 공유하는 키워드 수, 해당 키워드에서의 평균 순위, 그중 상위 10위 안에 든 키워드 수와 그 합산 검색량이 자체 키워드 합계와 함께 표시됩니다. US 스토어만 지원하며, 행에는 앱 이름이 아닌 앱 ID가 담깁니다. 기본 20개, 최대 100개 경쟁 앱을 반환합니다.
app_id필수- Apple의 숫자 앱 식별자를 지정합니다(예: 앱 링크에서 id 뒤에 있는 숫자). App Store 앱 URL 전체를 전달해도 플랫폼이 숫자 ID를 추출합니다. com.example.app 형식의 Bundle ID는 전달하지 마세요.
country선택competitors의 스토어 국가입니다. 미국 스토어만 지원하므로 생략하거나 us를 전달해야 합니다. 다른 국가는 호출이 실행되기 전에 거부됩니다.
App Store keyword_intersection 파라미터는 각각 무엇을 의미하나요?
app_ids에 숫자 ID를 전달해 2~10개 앱이 모두 순위에 오른 App Store 검색 키워드를 확인합니다. 각 행은 공통 keyword 하나와 그 검색량, 해당 검색이 반환하는 앱 수이며, rankings에 각 앱의 순위와 제목이 담깁니다. US 스토어만 지원합니다. 기본 20개, 최대 100개 키워드를 반환합니다.
app_ids필수bulk_metrics(1~20개) 또는keyword_intersection(2~10개)에 쓰는 앱 목록으로, Apple 숫자 ID(앱 링크에서 id 뒤에 있는 숫자, 예:324684580)를 배열이나 쉼표로 구분한 문자열로 전달합니다. 미국 스토어만 지원합니다.bulk_metrics에서는 앱마다 행이 하나씩 생기며, 데이터가 없는 앱은 제외됩니다.keyword_intersection에서는 각 행이 모든 앱이 순위에 오른 키워드 하나입니다. 개수가 이 범위를 벗어나면 호출이 실행되기 전에 거부됩니다.country선택keyword_intersection의 스토어 국가입니다. 미국 스토어만 지원하므로 생략하거나 us를 전달해야 합니다. 다른 국가는 호출이 실행되기 전에 거부됩니다.
App Store API 사용 방법
- 01공개 카탈로그에서 플랫폼 액션을 선택합니다.
- 02플랫폼, 액션, 필수 파라미터를 POST /api/v1/social로 보냅니다.
- 03응답에서 결과를 읽습니다. 비동기 액션이면 반환된 작업 ID를 폴링합니다.
- 04애플리케이션에 필요한 응답 필드를 저장합니다.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"app_store","action":"search","params":{"keyword":"<keyword>"}}'
App Store 가이드
이 액션을 활용한 실제 예제와 방법입니다. 먼저 이 페이지에서 현재 액션, 파라미터, 필드를 확인하세요. 글에 나온 예제와 제한 사항은 최신 카탈로그를 대신할 수 없습니다.
리뷰 데이터를 유료 제품으로 만드는 법: 앱스토어 피드백에서 버전 결정까지
스크래핑한 리뷰로 어떻게 과금 가능한 제품을 만들 수 있을까요? 이 글은 앱스토어 리뷰 분석에서 출발해 감성 점수와 워드 클라우드를 제공하는 데 그치지 않고, 근거 카드, 지원 티켓, 버전 리뷰, 서비스 범위, 갱신 검증을 하나씩 살펴봅니다.
글 읽기통합 데이터 API 시작하기: 기능 카탈로그에서 사용 가능한 첫 결과까지
platform, action, params로 여러 플랫폼의 데이터에 접근합니다. 기능 카탈로그를 읽고, 최소한의 요청을 완료하고, 비동기 작업과 부분 결과, 과금을 처리하며, 추적 가능한 데이터 기록을 만듭니다.
글 읽기App Store API 자주 묻는 질문
App Store API로 무엇을 가져올 수 있나요?
platform을 app_store 값으로 설정하세요. 현재 카탈로그에 등록된 항목은 검색, 앱 상세 정보, 리뷰, 앱 키워드 순위, 지표 일괄 조회 및 more입니다. 각 액션 이름은 서로 다른 App Store 객체나 뷰를 가리키며, 서로 바꿔 쓸 수 있는 검색 모드가 아닙니다.
App Store search 요청에는 어떤 입력이 필요한가요?
Bundle ID가 아니라 습관 트래커나 앱 이름 같은 App Store 검색어를 지정합니다. 이후 앱 상세 정보와 리뷰 요청에는 검색 결과로 반환된 숫자 app_id를 사용하세요. params 안의 keyword 필드로 전달하세요.
App Store search 액션은 어떤 필드를 반환하나요?
선언된 스키마에 포함된 필드는 app_id, name, bundle_id 및 developer입니다. 선언된 필드라도 개별 레코드에는 없을 수 있으며, 다른 액션은 각각 고유한 필드 목록을 가집니다.
모든 App Store 액션이 즉시 결과를 반환하나요?
비동기로 표시된 액션은 폴링할 작업 ID를 반환합니다. 그 밖의 모든 액션도 비동기로 실행할 수 있습니다. 요청 본문에 "mode": "async"를 추가하면 작업 ID를 즉시 받을 수 있어, 오래 걸리는 작업이나 조회 한도가 큰 요청에 유용합니다. 현재 카탈로그의 액션 구성은 sync 응답입니다.