App Store App API

GET | POST /v1/app-store/app

参数可以用 GET 的查询字符串发送，也可以用 POST 的 JSON 请求体发送，两者等价。

请求

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

参数

参数	类型	说明
`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`.

这些参数及所有响应类型也写在OpenAPI 文档中。

响应

在 data 中返回 App。真实响应的节选：数组只保留前几项，长文本已截断。

{
  "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。失败的调用不计费。

价格

价格每次调用 $0.0012。标价；单日调用超过 1,000 次后单价下调。

说明

传入应用的数字 id（链接中的数字，…/id324684580），或把 App Store 链接作为 url 传入。

App

请求

参数

响应

错误

价格

说明

本页内容