apple-app-store/
app-reviews

하나 이상의 apps.apple.com URL에서 공개 Apple App Store 리뷰를 수집하여 리뷰 텍스트, 평점, 작성자 정보, 타임스탬프, 앱 정보를 정규화된 레코드로 반환합니다.

Apple App Store App Reviews API

알고 있는 앱 URL
공개 리뷰 텍스트와 평점
작성자·앱 정보
결과당 0.15 크레딧
준비됨
준비됨

매개변수를 입력하고 요청을 전송하세요. 작업 상태와 정규화된 결과가 여기에 표시됩니다.

README

SocQ 작성 · 업데이트

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을 제출하고, 비동기 작업을 추적한 뒤, 완료된 작업에 저장된 리뷰 레코드를 페이지 단위로 읽습니다.

  1. 파싱된 호스트 이름이 apps.apple.com인 앱 참조를 하나 이상 준비하고, 필요하면 1~2,000 범위에서 results_limit을 정합니다.
  2. 페이로드를 /v1/apple-app-store/app-reviews로 POST하고, 반환된 task_id를 저장합니다.
  3. status가 succeeded 또는 failed가 될 때까지 GET /v1/tasks/{task_id}를 폴링합니다.
  4. 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 true

Apple 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 필드를 표시하지 않는 것이 좋습니다.

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에서 공개 카테고리 차트 항목을 수집하며, 출처 순위, 앱 정보, 개발자, 평점, 리뷰 수, 가격, 미디어 필드를 포함합니다.

다른 플랫폼 둘러보기

Apple App Store 데이터를 지원되는 다른 소셜 플랫폼의 공개 데이터와 함께 활용하세요.

Apple App Store App Reviews API — 자주 묻는 질문

Apple App Store App Reviews API는 알고 있는 Apple App Store 앱 URL에서 공개 고객 리뷰를 수집하는 프로그래밍 인터페이스입니다. 정규화된 리뷰 텍스트, 평점, 작성자 정보, 타임스탬프, 미디어, 확인 가능한 앱 참조를 반환합니다.

urls는 필수이며, 파싱된 호스트 이름이 apps.apple.com 또는 그 서브도메인인 비어 있지 않은 참조를 하나 이상 담아야 합니다. 절대 URL과 프로토콜 상대 형식을 허용합니다. results_limit은 선택 항목이며 기본값은 100이고 1~2,000 범위의 정수를 받습니다.

아니요. results_limit은 제출한 URL 목록 전체에 걸쳐 작업에 저장되는 총 레코드 수를 제한하므로, 앱마다 독립된 상한이 필요하면 수집 목표를 별도 작업으로 나누세요.

아니요. next_cursor는 작업이 성공한 뒤 SocQ에 이미 저장된 레코드를 페이지 단위로 넘기는 값이며, 공개 요청에는 원본의 추가 페이지를 가져오는 공급자 커서가 제공되지 않습니다.

정상적으로 저장된 리뷰 1건당 0.15 SocQ 크레딧이 차감되며, results_limit을 생략하면 100건 기준으로 추정합니다. 설정된 기본 요금이 0이므로 저장된 리뷰가 없는 작업에는 결과 요금이 없습니다.