Apple App Store App Reviews
Apple App Store 앱 리뷰는 작성된 본문, 평점, 작성자 정보, 게시 시각, 리뷰 대상 앱 링크를 담은 공개 고객 피드백 레코드입니다. 이러한 레코드는 피드백 분석, 평점 비교, 앱 카탈로그 정보 보강, 시계열 모니터링에 활용할 수 있습니다.
Apple App Store App Reviews API 주요 기능
- 알고 있는 앱 URL 일괄 입력apps.apple.com 상품 URL을 하나의 작업에 하나 이상 제출하고, 해당 요청에서 저장할 리뷰 레코드 전체에 results_limit 하나를 설정합니다.
- 정규화된 공개 리뷰 레코드공용 리뷰 스키마를 통해 리뷰 텍스트, 숫자 평점, 작성자 정보, 선택적 미디어, 안정적인 레코드 필드를 읽습니다.
- 앱·수집 정보확인 가능한 각 리뷰를 대상 식별자 또는 앱 URL과 연결하고, 게시·수집 타임스탬프를 유지해 추적 가능한 스냅샷을 만듭니다.
Apple App Store App Reviews API 매개변수
| 매개변수 | 필수 | 설명 |
|---|---|---|
urls | 필수 | 비어 있지 않은 앱 참조의 필수 목록으로, 파싱된 호스트 이름은 apps.apple.com 또는 그 서브도메인이어야 합니다. 절대 URL과 프로토콜 상대 값을 허용하며, 플레이그라운드에서는 쉼표 또는 줄바꿈으로 구분합니다. |
results_limit | 선택 | 작업에 저장되는 리뷰 레코드의 총 개수를 제한하는 1~2,000 범위의 양의 정수이며 선택 항목입니다. 백엔드 기본값은 100입니다. |
Apple App Store App Reviews API 사용 방법
알고 있는 앱 URL을 제출하고, 비동기 작업을 추적한 뒤, 완료된 작업에 저장된 리뷰 레코드를 페이지 단위로 읽습니다.
- 파싱된 호스트 이름이 apps.apple.com인 앱 참조를 하나 이상 준비하고, 필요하면 1~2,000 범위에서 results_limit을 정합니다.
- 페이로드를 /v1/apple-app-store/app-reviews로 POST하고, 반환된 task_id를 저장합니다.
- status가 succeeded 또는 failed가 될 때까지 GET /v1/tasks/{task_id}를 폴링합니다.
- data.results.items를 읽고, has_more가 true인 동안 next_cursor로 이어서 요청합니다.
curl -X POST "https://api.socq.ai/v1/apple-app-store/app-reviews" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://apps.apple.com/us/app/chatgpt/id6448311069"]}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueApple App Store App Reviews API 추천 활용 사례
- 앱 피드백 검토: 작성된 리뷰 텍스트, 평점 값, 작성자 정보로 알고 있는 앱 페이지에 대해 반환된 공개 피드백을 살펴봅니다.
- 앱 간 평점 비교: 정규화된 레코드를 대상 식별자 또는 앱 URL 기준으로 묶은 뒤, 제출한 앱들의 평점 분포를 비교합니다.
- 리뷰 타임라인 스냅샷: 리뷰 ID와 함께 게시·수집 타임스탬프를 보관해, 새로 수집한 레코드와 이전 스냅샷을 구분합니다.
Apple App Store App Reviews API 활용 팁
- 제출 전에 모든 입력의 호스트 이름이 apps.apple.com인지 확인하세요. 서브도메인과 프로토콜 상대 참조는 허용되지만 다른 호스트는 거부됩니다.
- results_limit은 앱별이 아니라 작업 전체를 기준으로 정하세요. 생략하면 100이 적용되며 허용 범위는 2,000까지입니다.
- next_cursor는 저장된 SocQ 결과를 추가로 읽을 때만 사용하세요. 다른 공급자 페이지를 요청하거나 원본 수집을 이어 가지 않습니다.
- 누락된 본문, 작성자 정보, 평점, 앱 참조, 미디어는 알 수 없는 값으로 취급하고, 이후 화면에서는 null 필드를 표시하지 않는 것이 좋습니다.
관련 API
Apple App Store App Reviews API 외에 Apple App Store의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.
- Apple App Store App Detail API — 알고 있는 App Store 등록 URL에서 정규화된 공개 앱 정보, 설명 메타데이터, 개발자 및 카테고리 맥락, 공개된 평점, 가격, 미디어를 가져옵니다.
- Apple App Store Rankings API — 지원되는 Apple App Store URL에서 공개 카테고리 차트 항목을 수집하며, 출처 순위, 앱 정보, 개발자, 평점, 리뷰 수, 가격, 미디어 필드를 포함합니다.