apple-app-store/
app-detail

알고 있는 apps.apple.com URL에서 공개 Apple App Store 앱 정보를 조회하여 앱 식별 정보, 설명, 개발자 정보, 평점, 가격, 미디어를 정규화된 레코드로 반환합니다.

Apple App Store App Detail API

알고 있는 앱 페이지 URL
정규화된 앱 레코드
공개 상품 페이지 메타데이터
결과당 0.15 크레딧
준비됨
준비됨

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

README

SocQ 작성 · 업데이트

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을 제출하고, 비동기 작업을 따라간 뒤, 저장된 결과 페이지에서 정규화된 앱 레코드를 읽습니다.

  1. 호스트 이름이 apps.apple.com 또는 그 서브도메인인 공개 Apple App Store 상품 페이지 URL을 하나 이상 준비합니다.
  2. urls 배열을 /v1/apple-app-store/app-detail로 POST하고, 반환된 task_id를 저장합니다.
  3. 작업이 성공하거나 실패를 반환할 때까지 /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-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 true

Apple 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 작업에 이미 저장된 결과 안에서만 이동합니다.

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

다른 플랫폼 둘러보기

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

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

Apple App Store App Detail API는 알고 있는 Apple App Store 상품 페이지 URL에서 공개 메타데이터를 가져오는 프로그래밍 인터페이스입니다. 정규화된 앱 식별 정보, 설명, 개발자·카테고리 정보, 공개된 평점, 가격, 미디어, 수집 시각을 반환합니다.

파싱된 호스트 이름이 apps.apple.com 또는 그 서브도메인인 상품 페이지 참조를 담은, 비어 있지 않은 urls 배열을 제출합니다. 이 엔드포인트는 키워드, 번들 ID, 국가 코드, results_limit 필드를 받지 않습니다.

정규화된 레코드에는 앱 ID, 이름, 설명 텍스트, 개발자, 카테고리, 평점, 리뷰 수, 설치 수, 구조화된 가격, 순위, 미디어, 원본 URL, 게시 시각, 수집 시각이 포함될 수 있습니다. 공개 페이지에 없는 필드는 null로 유지되므로 화면에 표시할 때는 제외하는 것이 좋습니다.

아니요. 공급자는 제출한 URL마다 입력 행을 하나씩 받고, 작업은 URL당 정규화된 레코드를 최대 1건만 유지합니다. next_cursor와 has_more는 저장된 SocQ 결과 조회에만 해당합니다.

요청 시 예상 결과 1건당 0.15 크레딧으로 제출한 URL 수만큼 추정 금액을 산정합니다. 최종 요금은 정상적으로 저장된 정규화 결과 수를 기준으로 하며, 빈 작업은 0 크레딧 기본 요금으로 정산됩니다.