---
title: "App"
description: "App Store에서 앱 페이지를 가져옵니다."
---

> Every apinoa docs page as markdown: https://apinoa.com/llms.txt (all in one file: https://apinoa.com/llms-full.txt; this API family in one file: https://apinoa.com/docs/serp/llms.txt)

```http
GET | POST /v1/app-store/app
```

파라미터는 `GET`의 쿼리 문자열로도, `POST`의 JSON 본문으로도 보낼 수 있습니다. 둘은 같습니다.

## 요청

```bash tab="cURL"
curl "https://gateway.apinoa.com/v1/app-store/app?id=324684580&country=US" \
  -H "x-api-key: $APINOA_API_KEY"
```

```js tab="JavaScript"
const params = new URLSearchParams({ id: "324684580", country: "US" });
const res = await fetch(`https://gateway.apinoa.com/v1/app-store/app?${params}`, {
  headers: { "x-api-key": process.env.APINOA_API_KEY },
});
const { success, data, error } = await res.json();
```

```python tab="Python"
import os

import requests

res = requests.get(
    "https://gateway.apinoa.com/v1/app-store/app",
    params={"id": "324684580", "country": "US"},
    headers={"x-api-key": os.environ["APINOA_API_KEY"]},
)
body = res.json()
```

## 파라미터

| Parameter | Type | Required | Notes |
|---|---|---|---|
| `country` | enum |  | The market, as an ISO 3166 country code. `US` `GB` `CA` `AU` `NZ` `IE` `DE` `FR` `IT` `ES` `NL` `BE` `AT` `CH` `SE` `NO` `DK` `FI` `PL` `PT` `CZ` `GR` `HU` `RO` `TR` `UA` `IL` `AE` `SA` `EG` `ZA` `NG` `KE` `IN` `PK` `ID` `MY` `SG` `TH` `VN` `PH` `JP` `KR` `CN` `TW` `HK` `MX` `BR` `AR` `CL` `CO` `PE` |
| `id` | string |  | The app's App Store id: the number in its link (`…/id426826309`). |
| `lang` | string |  | Interface language. |
| `url` | string |  | The app's App Store link, instead of `id`. |

The same parameters, and every response type, are in the OpenAPI document: https://apinoa.com/openapi.json

## 응답

`data`에 [`App`](/docs/api-reference/serp/response-schema#app)를 돌려줍니다. 실제 응답을 줄인 것입니다. 배열은 앞쪽 항목만 남기고 긴 텍스트는 잘랐습니다.

```json
{
  "success": true,
  "data": {
    "id": "324684580",
    "name": "Spotify: Music and Podcasts",
    "url": "https://apps.apple.com/us/app/spotify-music-and-podcasts/id324684580",
    "developer": {
      "id": "324684583",
      "name": "Spotify",
      "url": "https://apps.apple.com/us/developer/spotify/id324684583",
      "website": "https://www.spotify.com/"
    },
    "icon": "https://is1-ssl.mzstatic.com/image/thumb/Purple221/v4/8b/f2/6a/8bf26ab…",
    "screenshots": ["https://is1-ssl.mzstatic.com/image/thumb/PurpleSource211/v4/f3/ce/05/f…"],
    "summary": "Songs, Playlists & Audiobooks",
    "description": "With the Spotify app, you can explore an extensive library of music an…",
    "categories": ["Music"],
    "rating": {
      "average": 4.8,
      "count": 42829788,
      "distribution": {"1": 2.21, "2": 0.88, "3": 2.23, "4": 7.02, "5": 87.66}
    },
    "price": {"currency": "USD", "amount": 0},
    "inAppPurchases": false,
    "contentRating": "13+",
    "version": "9.1.94",
    "requires": "Requires iOS 16.1 and watchOS 10.0 or later. Compatible with iPhone, i…",
    "releasedAt": "2011-07-14",
    "updatedAt": "2026-10-23T17:59:53Z",
    "whatsNew": "We’re always making changes and improvements to Spotify. To make sure…",
    "starCounts": {"1": 948553, "2": 376136, "3": 954391, "4": 3004629, "5": 37546079},
    "related": [
      {
        "id": "912390687",
        "name": "TREBEL Music - Download Songs",
        "url": "https://apps.apple.com/us/app/trebel-music-download-songs/id912390687",
        "developer": {
          "id": "912390690",
          "name": "M&M Media, Inc.",
          "url": "https://apps.apple.com/us/developer/m-m-media-inc/id912390690",
          "website": "http://www.trebel.io"
        },
        "icon": "https://is1-ssl.mzstatic.com/image/thumb/Purple221/v4/ba/59/03/ba5903b…",
        "screenshots": ["https://is1-ssl.mzstatic.com/image/thumb/PurpleSource211/v4/f7/5e/e0/f…"],
        "summary": "AI, Offline Music & Mp3 Player",
        "description": "TREBEL Music is a free music app that allows you to listen to your fav…",
        "categories": ["Music"],
        "rating": {
          "average": 4.7,
          "count": 187133,
          "distribution": {"1": 2.37, "2": 1.48, "3": 3.71, "4": 9.77, "5": 82.67}
        },
        "price": {"currency": "USD", "amount": 0},
        "inAppPurchases": true,
        "contentRating": "13+",
        "version": "7.9.8",
        "releasedAt": "2014-11-03",
        "updatedAt": "2026-10-27T19:53:41Z",
        "whatsNew": "This update includes bug fixes and performance improvements to make th…",
        "starCounts": {"1": 4428, "2": 2773, "3": 6940, "4": 18281, "5": 154711},
        "ext": {
          "bundleId": "com.mmm.projectcarmen",
          "ratingLabel": "4.7 stars",
          "sizeBytes": 236870656,
          "offers": [{"type": "get", "price": 0, "currency": "USD", "priceFormatted": "$0.00", "sizeBytes": 236870656}],
          "genres": [
            {
              "id": "6011",
              "name": "Music",
              "url": "https://itunes.apple.com/us/genre/id6011",
              "parentId": "36",
              "parentName": "App Store"
            }
          ],
          "chart": {
            "chart": "top-free",
            "genre": "Music",
            "genreId": "6011",
            "position": 82,
            "url": "https://apps.apple.com/us/charts/iphone/music-apps/6011"
          },
          "advisories": ["Infrequent/Mild Alcohol, Tobacco, or Drug Use or References"],
          "legacyContentRating": "12+",
          "ageRating": {
            "levels": [{"level": "Infrequent", "kind": "INFREQUENT", "descriptors": ["Profanity or Crude Humor"]}]
          },
          "privacyPolicyUrl": "https://www.trebel.io/web/privacy",
          "supportUrl": "http://www.trebel.io",
          "minimumOsVersion": "15.6",
          "minimumMacOsVersion": "12.5",
          "minimumVisionOsVersion": "1.0",
          "requirements": [{"device": "iPad", "requires": "Requires iPadOS 15.6 or later."}],
          "requiredCapabilities": "arm64 armv7",
          "requiredCapabilitiesVisionOs": "arm64 armv7",
          "artwork": {
            "brandLogo": "https://is1-ssl.mzstatic.com/image/thumb/Features116/v4/e3/03/3c/e3033…",
            "contentIconTrimmed": "https://is1-ssl.mzstatic.com/image/thumb/Features116/v4/31/1e/55/311e5…",
            "contentIconTrimmedMonochrome": "https://is1-ssl.mzstatic.com/image/thumb/Features126/v4/14/5d/a1/145da…",
            "subscriptionHero": "https://is1-ssl.mzstatic.com/image/thumb/Features125/v4/77/ea/60/77ea6…"
          },
          "deviceFamilies": ["iphone"],
          "screenshotsByType": {
            "ipadPro": ["https://is1-ssl.mzstatic.com/image/thumb/PurpleSource221/v4/7a/48/34/7…"],
            "ipadPro_2018": ["https://is1-ssl.mzstatic.com/image/thumb/PurpleSource211/v4/11/8b/d4/1…"],
            "iphone6+": ["https://is1-ssl.mzstatic.com/image/thumb/PurpleSource211/v4/f7/5e/e0/f…"],
            "iphone_6_5": ["https://is1-ssl.mzstatic.com/image/thumb/PurpleSource211/v4/01/66/af/0…"],
            "iphone_d74": ["https://is1-ssl.mzstatic.com/image/thumb/PurpleSource211/v4/9e/3d/3f/9…"]
          },
          "versionHistory": [
            {
              "version": "7.9.8",
              "date": "2026-10-27T19:53:41Z",
              "notes": "This update includes bug fixes and performance improvements to make th…"
            }
          ],
          "distribution": "APP_STORE",
          "flags": {
            "isPreorder": false,
            "supportsArcade": false,
            "reviewsRestricted": false,
            "isMacCompatible": false,
            "isAppleWatchSupported": false,
            "isStandaloneForWatchOS": false,
            "isVisionOsCompatible": true,
            "requiresGameController": false,
            "supportsSharePlay": false,
            "hasMessagesExtension": false,
            "hasSafariExtension": false,
            "isHiddenFromSpringboard": false,
            "requires32bit": false,
            "is32bitOnlyForWatchOS": false,
            "isDeliveredInIOSAppForWatchOS": false,
            "isStandaloneWithCompanionForWatchOS": false,
            "isFirstPartyHideableApp": false,
            "supportsStreamlinedBuy": true
          },
          "privacy": {
            "sections": [
              {
                "type": "Data Used to Track You",
                "description": "The following data may be used to track you across apps and websites o…",
                "categories": [{"category": "Identifiers", "data": ["Device ID"]}]
              }
            ]
          }
        }
      }
    ],
    "moreByDeveloper": [
      {
        "id": "1056182234",
        "name": "Spotify for Creators",
        "url": "https://apps.apple.com/us/app/spotify-for-creators/id1056182234",
        "developer": {
          "id": "324684583",
          "name": "Spotify",
          "url": "https://apps.apple.com/us/developer/spotify/id324684583",
          "website": "https://pod.spoti.fi/34AfucUF3xb"
        },
        "icon": "https://is1-ssl.mzstatic.com/image/thumb/Purple221/v4/3b/2c/21/3b2c21b…",
        "screenshots": ["https://is1-ssl.mzstatic.com/image/thumb/PurpleSource221/v4/b4/1b/62/b…"],
        "summary": "Manage and grow your podcast",
        "description": "The official app from Spotify that helps creators grow, monetize, and…",
        "categories": ["News"],
        "rating": {
          "average": 4.8,
          "count": 117751,
          "distribution": {"1": 1.14, "2": 0.54, "3": 1.7, "4": 6.07, "5": 90.55}
        },
        "price": {"currency": "USD", "amount": 0},
        "inAppPurchases": false,
        "contentRating": "13+",
        "version": "7.122.0",
        "releasedAt": "2015-12-21",
        "updatedAt": "2026-10-20T01:47:52Z",
        "whatsNew": "You can use the Spotify for Creators (formerly Spotify for Podcasters)…",
        "starCounts": {"1": 1339, "2": 634, "3": 1999, "4": 7150, "5": 106629},
        "ext": {
          "bundleId": "com.anchorfminc.Anchor",
          "ratingLabel": "4.8 stars",
          "sizeBytes": 67548160,
          "offers": [{"type": "get", "price": 0, "currency": "USD", "priceFormatted": "$0.00", "sizeBytes": 67548160}],
          "genres": [
            {
              "id": "6009",
              "name": "News",
              "url": "https://itunes.apple.com/us/genre/id6009",
              "parentId": "36",
              "parentName": "App Store"
            }
          ],
          "chart": {
            "chart": "top-free",
            "genre": "News",
            "genreId": "6009",
            "position": 55,
            "url": "https://apps.apple.com/us/charts/iphone/news-apps/6009"
          },
          "legacyContentRating": "12+",
          "editorialNotes": {
            "tagline": "All-in-one podcast creator",
            "short": "Record, manage and distribute your podcast easily from one place.",
            "standard": "Adding your voice with a podcast is now easier than ever. Record your…"
          },
          "privacyPolicyUrl": "https://podcasters.spotify.com/pod/privacy",
          "supportUrl": "https://support.spotify.com/us/creators",
          "minimumOsVersion": "18.0",
          "minimumMacOsVersion": "15.0",
          "minimumVisionOsVersion": "2.0",
          "requirements": [{"device": "iPad", "requires": "Requires iPadOS 18.0 or later."}],
          "requiredCapabilities": "arm64 armv7",
          "requiredCapabilitiesVisionOs": "arm64 armv7",
          "artwork": {
            "brandLogo": "https://is1-ssl.mzstatic.com/image/thumb/Features116/v4/19/3e/cd/193ec…",
            "contentIconTrimmed": "https://is1-ssl.mzstatic.com/image/thumb/Features116/v4/54/2e/67/542e6…",
            "contentIconTrimmedMonochrome": "https://is1-ssl.mzstatic.com/image/thumb/Features126/v4/9b/2f/2c/9b2f2…",
            "storeFlowcase": "https://is1-ssl.mzstatic.com/image/thumb/Features111/v4/73/b1/33/73b13…",
            "subscriptionHero": "https://is1-ssl.mzstatic.com/image/thumb/Features62/v4/8f/f3/48/8ff348…"
          },
          "deviceFamilies": ["iphone"],
          "screenshotsByType": {
            "ipadPro_2018": ["https://is1-ssl.mzstatic.com/image/thumb/PurpleSource211/v4/ea/0a/66/e…"],
            "iphone_d74": ["https://is1-ssl.mzstatic.com/image/thumb/PurpleSource221/v4/b4/1b/62/b…"]
          },
          "versionHistory": [
            {
              "version": "7.122.0",
              "date": "2026-10-20T01:47:52Z",
              "notes": "You can use the Spotify for Creators (formerly Spotify for Podcasters)…"
            }
          ],
          "distribution": "APP_STORE",
          "flags": {
            "isPreorder": false,
            "supportsArcade": false,
            "reviewsRestricted": false,
            "isMacCompatible": false,
            "isAppleWatchSupported": false,
            "isStandaloneForWatchOS": false,
            "isVisionOsCompatible": true,
            "requiresGameController": false,
            "supportsSharePlay": false,
            "hasMessagesExtension": false,
            "hasSafariExtension": false,
            "isHiddenFromSpringboard": false,
            "requires32bit": false,
            "is32bitOnlyForWatchOS": false,
            "isDeliveredInIOSAppForWatchOS": false,
            "isStandaloneWithCompanionForWatchOS": false,
            "isFirstPartyHideableApp": false,
            "supportsStreamlinedBuy": true
          },
          "privacy": {
            "sections": [
              {
                "type": "Data Used to Track You",
                "description": "The following data may be used to track you across apps and websites o…",
                "categories": [{"category": "Contact Info", "data": ["Email Address"]}]
              }
            ]
          }
        }
      }
    ],
    "privacyPolicyUrl": "http://www.spotify.com/legal/privacy-policy/",
    "chart": {"name": "top-free", "position": 1},
    "ext": {
      "bundleId": "com.spotify.client",
      "languages": ["English"],
      "ratingLabel": "4.8 stars",
      "seller": "Spotify",
      "sellerLabel": "Seller",
      "sizeBytes": 325112832,
      "offers": [{"type": "get", "price": 0, "currency": "USD", "priceFormatted": "$0.00", "sizeBytes": 325112832}],
      "genres": [
        {
          "id": "6011",
          "name": "Music",
          "url": "https://itunes.apple.com/us/genre/id6011",
          "parentId": "36",
          "parentName": "App Store"
        }
      ],
      "advisories": ["Infrequent/Mild Alcohol, Tobacco, or Drug Use or References"],
      "legacyContentRating": "12+",
      "ageRating": {
        "description": "This app is rated 13+ with content restrictions.\n\nSome content may be…",
        "levels": [{"level": "In-App Controls", "kind": "IAC", "descriptors": ["Age Assurance"]}]
      },
      "copyright": "© 2008–2026 Spotify Ltd.",
      "supportUrl": "https://support.spotify.com/",
      "minimumOsVersion": "16.1",
      "minimumMacOsVersion": "13.0",
      "minimumWatchOsVersion": "10.0",
      "minimumVisionOsVersion": "1.0",
      "requirements": [{"device": "iPad", "requires": "Requires iPadOS 16.1 or later."}],
      "requiredCapabilities": "arm64",
      "requiredCapabilitiesVisionOs": "arm64",
      "externalVersionId": "893512212",
      "artwork": {
        "circular": "https://is1-ssl.mzstatic.com/image/thumb/Purple211/v4/24/d4/a6/24d4a66…",
        "circularIcon": "https://is1-ssl.mzstatic.com/image/thumb/PurpleSource221/v4/5c/49/a2/5…",
        "brandLogo": "https://is1-ssl.mzstatic.com/image/thumb/Features116/v4/e3/03/3c/e3033…",
        "contentIconTrimmed": "https://is1-ssl.mzstatic.com/image/thumb/Features116/v4/31/1e/55/311e5…",
        "contentIconTrimmedMonochrome": "https://is1-ssl.mzstatic.com/image/thumb/Features126/v4/14/5d/a1/145da…"
      },
      "deviceFamilies": ["tvos"],
      "locales": ["en-US"],
      "screenshotsByType": {
        "appleWatch_2021": ["https://is1-ssl.mzstatic.com/image/thumb/PurpleSource211/v4/55/7e/e5/5…"],
        "ipadPro": ["https://is1-ssl.mzstatic.com/image/thumb/PurpleSource211/v4/31/15/15/3…"],
        "ipadPro_2018": ["https://is1-ssl.mzstatic.com/image/thumb/PurpleSource211/v4/c4/29/71/c…"],
        "iphone6+": ["https://is1-ssl.mzstatic.com/image/thumb/PurpleSource211/v4/f3/ce/05/f…"],
        "iphone_6_5": ["https://is1-ssl.mzstatic.com/image/thumb/PurpleSource221/v4/ee/75/d1/e…"],
        "iphone_d74": ["https://is1-ssl.mzstatic.com/image/thumb/PurpleSource221/v4/fd/04/70/f…"]
      },
      "versionHistory": [
        {
          "version": "9.1.94",
          "date": "2026-10-23T17:59:53Z",
          "notes": "We’re always making changes and improvements to Spotify. To make sure…"
        }
      ],
      "watchBundleId": "com.spotify.client.watchkitapp",
      "distribution": "APP_STORE",
      "familyShareSince": "0001-04-23T00:00:00Z",
      "flags": {
        "hasEula": false,
        "isPreorder": false,
        "supportsArcade": false,
        "reviewsRestricted": false,
        "usesLocationInBackground": false,
        "isMacCompatible": false,
        "isGameCenterEnabled": false,
        "isSiriSupported": true,
        "isAppleWatchSupported": true,
        "isStandaloneForWatchOS": false,
        "isVisionOsCompatible": false,
        "supportsGameController": false,
        "requiresGameController": false,
        "supportsSharePlay": true,
        "supportsPassbook": false,
        "hasMessagesExtension": false,
        "hasSafariExtension": false,
        "hasFamilyShareableInAppPurchases": false,
        "hasPrivacyPolicyText": true,
        "is32bitOnly": false,
        "isHiddenFromSpringboard": false,
        "requires32bit": false,
        "is32bitOnlyForWatchOS": false,
        "isDeliveredInIOSAppForWatchOS": true,
        "isStandaloneWithCompanionForWatchOS": false,
        "isFirstPartyHideableApp": false,
        "supportsStreamlinedBuy": true
      },
      "privacy": {
        "sections": [
          {
            "type": "Data Used to Track You",
            "description": "The following data may be used to track you across apps and websites o…",
            "categories": [{"category": "Contact Info", "data": ["Email Address"]}]
          }
        ]
      },
      "chartGenre": "Music",
      "chartGenreId": "6011",
      "chartUrl": "https://apps.apple.com/us/charts/iphone/music-apps/6011",
      "tags": [
        {
          "id": "6011",
          "name": "Music",
          "url": "https://itunes.apple.com/us/genre/id6011",
          "parentId": "36",
          "parentName": "App Store"
        }
      ]
    },
    "country": "US",
    "lang": "en-US"
  }
}
```

## 에러

| 상태 | 코드 | 의미 |
|---|---|---|
| 400 | `INVALID_PARAMS` | 파라미터가 없거나, 알 수 없거나, 범위를 벗어났거나, 이 엔진이 받지 않는 값입니다. 메시지에 이름이 나옵니다. |
| 401 | `UNAUTHORIZED` | `x-api-key` 헤더가 없거나, 폐기되었거나 알 수 없는 키입니다. |
| 402 | `INSUFFICIENT_BALANCE` | 잔액이 이 호출 비용에 모자랍니다. 대시보드에서 충전하세요. |
| 404 | `NOT_FOUND` | 이 스토어의 해당 시장에 그 앱이 없습니다. |
| 429 | `MARKETPLACE_SATURATED` | 동시 호출이 너무 많습니다. `Retry-After` 초만큼 기다린 뒤 다시 시도하세요. |
| 502 | `UPSTREAM_ERROR` | 엔진이 쓸 수 없는 응답을 보냈습니다. 간격을 두고 다시 시도하세요. |
| 503 | `SERVICE_UNAVAILABLE` | 일시적인 장애입니다. 간격을 두고 다시 시도하세요. |

모든 코드는 [Errors](/docs/errors)에 있습니다. 실패한 호출은 과금되지 않습니다.

## 가격

**Price** $0.0012 per call. [List price](https://apinoa.com/en/pricing); the rate steps down above 1,000 calls a day.

## 참고

- 앱의 숫자 id(링크의 숫자, `…/id324684580`)를 넘기거나 App Store 링크를 `url`로 넘깁니다.