Apple App Store App Detail
Apple App Store의 앱 페이지는 앱 식별 정보, 설명 문구, 개발자·카테고리 정보, 공개된 평점, 가격, 미디어를 담은 공개 상품 페이지입니다. 이러한 필드는 카탈로그 정보 보강, 앱 페이지 비교, 특정 시점의 메타데이터 모니터링에 활용할 수 있습니다.
Apple App Store App Detail API 주요 기능
- 알고 있는 URL 일괄 입력apps.apple.com 상품 페이지 URL을 하나 이상 제출하면, 정리된 URL마다 공급자 입력이 하나씩 만들어지고 제출한 URL당 정규화된 앱 레코드는 최대 1건만 유지됩니다.
- 앱 식별 정보와 설명 메타데이터앱 ID, 이름, 설명 텍스트, 개발자, 카테고리, 원본 URL, 수집 시각을 일관된 앱 스키마로 반환합니다.
- 공개된 평점·가격 정보확인 가능한 평점, 리뷰 수, 구조화된 가격 필드를 보존하므로 상품 페이지 텍스트를 파싱하지 않고도 앱 레코드를 비교할 수 있습니다.
- 미디어와 카탈로그 정보확인 가능한 미디어를 게시·수집 타임스탬프와 함께 유지하며, 공개 페이지에 노출되지 않는 스키마 값은 제외합니다.
Apple App Store App Detail API 매개변수
| 매개변수 | 필수 | 설명 |
|---|---|---|
urls | 필수 | 알고 있는 상품 페이지 URL을 하나 이상 담은 필수 배열입니다. 비어 있지 않은 모든 항목은 apps.apple.com 또는 그 서브도메인으로 확인되어야 하며, 이 엔드포인트는 키워드, 번들 ID, 국가 입력을 받지 않습니다. |
Apple App Store App Detail API 사용 방법
알고 있는 앱 페이지 URL을 제출하고, 비동기 작업을 따라간 뒤, 저장된 결과 페이지에서 정규화된 앱 레코드를 읽습니다.
- 호스트 이름이 apps.apple.com 또는 그 서브도메인인 공개 Apple App Store 상품 페이지 URL을 하나 이상 준비합니다.
- urls 배열을 /v1/apple-app-store/app-detail로 POST하고, 반환된 task_id를 저장합니다.
- 작업이 성공하거나 실패를 반환할 때까지 /v1/tasks/{task_id}를 폴링합니다.
- data.results.items에서 앱 레코드를 읽고, has_more가 true일 때만 next_cursor를 따라갑니다.
curl -X POST "https://api.socq.ai/v1/apple-app-store/app-detail" \
-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 only while has_more is trueApple App Store App Detail API 추천 활용 사례
- 앱 카탈로그 정보 보강: 이미 App Store 링크가 들어 있는 레코드에 정규화된 앱 식별 정보, 설명 메타데이터, 개발자, 카테고리, 가격, 미디어, 원본 URL을 추가합니다.
- 앱 페이지 비교: 선택한 URL 묶음에서 개발자·카테고리 정보, 공개된 평점, 리뷰 수, 가격, 설명 문구를 비교합니다.
- 메타데이터 스냅샷 모니터링: 반복 수집한 결과를 collected_at과 함께 저장해, 이름, 설명, 카테고리, 공개된 평점, 가격, 미디어의 시간에 따른 변화를 파악합니다.
Apple App Store App Detail API 활용 팁
- 파싱된 호스트 이름이 모두 apps.apple.com인지 확인하고, 검색어, 번들 ID, 스토어 이름 대신 상품 페이지 URL을 제출하세요.
- 중복 URL은 제출 전에 제거하세요. 그래야 같은 입력이 반복되어 불필요한 공급자 행이나 중복된 앱 레코드가 생기지 않습니다.
- 앱 페이지에 앱 스키마의 일부만 노출될 수 있으므로 rating, reviews_count, price, media, published_at, installs, rank는 null일 수 있는 값으로 취급하세요.
- next_cursor를 App Store 원본의 페이지 토큰으로 취급하지 마세요. 완료된 SocQ 작업에 이미 저장된 결과 안에서만 이동합니다.
관련 API
Apple App Store App Detail API 외에 Apple App Store의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.
- Apple App Store App Reviews API — 알고 있는 apps.apple.com URL에서 공개 앱 리뷰를 수집하며, 정규화된 텍스트, 평점, 리뷰어 정보, 타임스탬프, 앱 참조를 포함합니다.
- Apple App Store Rankings API — 지원되는 Apple App Store URL에서 공개 카테고리 차트 항목을 수집하며, 출처 순위, 앱 정보, 개발자, 평점, 리뷰 수, 가격, 미디어 필드를 포함합니다.