App Store 상세 정보 API

Q: app_id는 어디에서 찾나요?

앱의 App Store 페이지 링크에서 id 뒤에 오는 숫자가 app_id입니다. 예를 들어 링크가 id389801252로 끝나면 389801252입니다. 전체 링크를 넣어도 ID가 자동으로 추출됩니다. com.example.app 같은 번들 ID로는 앱을 지정할 수 없으며, 번들 ID는 bundle_id로 반환됩니다. App Store Search 결과에도 app_id가 포함됩니다.

Q: 국가마다 앱 정보가 다른 이유는 무엇인가요?

App Store 스토어프론트는 국가별로 분리되어 있습니다. country에 us, cn, jp 같은 소문자 코드를 지정하면 해당 스토어에서 정보를 읽습니다. 앱이 어떤 스토어프론트에는 있고 다른 곳에는 없을 수 있으며, 가격과 평점도 스토어마다 다를 수 있습니다. 비교하는 모든 수치에 스토어프론트를 함께 기록하세요.

Q: rating과 current_version_rating 중 무엇을 써야 하나요?

rating과 rating_count는 모든 버전을 합친 전체 수치이고, current_version_rating과 current_version_rating_count는 현재 스토어에 올라와 있는 버전만 대상으로 합니다. 디자인을 개편했거나 많이 신고된 버그를 수정한 뒤라면 현재 버전 수치가 지금 앱이 받는 평가를 보여 줍니다. 새 버전은 아직 평점이 적을 수 있으므로 먼저 평점 수를 확인하세요.

POST

API 상태

24시간 상태: 정상
24시간 평균 소요 시간: —

양호 / 정상
사용 가능
제한적
대부분 작동 중단

정상

최근 24시간

최근 30일

숫자 app_id로 앱 하나의 App Store 등록 정보를 가져옵니다. 개발자, 번들 ID, 버전, 릴리스 노트, 가격, 연령 등급, 현재 버전 평점이 포함됩니다. 전체 앱 링크도 사용할 수 있지만 번들 ID는 사용할 수 없습니다. 이 레코드는 App Store Connect나 이전 버전이 아닌 현재 공개된 등록 정보를 보여 줍니다.

App Store Details는 app_id로 Apple App Store에 등록된 앱 하나의 정보를 읽어 레코드로 반환합니다. 레코드에는 이름, 개발자, 번들 ID, 설명과 릴리스 노트, 현재 버전, 가격, 전체 버전 및 현재 버전의 평점과 평점 수, 연령 등급, 카테고리, 최소 OS 버전, 설치 용량, 아이콘, 최초 출시일과 최근 업데이트일이 포함됩니다. 프로덕트 매니저, 그로스 마케터, 투자자는 이 기능으로 경쟁 앱을 벤치마킹하고, 업데이트 주기를 추적하고, 새 버전에 대한 사용자 반응을 확인합니다.

app_id는 Apple의 숫자 ID로, App Store 링크에서 id 뒤에 오는 숫자입니다. 전체 링크를 넣어도 됩니다. 앱 정보는 스토어프론트(국가별 스토어)마다 다르므로 country를 원하는 스토어로 지정하세요. 기본값은 미국 스토어입니다. 대규모 업데이트 이후에는 전체 기간의 rating보다 current_version_rating이 현재 앱의 상태를 더 정확하게 보여 줍니다. price는 숫자이며 통화 코드는 currency에 담기고, formatted_price는 스토어에 표시되는 텍스트입니다. file_size_bytes의 단위는 바이트입니다. rating_count가 null이면 Apple이 수치를 공개하지 않는다는 뜻이며, 평점이 0개인 것과는 다릅니다.

요금은 요청 1,000개당 $1.39(호출당 $0.001389)입니다. 실패한 호출과 빈 결과에는 과금하지 않습니다. 동기 방식입니다. 오래 걸리는 작업은 요청 본문에 "mode": "async"를 추가하고 job_id를 받아 폴링하세요.

AI 프롬프트

EveryInfra App Store 상세 정보 엔드포인트(app_store/profile)를 사용하는 데이터 수집 스크립트 작성을 도와주세요.

엔드포인트 사용 방법:
- 요청: Authorization: Bearer <API 키> 헤더와 함께 POST https://api.everyinfra.com/api/v1/social로 보냅니다. 키는 EVERYINFRA_API_KEY 환경 변수에서 읽고, 절대 하드코딩하지 마세요.
- 요청 본문에서 platform은 app_store, action은 profile로 설정하고, 파라미터는 params 안에 넣습니다.
- 필수 파라미터:
- app_id: Apple의 숫자 앱 식별자를 지정합니다(예: 앱 링크에서 id 뒤에 있는 숫자). App Store 앱 URL 전체를 전달해도 플랫폼이 숫자 ID를 추출합니다. com.example.app 형식의 Bundle ID는 전달하지 마세요.
- 선택 파라미터:
- country: search, profile, reviews에 사용할 App Store 스토어프런트를 us, cn, jp 같은 소문자 두 글자 국가 코드로 선택합니다. 기본값은 us입니다. 조회하는 스토어프런트만 바뀌며, 계정 지역이나 EveryInfra 과금은 바뀌지 않습니다.
- 단일 객체를 반환합니다. 주요 필드: app_id, name, url, bundle_id, developer, developer_id, developer_url, description, release_notes, version, price, currency; 전체 필드 28개, 전체 목록은 https://api.everyinfra.com/api/v1/social/catalog?platform=app_store.
- 요청 본문 예시:
{
"platform": "app_store",
"action": "profile",
"params": {
"app_id": "389801252"
}
}
- 요금: 요청 1,000개당 $1.39. 실패하거나 빈 결과에는 과금하지 않습니다.
- 대상이 수십~수백 개라면 요청 본문에 "mode": "async"를 추가하세요. job_id를 즉시 받은 뒤 GET https://api.everyinfra.com/api/v1/jobs/{job_id}를 폴링해 결과를 가져옵니다.
- 422가 반환되면 오류에 제시된 파라미터 이름과 허용 값을 참고해 요청을 수정하고, 429 또는 503이 반환되면 Retry-After만큼 기다린 뒤 다시 시도합니다.

코드를 작성하기 전에 필요한 대상과 수량, 필드, 원하는 출력 형식을 먼저 물어봐 주세요. 그런 다음 계획과 대략적인 비용을 저와 확인해 주세요.

요청 파라미터

이름	위치	타입	필수	기본값	설명
`Authorization`	header	`string`	예	-	Bearer 뒤에 API 키를 붙여 입력합니다. API 키는 콘솔에서 생성하며, URL이나 코드 저장소에 절대 넣지 마세요.
`platform`	body	`string`	예	`app_store`	플랫폼 식별자이며 고정값입니다.
`action`	body	`string`	예	`profile`	기능 식별자이며 고정값입니다.
`app_id`	body.params	`string`	예	-	Apple의 숫자 앱 식별자를 지정합니다(예: 앱 링크에서 id 뒤에 있는 숫자). App Store 앱 URL 전체를 전달해도 플랫폼이 숫자 ID를 추출합니다. com.example.app 형식의 Bundle ID는 전달하지 마세요.
`country`	body.params	`string`	아니요	-	search, profile, reviews에 사용할 App Store 스토어프런트를 us, cn, jp 같은 소문자 두 글자 국가 코드로 선택합니다. 기본값은 us입니다. 조회하는 스토어프런트만 바뀌며, 계정 지역이나 EveryInfra 과금은 바뀌지 않습니다.

코드 샘플

bash

curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "app_store",
  "action": "profile",
  "params": {
    "app_id": "389801252"
  }
}'

OpenAPI 정의(JSON)샘플 코드는 EVERYINFRA_API_KEY 환경 변수에서 키를 읽으므로, 복사한 코드에는 API 키가 포함되지 않습니다.

응답 예시

실제 응답

September 26, 2026 at 08:56(UTC)에 위 코드 샘플의 파라미터로 이 API를 호출해 수집한 응답입니다. results와 count는 해당 호출의 실제 응답이며, 개인정보(이름, 핸들, 아바타, 프로필 링크, 연락처)는 제거했습니다. id, billing, quota는 호출할 때마다 달라지므로 형태만 표시합니다.

json

{
  "id": "req_…",
  "platform": "app_store",
  "action": "profile",
  "results": {
    "app_id": 389801252,
    "name": "Instagram",
    "url": "https://apps.apple.com/us/app/instagram/id389801252?uo=4",
    "bundle_id": "com.burbn.instagram",
    "developer": "Instagram, Inc.",
    "developer_url": "https://apps.apple.com/us/developer/instagram-inc/id389801255?uo=4",
    "description": "Little moments lead to big friendships. Share yours on Instagram. \n— From Meta\n\nConnect with friends, find other fans, and see what people around you are up to and into. Explore your interests and post what's going on, from your daily moments to life's highlights.\n\nShare what you…",
    "release_notes": "Performance optimizations and stability improvements for a smoother, more reliable experience.",
    "version": "448.0.0",
    "price": 0,
    "currency": "USD",
    "formatted_price": "Free",
    "rating": 4.69,
    "rating_count": 29523309,
    "current_version_rating_count": 29523309,
    "content_rating": "12+",
    "category": "Photo & Video",
    "icon_url": "https://is1-ssl.mzstatic.com/image/thumb/Purple221/v4/f5/7f/2c/f57f2c00-2dff-4704-501b-ab6849c6277d/Prod-0-0-1x_U007epad-0-1-0-sRGB-85-220.png/512x512bb.jpg",
    "min_os": "16.3",
    "file_size_bytes": 611172352,
    "released_at": "2010-10-06T08:12:41+00:00",
    "updated_at": "2026-09-21T15:59:55+00:00",
    "platform": "app_store",
    "genres": [
      "Photo & Video",
      "Social Networking"
    ],
    "languages": [
      "BN",
      "HR",
      "CS"
    ],
    "screenshot_urls": [
      "https://is1-ssl.mzstatic.com/image/thumb/PurpleSource221/v4/50/e2/8b/50e28b44-daa5-7101-6fb6-2d0e10fc72f3/1_iOS_5.5.jpg/392x696bb.jpg",
      "https://is1-ssl.mzstatic.com/image/thumb/PurpleSource221/v4/4d/a5/33/4da53369-3dce-b9b4-2a0c-1c6957dd40c4/1_iOS_5.5.jpg/392x696bb.jpg",
      "https://is1-ssl.mzstatic.com/image/thumb/PurpleSource211/v4/10/38/e1/1038e1c7-751f-c4ea-39b9-d9f4d08fc08d/2_iOS_5.5.jpg/392x696bb.jpg"
    ],
    "rating_scale": 5
  },
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}

응답 필드

비즈니스 데이터는 results에 담깁니다. 아래 표는 레코드에 포함될 수 있는 필드를 나열하며, 플랫폼에 표시되지 않는 값을 임의로 만들어 넣지 않습니다.

필드	의미
`app_id`	플랫폼 자체의 의미를 따름
`name`	객체 자체의 이름으로, 계정, 상품, 업체 관련 기능에 해당합니다.
`url`	플랫폼에서 해당 레코드로 연결되는 링크입니다.
`bundle_id`	플랫폼 자체의 의미를 따름
`developer`	플랫폼 자체의 의미를 따름
`developer_id`	플랫폼 자체의 의미를 따름
`developer_url`	플랫폼 자체의 의미를 따름
`description`	요약 또는 설명으로, 보통 text보다 짧습니다.
`release_notes`	플랫폼 자체의 의미를 따름
`version`	플랫폼 자체의 의미를 따름
`price`	통화 기호 없이 숫자로 표시한 가격입니다. currency를 참고하세요.
`currency`	가격의 통화 코드입니다(예: CNY, USD). price는 있는데 currency가 null이면 통화를 추정하지 마세요.
`formatted_price`	플랫폼 자체의 의미를 따름
`rating`	평점입니다. 척도는 플랫폼마다 다릅니다. 같은 행의 rating_scale이 최댓값을 나타냅니다(보통 5이며, Booking, Douban, iQIYI, NAVER는 10). 플랫폼 간에 비교하기 전에 rating_scale로 환산하세요. 그렇지 않으면 비교 결과가 뒤바뀔 수 있습니다.
`rating_scale`	같은 행에 있는 rating의 최댓값입니다. 5점 척도는 5, 10점 척도는 10입니다. 행에 rating이 있을 때만 포함됩니다.
`rating_count`	평가한 사람 수입니다. null은 비공개라는 뜻이며, 0이 아닙니다.
`current_version_rating`	플랫폼 자체의 의미를 따름
`current_version_rating_count`	플랫폼 자체의 의미를 따름
`content_rating`	플랫폼 자체의 의미를 따름
`category`	플랫폼 자체 분류 체계의 카테고리 이름으로, 플랫폼 간에 정규화되지 않습니다.
`icon_url`	플랫폼 자체의 의미를 따름
`min_os`	플랫폼 자체의 의미를 따름
`file_size_bytes`	플랫폼 자체의 의미를 따름
`released_at`	플랫폼 자체의 의미를 따름
`updated_at`	플랫폼 자체의 의미를 따름
`platform`	출처 플랫폼 식별자로, 요청의 platform과 같습니다(예: xiaohongshu, tiktok).
`genres`	플랫폼 자체의 의미를 따름
`languages`	플랫폼 자체의 의미를 따름
`screenshot_urls`	플랫폼 자체의 의미를 따름

FAQ

`app_id`는 어디에서 찾나요?

앱의 App Store 페이지 링크에서 id 뒤에 오는 숫자가 app_id입니다. 예를 들어 링크가 id389801252로 끝나면 389801252입니다. 전체 링크를 넣어도 ID가 자동으로 추출됩니다. com.example.app 같은 번들 ID로는 앱을 지정할 수 없으며, 번들 ID는 bundle_id로 반환됩니다. App Store Search 결과에도 app_id가 포함됩니다.

국가마다 앱 정보가 다른 이유는 무엇인가요?

App Store 스토어프론트는 국가별로 분리되어 있습니다. country에 us, cn, jp 같은 소문자 코드를 지정하면 해당 스토어에서 정보를 읽습니다. 앱이 어떤 스토어프론트에는 있고 다른 곳에는 없을 수 있으며, 가격과 평점도 스토어마다 다를 수 있습니다. 비교하는 모든 수치에 스토어프론트를 함께 기록하세요.

`rating`과 `current_version_rating` 중 무엇을 써야 하나요?

rating과 rating_count는 모든 버전을 합친 전체 수치이고, current_version_rating과 current_version_rating_count는 현재 스토어에 올라와 있는 버전만 대상으로 합니다. 디자인을 개편했거나 많이 신고된 버그를 수정한 뒤라면 현재 버전 수치가 지금 앱이 받는 평가를 보여 줍니다. 새 버전은 아직 평점이 적을 수 있으므로 먼저 평점 수를 확인하세요.

오류 및 과금

401: 키가 없거나 유효하지 않습니다.
402: 잔액이 부족합니다. 먼저 충전하세요.
422: 파라미터 이름 또는 값이 올바르지 않습니다. 오류에 제시된 제안을 참고해 수정하세요. 과금되지 않습니다.
429: 분당 요청 속도 제한에 도달했습니다. Retry-After만큼 기다린 뒤 다시 시도하세요.
503: 처리를 완료하지 못했습니다. 보류된 금액은 잔액으로 반환됩니다. 결과가 불확실하면 재시도하기 전에 먼저 확인하세요.
200 빈 결과: 데이터가 없습니다. 과금되지 않습니다.

오류

공식 참고 자료

객체와 용어를 확인하는 용도로만 사용합니다. 해당 플랫폼이 EveryInfra를 승인하거나 보증한다는 의미는 아닙니다.

Apple: App Store Connect의 앱 정보 살펴보기 ↗
Apple은 앱의 Apple ID와 번들 ID를 별도로 정의하며, Apple ID는 App Store 앱 URL에도 사용됩니다.
2026-09-04 확인