API 목록으로 돌아가기
Apple App Store 공개 데이터

Apple App Store API

이미 알고 있는 스토어 URL에서 공개 Apple App Store 앱 상세 정보, 카테고리 순위, 리뷰를 정규화된 앱·리뷰 레코드로 수집합니다.

사용할 수 있는 Apple App Store API

이미 알고 있는 앱 페이지에는 App Detail, 공개 차트 URL에는 Rankings, 이미 알고 있는 앱 URL의 공개 사용자 의견에는 App Reviews를 사용합니다.

어떤 Apple App Store 데이터를 가져올 수 있나요?

현재 엔드포인트는 공개 앱 페이지의 필드를 공통 앱 결과 스키마에 보존하며, 제공되지 않는 값은 비워 둡니다.

앱 식별 정보

제공되는 앱 ID, 이름, 개발자, 카테고리, 출처 URL, 설명 텍스트를 가져옵니다.

공개된 앱 페이지 신호

제공되는 평점, 리뷰 수, 가격, 순위, 게시 관련 정보를 특정 시점의 값으로 보존합니다.

미디어와 관측 시점

제공되는 앱 페이지 미디어를 collected_at과 함께 저장해, 레코드가 관측 시점의 맥락을 유지하도록 합니다.

Apple App Store API 사양 개요

각 엔드포인트는 이미 알고 있는 공개 URL과 표준 비동기 작업 결과 리더를 사용합니다.

엔드포인트입력원본 범위
App Detail상품 페이지 URL 하나 이상제출한 URL 하나당 정규화된 앱 레코드 최대 1건
Rankings카테고리 또는 순위 URL, 선택적 results_limit제출한 차트에 노출된 앱
App Reviews앱 URL, 선택적 results_limit제출한 앱의 공개 리뷰

Apple App Store API 작동 방식

세 엔드포인트 모두 표준 비동기 작업 흐름을 따릅니다.

  1. 1. 알고 있는 앱 페이지 URL 제출

    알맞은 엔드포인트를 골라 필수 urls 배열과 선택 사항인 결과 제한을 POST하고, task_id를 저장합니다.

  2. 2. 작업 추적

    작업이 성공하거나 실패할 때까지 /v1/tasks/{task_id}를 폴링합니다.

  3. 3. 저장된 레코드 읽기

    data.results.items를 읽고, has_more가 true인 동안에만 next_cursor를 따라갑니다.

공개 앱 페이지 메타데이터 가져오기

SocQ API 키로 인증하고, 이미 알고 있는 Apple App Store 상품 페이지 URL을 하나 이상 제출합니다.

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

Apple App Store API 주요 활용 사례

카탈로그 정보 보강

알고 있는 앱 레코드에 정규화된 식별 정보, 설명 메타데이터, 개발자, 카테고리, 가격, 미디어, 출처 정보를 추가합니다.

앱 페이지 비교

준비한 URL 집합에서 제공되는 메타데이터, 공개된 평점, 리뷰 수, 가격을 비교합니다.

스냅샷 모니터링

반복 수집한 결과를 collected_at과 함께 저장해 공개 앱 페이지 필드의 변화를 시간에 따라 비교합니다.

제한 사항과 공개 데이터 정책

Apple App Store 결과는 특정 시점의 공개 앱 페이지 레코드이며, 앱 게시나 계정 관리 기능은 제공하지 않습니다.

  • 제출하는 모든 URL은 apps.apple.com 또는 그 서브도메인이어야 합니다.
  • 이 API는 키워드나 번들 ID만으로는 조회할 수 없고, 알고 있는 스토어 URL을 받습니다.
  • App Detail은 URL당 결과를 최대 1건 저장하며, Rankings와 App Reviews는 작업 전체에 적용되는 1부터 2,000까지의 results_limit을 받습니다.
  • 작업 결과 커서는 SocQ에 이미 저장된 레코드만 페이지 단위로 넘깁니다.
  • 최종 요금은 저장된 결과 1건당 0.15 크레딧이며 기본 요금은 0 크레딧입니다. 예상치는 선택한 엔드포인트에 따라 달라집니다.

Apple App Store API 자주 묻는 질문

Apple App Store API란 무엇인가요?

Apple App Store API는 알고 있는 스토어 URL에서 앱 상세 정보를 가져오고, 카테고리 순위와 공개 앱 리뷰를 수집합니다.

키워드로 앱을 검색할 수 있나요?

아니요. 현재 요청은 알고 있는 Apple App Store 상품 또는 차트 URL이 담긴, 비어 있지 않은 배열에서 시작합니다.

원본 데이터의 페이지네이션을 지원하나요?

호출자가 쓸 수 있는 원본 커서는 없습니다. 작업 결과 커서는 수집 후 저장된 레코드만 페이지 단위로 넘깁니다.

수집 요금은 어떻게 되나요?

저장된 결과 1건당 0.15 크레딧이 차감됩니다. 최종 요금은 실제 결과 수를 기준으로 하며, 예상치는 선택한 엔드포인트에 따라 달라집니다.

여러 플랫폼의 공개 프로필, 콘텐츠, 참여도 데이터를 하나의 워크플로로 모으면 브랜드, 크리에이터, 주제를 추적하고 플랫폼 간 모니터링과 분석을 더 효율적으로 진행할 수 있습니다.

SEO API

실시간 Google 오가닉 검색 결과를 조회하고, 키워드 수요와 순위 난이도를 비교하고, 시드 키워드를 확장하고, 사이트의 검색 노출을 이끄는 키워드와 페이지를 찾고, 검색 의도를 분류하며, Google 뉴스·이미지·자동완성과 Bing, YouTube 결과를 모읍니다. 모든 엔드포인트가 같은 SocQ API 키, 비동기 작업 흐름, 정규화된 결과 형식을 사용합니다.

Telegram API

t.me 링크로 공개 텔레그램 채널을 읽습니다. 구독자 수가 담긴 채널 정보, 조회수와 반응이 담긴 게시물, 개별 게시물, 토론 그룹 댓글, 추천 채널, 전체 기록 검색을 지원합니다.

Link in Bio API

크리에이터가 Instagram, TikTok, YouTube 소개란에 넣는 링크 하나를 표시 이름, 소개, 프로필 사진, 공개된 연락처 이메일, 연결된 SNS 프로필, 각 버튼의 제목과 연결 주소라는 구조화된 데이터로 바꿉니다.

Creator API

Instagram, TikTok, YouTube, X, Facebook, Threads 프로필 하나에서 출발해 크리에이터의 공개 비즈니스 이메일, 다른 SNS 계정, 프로필 사진 기반 나이·성별 추정을 가져옵니다.

Google Hotels API

목적지로 호텔을 검색하고, 원하는 호텔의 구글 호텔 프로필 전체와 1박 요금 캘린더를 가져옵니다. 세 API는 같은 호텔 ID로 연결됩니다.

Brand Monitoring API

브랜드, 제품, 주제를 언급한 웹 페이지를 찾아 페이지마다 감성과 감정을 점수로 매기고, 웹 전체에서 어떻게 이야기되는지 요약합니다.