앱 검색
5 크레딧/v1/app_store/app-searchApple App Store 키워드 검색입니다. info·reviews용 id가 있는 앱 카드입니다. 고급 티어(5 크레딧)입니다.
query, country, language, depth
Apple App Store APIApp Store 앱·리뷰 데이터 API
SocialCrawl API 키로 Apple App Store 검색, 앱 상세, 리뷰, 차트, 참조 목록을 구조화 JSON으로 가져옵니다. 공유 앱 스키마입니다. 호출은 크레딧으로 과금됩니다.
/v1/app_store
활성 엔드포인트는 9개입니다. 1·5·10 크레딧 구간입니다.
- GET /v1/app_store/app-search
- GET /v1/app_store/search-suggestions
- GET /v1/app_store/app-info
- GET /v1/app_store/app-reviews
- GET /v1/app_store/app-list
- GET /v1/app_store/app-listings-search
- GET /v1/app_store/categories
- GET /v1/app_store/locations
- GET /v1/app_store/languages
Apple App Store 엔드포인트
Apple App Store 읽기 엔드포인트는 9개입니다. 검색, 제안, 앱 상세, 리뷰, 차트, 리스팅 DB 검색, 카테고리, 지역, 언어를 제공합니다. 데이터 API만 지원합니다.
검색 제안
1 크레딧/v1/app_store/search-suggestions부분 쿼리 자동완성 제안입니다. 표준 티어(1 크레딧)입니다.
query, country, language
앱 상세
5 크레딧/v1/app_store/app-infoapp_id의 Apple App Store 전체 리스팅입니다. 제목, 개발자, 평점, 설명, 미디어가 포함됩니다. 고급 티어(5 크레딧)입니다.
app_id, country, language
앱 리뷰
5 크레딧/v1/app_store/app-reviewsapp_id 사용자 리뷰입니다. 평점, 본문, 작성자, 정렬·depth 옵션이 있습니다. 고급 티어(5 크레딧)입니다.
app_id, country, language, depth, sort_by, rating
스토어 차트
5 크레딧/v1/app_store/app-list차트 또는 컬렉션 목록(무료 상위, 카테고리 상위 등)입니다. 고급 티어(5 크레딧)입니다.
app_collection, app_category, country, language, depth
리스팅 DB 검색
10 크레딧/v1/app_store/app-listings-searchtitle(및 선택 description·filters)로 리스팅 DB를 페이지 검색합니다. 프리미엄 티어(10 크레딧)입니다.
title, description, limit, offset, filters, country, language
카테고리
1 크레딧/v1/app_store/categories차트·필터용 앱 카테고리 목록입니다. 표준 티어(1 크레딧)입니다.
(none)
스토어프론트 지역
1 크레딧/v1/app_store/locations지원 스토어프론트 지역·국가 목록입니다. 표준 티어(1 크레딧)입니다.
(none)
언어
1 크레딧/v1/app_store/languages스토어프론트 읽기 지원 언어 목록입니다. 표준 티어(1 크레딧)입니다.
(none)
App Store API9개 엔드포인트 지원
문서 보기키워드와 맞는 Apple App Store 앱을 돌려줍니다. 제목과 아이콘, 별점, 가격이나 무료 표시, 스토어 URL이 담깁니다.
키워드로 앱의 숫자 id를 찾을 때 사용하세요. 설명과 스크린샷, 개발사가 필요하면 app-info를 쓰세요.
5크레딧
GET/v1/app_store/app-search?query=photo+editor&country=United+States&depth=100
query · Search keyword (e.g. 'photo editor').
$ curl https://www.socialcrawl.dev/v1/app_store/app-search?query=photo+editor&country=United+States&depth=100 \
-H "x-api-key: sc_YOUR_API_KEY"대기 중
// 실제 실행에는 API 키가 필요합니다. "실행해보기"를 누르면 예시 응답을 표시합니다Apple App Store API 동작
Apple App Store도 다른 SocialCrawl 데이터 엔드포인트와 같습니다. API 키로 GET /v1/app_store/… 를 호출하고 캐시 미스에 크레딧을 쓰며 동일한 JSON 봉투를 받습니다.
호출 인증
x-api-key 헤더에 키를 보냅니다. 공개 읽기에 Apple App Store OAuth 앱은 필요 없습니다. SocialCrawl 전 플랫폼에 같은 키를 사용합니다.
GET과 쿼리 파라미터
Apple App Store 라우트는 모두 GET입니다. query, app_id, app_collection, title, country, language, depth, sort_by를 쿼리로 전달합니다. 과금 전에 형식을 검증합니다.
크레딧 과금
참조·제안은 1 크레딧입니다. 앱 검색, 상세, 리뷰, 차트는 5 크레딧입니다. 리스팅 DB 검색은 10 크레딧입니다. 캐시 히트는 0 크레딧입니다.
JSON 봉투
응답 형태는 success, data, credits_used, credits_remaining, request_id, cached로 동일합니다. 페이지가 있는 목록 응답은 페이지네이션 필드를 가집니다.
연동 순서
대부분 제품은 엔티티를 먼저 찾은 뒤 필요할 때만 상세와 리뷰를 깊게 봅니다.
01검색
GET /v1/app_store/app-search?query=…app_id가 있는 AppList
info·reviews 전에 app_id를 확정합니다.
02상세
GET /v1/app_store/app-info?app_id=…전체 App 리스팅
검색 카드는 전체 스토어 페이지가 아닙니다.
03리뷰
GET /v1/app_store/app-reviews?app_id=…정렬·depth가 있는 ReviewList
ASO·제품용 사용자 언어입니다.
04차트
GET /v1/app_store/app-list?app_collection=…컬렉션·카테고리 차트 AppList
키워드 없이 순위 추적합니다.
요청
GET /v1/app_store/app-search?query=photo+editor&country=United+States&depth=30
Host: www.socialcrawl.dev
x-api-key: sc_your_api_key_here
GET /v1/app_store/app-info?app_id=324684580&country=United+States
GET /v1/app_store/app-reviews?app_id=324684580&depth=50&sort_by=most_recent응답 봉투
{
"success": true,
"data": {
"app": {
"id": "324684580",
"title": "Example app",
"developer": "Example Inc",
"rating": 4.6,
"url": "https://example.store/app/324684580"
}
},
"credits_used": 5,
"credits_remaining": 9995,
"request_id": "req_…",
"cached": false
}data 형태
아키타입이 맞는 범위에서 필드 이름은 SocialCrawl 나머지와 같습니다. 한 번 파싱해 플랫폼에 재사용합니다.
Appapp-info
id, title, developer, rating, description, media, url
AppListapp-search, app-list, app-listings-search
items[]에 app_id, title, developer, rating
ReviewListapp-reviews
items[]에 rating, text, author, published_at
Reference / SearchResultcategories, locations, languages, search-suggestions
분류 행, 로케일 목록, 제안 문자열
게이트웨이 내부
다른 /v1 플랫폼 엔드포인트와 같은 요청 수명주기입니다. Apple App Store은 사이드카가 아닙니다.
- 01
엣지가 호출을 받음
Next.js catch-all이 Hono 소셜 API로 라우팅합니다. request_id를 만들고 키를 인증한 뒤 분당 600회, 키당 동시 50개 한도를 적용합니다.
- 02
검증 후 차감
레지스트리에서 app_store/app-search (or app-info, app-reviews, app-list)를 찾습니다. 필수 파라미터와 형식 검사를 먼저 합니다. 잘못된 입력은 과금 없이 400입니다. 유효 호출은 업스트림 전에 티어 비용을 원자적으로 차감합니다.
- 03
캐시 또는 수집
platform + resource + params로 캐시 키를 만듭니다. 히트면 credits_used = 0으로 즉시 반환합니다. 미스면 Apple App Store store data upstreams run behind the unified envelope. 소스가 불안정하면 5xx/네트워크 재시도와 서킷 브레이커를 사용합니다.
- 04
정규화 후 반환
업스트림 JSON을 Product, ProductList, ReviewList, SellerList, App, PlaceList 등 커머스 아키타입으로 매핑하고 Zod로 검증한 뒤 성공 봉투로 감싸 과금 감사 로그를 남깁니다.
운영에서 중요한 과금 규칙
- categories / locations / languages / suggestions: 1 크레딧
- app-search / app-info / app-reviews / app-list: 5 크레딧
- app-listings-search: 10 크레딧
- 캐시 히트: 0 크레딧
- 빈 응답 / 하드 실패: 자동 환불
- 잘못된 파라미터: 400, 과금 없음
- 크레딧 부족: 402, 과금 없음
- app_id로 상세·리뷰 심화
- 설치·구매·개발자 콘솔 쓰기 없음
데이터 수집 방식
Apple App Store은 공개 읽기 데이터입니다. SocialCrawl 스키마로 정규화하므로 별도 벤더 SDK를 배울 필요가 없습니다.
이 API에서 Apple App Store의 의미
공개 스토어 리스팅, 차트, 제안, 사용자 리뷰입니다. 읽기 전용입니다.
SocialCrawl 수집 경로
통합 /v1 봉투 뒤의 Apple App Store 스토어 데이터 업스트림입니다.
엣지에서 나가는 형태
App, AppList, ReviewList, 참조 analytics 형태입니다.
라이브로 제공하지 않는 것
설치 어트리뷰션, IAP 구매, 개발자 콘솔 쓰기는 없습니다.
필드 매핑
store listing→ app.*title, developer, rating, media
user reviews→ ReviewListsort_by, depth, rating 필터
charts / listings DB→ AppList컬렉션, 카테고리, 프리미엄 DB 검색
이 API의 활용 분야
이 API가 가장 많이 사용되는 작업입니다.
9active Apple App Store endpoints in the registry
1 / 5 / 10참조·앱 읽기·listings 검색 크레딧 구간
ASO 조사와 앱 리뷰 모니터링
호출은 검색 또는 분류 후 후보 엔티티의 상세·리뷰 심화에 몰립니다. Apple App Store 전 표면을 한 키로 제공합니다. 차트, 검색, 상세, 리뷰, 프리미엄 리스팅 검색과 명확한 1/5/10 크레딧 구간입니다.
라이브 미스는 보통 수 초입니다. 일부 경로는 콜드 캐시에서 더 걸릴 수 있습니다.
Apple App Store API 활용 사례
Apple App Store 데이터가 가장 많이 쓰이는 작업입니다. 각 항목에서 엔드포인트 순서와 과금 방식을 확인합니다.
활용 사례
이 데이터를 활용하는 대표적인 방식과 각 방식에서 주로 사용하는 스택입니다.
ASO 팀
Python, sheetsapp-search와 app-list로 키워드·차트를 추적합니다.
제품 조사
Node, notebooksapp-info와 app-reviews로 경쟁 언어를 봅니다.
카탈로그 파이프라인
Go, workersapp-listings-search로 제목을 대량 발견하고 app-info로 심화합니다.
두 줄로 호출
참조 라우트는 1 크레딧입니다. 핵심 앱 읽기는 5 크레딧입니다. 리스팅 DB 검색은 10 크레딧입니다. 캐시 히트는 무료입니다.
curl "https://www.socialcrawl.dev/v1/app_store/app-search?query=photo+editor&country=United+States&depth=30" \
-H "x-api-key: sc_your_api_key_here"curl "https://www.socialcrawl.dev/v1/app_store/app-info?app_id=324684580&country=United+States" \
-H "x-api-key: sc_your_api_key_here"엔드포인트
App Store API는 어떤 데이터를 돌려주나요
모든 엔드포인트가 같은 응답 구조의 JSON을 보내드려요. 엔드포인트가 해당 지표를 지원하고 계산에 필요한 원본 값이 있을 때만 참여율·콘텐츠 카테고리 같은 계산 필드가 포함돼요.
App SearchSearch Apple App Store apps by keywordSearch SuggestionsGet Apple App Store search suggestionsApp InfoGet full Apple App Store app detailsApp ReviewsGet Apple App Store reviews for an appApp ListGet an Apple App Store chartApp Listings SearchSearch the Apple App Store listings database (paginated)CategoriesList Apple App Store app categoriesLocationsList supported Apple App Store storefront locationsLanguagesList supported Apple App Store languages
비교
SocialCrawl과 iTunes Search API + 직접 구축, 뭐가 다른가요?
같은 App Store 데이터를 받는 두 가지 방법을 나란히 비교했어요. 인증부터 비용까지 한눈에 확인해 보세요.
| 항목 | SocialCrawl | iTunes Search API + 직접 구축 |
|---|---|---|
| 인증 | 65개 플랫폼과 공유하는 x-api-key 헤더 하나면 돼요 | iTunes Search는 키가 없지만, 리뷰는 RSS나 스크래핑을 따로 얹어야 해요 |
| 시작 준비 | GET 한 번으로 검색·상세·리뷰·차트까지 해결돼요 | 조회·검색은 잘 되지만 리뷰와 차트는 직접 구축해야 해요 |
| 호출 제한 | 업스트림 처리가 포함된 단순 크레딧 요금제예요 | 분당 약 20회 수준으로 제한되고 유료 업그레이드 경로가 없어요 |
| 응답 스키마 | 구글플레이와 공유하는 단일 App 스키마로 와요 | iTunes JSON, 리뷰 RSS, 차트 피드의 형식이 제각각이에요 |
| 요금 | 앱 호출 5 크레딧, 리스팅 DB 10 크레딧, 가입 시 100 크레딧 무료예요 | 무료지만 리뷰·차트 레이어를 직접 만들고 유지해야 해요 |
| 데이터 범위 | 검색·상세·리뷰·차트·리스팅·참조 데이터를 API 하나로 받아요 | 조회와 검색만 지원하고 리뷰·차트·리스팅은 포함되지 않아요 |
인증
SocialCrawl
65개 플랫폼과 공유하는 x-api-key 헤더 하나면 돼요
iTunes Search API + 직접 구축
iTunes Search는 키가 없지만, 리뷰는 RSS나 스크래핑을 따로 얹어야 해요
시작 준비
SocialCrawl
GET 한 번으로 검색·상세·리뷰·차트까지 해결돼요
iTunes Search API + 직접 구축
조회·검색은 잘 되지만 리뷰와 차트는 직접 구축해야 해요
호출 제한
SocialCrawl
업스트림 처리가 포함된 단순 크레딧 요금제예요
iTunes Search API + 직접 구축
분당 약 20회 수준으로 제한되고 유료 업그레이드 경로가 없어요
응답 스키마
SocialCrawl
구글플레이와 공유하는 단일 App 스키마로 와요
iTunes Search API + 직접 구축
iTunes JSON, 리뷰 RSS, 차트 피드의 형식이 제각각이에요
요금
SocialCrawl
앱 호출 5 크레딧, 리스팅 DB 10 크레딧, 가입 시 100 크레딧 무료예요
iTunes Search API + 직접 구축
무료지만 리뷰·차트 레이어를 직접 만들고 유지해야 해요
데이터 범위
SocialCrawl
검색·상세·리뷰·차트·리스팅·참조 데이터를 API 하나로 받아요
iTunes Search API + 직접 구축
조회와 검색만 지원하고 리뷰·차트·리스팅은 포함되지 않아요
자주 묻는 질문
자주 묻는 질문
API, 요금제, 기능에 대한 질문과 답변입니다.
문의하기애플 앱스토어에도 앱 데이터 API가 있나요?
애플의 공식 App Store Connect API는 직접 등록한 앱에만 쓸 수 있지만, SocialCrawl 앱스토어 API는 공개된 iOS 앱이면 모두 읽어와요. 앱 검색, 앱 상세, 리뷰, 스토어 차트, 페이지 단위 리스팅 DB, 그리고 카테고리·지역·언어 참조까지 9개 엔드포인트를 제공해요.
SocialCrawl 앱스토어 API로 뭘 할 수 있나요?
키워드로 앱을 검색하고, 숫자 앱 id로 앱 상세를 가져오고, 평점과 제목이 담긴 리뷰를 받고, 스토어 차트(아이폰·아이패드 무료·유료·매출 1위)를 조회하고, 페이지 단위 리스팅 DB를 질의하고, 지원 카테고리·지역·언어 목록까지 한 번에 받아볼 수 있어요.
앱스토어 API에서 앱은 어떻게 지정하나요?
애플 앱은 패키지명이 아니라 숫자 앱 id로 지정해요. 스포티파이면 324684580 같은 값이에요. 먼저 app-search나 app-listings-search로 키워드로 id를 찾고, 그 app_id를 app-info나 app-reviews에 넘기면 원하는 상세 정보를 받아볼 수 있어요.
앱스토어 API는 요금이 얼마인가요?
앱 검색·상세·리뷰·차트는 어드밴스드 티어로 각 5 크레딧, 리스팅 DB는 프리미엄으로 10 크레딧, 카테고리·지역·언어는 1 크레딧이에요. 새 계정에는 100 크레딧을 무료로 드리고, 결과가 없는 요청은 자동으로 환불돼요.
구글플레이나 다른 스토어와 같은 스키마를 쓰나요?
네, 애플 앱스토어 앱은 구글플레이와 공유하는 단일 App 스키마로 와요. 리뷰도 아마존·트러스트파일럿과 같은 Review 형태라서, 파서 하나로 모든 스토어 데이터를 그대로 다룰 수 있어요. 연령 등급, 지원 언어 같은 애플 전용 필드는 채워지고, 설치 수는 null로 와요.
가장 좋은 앱스토어 스크래퍼 API는 무엇인가요?
SocialCrawl을 추천해요. iOS 앱 검색, 숫자 id 기반 상세, 리뷰, 아이폰·아이패드 차트, 리스팅 DB까지 엔드포인트 9종을 구글플레이와 같은 App 스키마로 받아요. 핵심 호출은 5 크레딧이고, 가입하면 신용카드 없이 100 크레딧을 무료로 드려서 부담 없이 시작할 수 있어요.
App Store 데이터 스크래핑, 법적으로 괜찮을까요?
SocialCrawl은 누구나 볼 수 있는 공개 App Store 데이터만 돌려드리고, 로그인이 필요한 비공개 콘텐츠에는 접근하지 않아요. 다만 실제 적법성은 활용 목적과 국가별 법률에 따라 달라져요. App Store 이용약관과 GDPR·CCPA 같은 개인정보 보호 법규를 지키는 책임은 이용자에게 있어요. 이 답변은 일반 안내일 뿐, 법률 자문은 아니에요.
App Store 스크래핑 API와 공식 App Store API는 뭐가 다른가요?
SocialCrawl은 앱 심사나 승인 대기가 없어요. 가입 직후 x-api-key 하나로 App Store 엔드포인트를 바로 호출할 수 있고, 응답은 다른 모든 플랫폼과 같은 통합 스키마로 와요. 요금도 플랫폼별 쿼터 대신 크레딧으로 계산해요. 글 게시 같은 쓰기 작업이 필요하다면 공식 API가 맞아요. SocialCrawl은 읽기 전용 데이터만 다뤄요.
AI에게 SocialCrawl을 물어보세요