苹果应用搜索 API

搜索苹果 App Store 中的 iPhone / iPad 应用，返回名称、开发者、价格、评分、版本、大小、图标和下载链接，支持多个国家和地区的商店

数据来源：Apple iTunes Search API

返回统一的 JSON 格式 { code, message, cached, stale, updatedAt, data }，支持跨域，免注册每天可免费调用 100 次，注册后每天 10000 次。

按关键词或 App ID 搜索 App Store 应用

GET /api/appstore/search

请求参数

  • keyword：搜索关键词（最多 100 字）；与 id 至少传一个，示例 微信
  • id：App ID（App Store 链接里 id 后面的数字），传入后精确查询，忽略 keyword，示例 414478124
  • country：商店地区：cn 中国大陆、hk 中国香港、tw 中国台湾、mo 中国澳门、us 美国、jp 日本、kr 韩国、gb 英国、sg 新加坡、au 澳大利亚、ca 加拿大、de 德国、fr 法国，示例 us
  • limit：返回数量，1~50，示例 5

返回字段

  • country（string）：商店地区代码（如 cn）
  • countryName（string）：商店地区中文名
  • keyword（string|null）：搜索关键词；按 id 查询时为 null
  • total（number）：返回的应用数量
  • list（array）：应用列表，按苹果返回的相关度排序
  • list[].id（number）：App ID
  • list[].name（string）：应用名称
  • list[].bundleId（string|null）：Bundle ID（如 com.tencent.xin）
  • list[].developer（string|null）：开发者 / 销售方
  • list[].price（number|null）：价格数值（0 为免费，单位见 currency）
  • list[].formattedPrice（string|null）：格式化的价格，如"免费""¥6.00"
  • list[].currency（string|null）：货币代码，如 CNY、USD
  • list[].rating（number|null）：平均评分（满分 5，保留一位小数）；没有评分时为 null
  • list[].ratingCount（number）：评分人数
  • list[].version（string|null）：当前版本号
  • list[].genre（string|null）：主分类（如 Social Networking、社交）
  • list[].genres（array）：全部分类
  • list[].sizeMB（number|null）：安装包大小（MB，保留一位小数）
  • list[].minOs（string|null）：最低系统版本（如 15.0）
  • list[].contentRating（string|null）：年龄分级（如 4+、12+）
  • list[].releasedAt（string|null）：首次上架时间（ISO 8601）
  • list[].updatedAt（string|null）：当前版本发布时间（ISO 8601）
  • list[].releaseNotes（string|null）：当前版本更新说明（前 500 字）；没有时为 null
  • list[].icon（string|null）：图标地址（512px，没有时退回 100px）
  • list[].url（string|null）：App Store 页面地址
  • list[].description（string）：应用简介（前 300 字）