App Store 查询

app-storePOST

POSThttps://v1.apizero.cn/api/app-store

概述

输入 App 数字 ID 或应用商店链接，查询 App Store 应用的名称、开发者、版本、评分、价格、截图、兼容性等完整信息。支持全球多国家/地区（cn/us/jp 等）查询，可用于应用竞品分析、上架状态监控、ASO 运营、开发者工具集成等场景。数据实时聚合、结构清晰，数值/日期已标准化。完全免费。

调用约定

网关 · https://v1.apizero.cn
鉴权 · Authorization: Bearer <API Key>
回包 · JSON {code, msg, data}。成功看 code === 0，不要只看 HTTP 200。

/aidocs/app-store/raw.md

打开 Markdown

鉴权

登录用户每日 1000 次免费（QPS 10），匿名用户每日 500 次（QPS 5）。可选携带 API Key（Authorization: Bearer <key>）以享受更高额度。

获取 API Key：获取 API Key/account/keys

请求头

Authorizationstring选填

推荐：Bearer <API Key>。兼容请求头 X-API-Key，以及 Query api_key / apikey / key（key 仅当值为 sk_live_/sk_test_/sk_stag_ 形态时生效）。匿名可不传，受每日免费额度限制。

Content-Typestring必填

请求体格式

Header	类型	必填	说明
Authorization	string	否	推荐：Bearer <API Key>。兼容请求头 X-API-Key，以及 Query api_key / apikey / key（key 仅当值为 sk_live_/sk_test_/sk_stag_ 形态时生效）。匿名可不传，受每日免费额度限制。
Content-Type	string	是	请求体格式

请求参数

POST · APPLICATION/JSON

app_idstring选填

App 数字 ID（与 url 二选一，优先）

例414478124

url（链接）string选填

应用商店链接，自动提取数字 ID（与 app_id 二选一）

例https://apps.apple.com/cn/app/id414478124

countrystring选填

两位国家/地区码，非法自动回退 cn

例cn

参数	类型	必填	说明	示例
app_id	string	否	App 数字 ID（与 url 二选一，优先）	414478124
url（链接）	string	否	应用商店链接，自动提取数字 ID（与 app_id 二选一）	https://apps.apple.com/cn/app/id414478124
country	string	否	两位国家/地区码，非法自动回退 cn	cn

{
  "app_id": "414478124",
  "url": "https://apps.apple.com/cn/app/id414478124",
  "country": "cn"
}

返回结果

顶层固定为 code / msg / data。下表一般是 data 内字段。 code · msg · data · tips · request_id

app_idnumber

应用数字 ID

namestring

应用名称

bundle_idstring

应用包名（Bundle ID）

developerobject

开发者信息（id/name/url/seller_name/seller_url）

namestring

名称

seller_namestring

seller_name

urlstring

地址

iconobject

多尺寸图标（small 60 / medium 100 / large 512）

smallstring

small

mediumstring

medium

largestring

large

priceobject

价格（amount/currency/formatted/is_free）

amountnumber

amount

currencystring

currency

formattedstring

formatted

is_freeboolean

is_free

versionobject

版本信息（current/release_date/release_notes/days_since_update 距上次更新天数）

currentstring

current

release_datestring

release_date

release_notesstring

release_notes

days_since_updatenumber

days_since_update

ratingobject

评分（average/count/当前版本评分）

averagenumber

average

countnumber

count

current_version_averagenumber

current_version_average

current_version_countnumber

current_version_count

categoryobject

分类（primary 主分类 / all 全部分类）

primarystring

primary

primary_idnumber

primary_id

allarray

all

category.all[]string

category.all 的一项

compatibilityobject

兼容性（min_os_version/supported_devices_count/features/game_center）

min_os_versionstring

min_os_version

supported_devices_countnumber

supported_devices_count

featuresarray

features

compatibility.features[]string

compatibility.features 的一项

game_centerboolean

game_center

content_ratingstring

内容分级（如 4+/12+/17+）

advisoriesarray

内容提示（如含成人题材、内购等）

advisories[]string

advisories 的一项

file_sizeobject

应用体积（bytes 字节 / display 可读）

bytesnumber

bytes

displaystring

display

descriptionstring

应用简介全文

screenshotsobject

截图（iphone/ipad/appletv 数组）

iphonearray

iphone

screenshots.iphone[]string

screenshots.iphone 的一项

ipadarray

ipad

screenshots.ipad[]string

screenshots.ipad 的一项

appletvarray

appletv

screenshots.appletv[]string

screenshots.appletv 的一项

languagesarray

支持语言（ISO 两位码）

languages[]string

languages 的一项

language_countnumber

支持语言数量

store_urlstring

应用商店详情页链接

first_release_datestring

首次发布日期（YYYY-MM-DD）

countrystring

查询的国家/地区码（大写）

tipsstring

品牌提示（所有接口统一返回）：极数本源 · https://apizero.cn

字段

类型

说明

app_id

number

应用数字 ID

name

string

应用名称

bundle_id

string

应用包名（Bundle ID）

developer

object

开发者信息（id/name/url/seller_name/seller_url）

name	string	名称
seller_name	string	seller_name
url	string	地址

icon

object

多尺寸图标（small 60 / medium 100 / large 512）

small	string	small
medium	string	medium
large	string	large

price

object

价格（amount/currency/formatted/is_free）

amount	number	amount
currency	string	currency
formatted	string	formatted
is_free	boolean	is_free

version

object

版本信息（current/release_date/release_notes/days_since_update 距上次更新天数）

current	string	current
release_date	string	release_date
release_notes	string	release_notes
days_since_update	number	days_since_update

rating

object

评分（average/count/当前版本评分）

average	number	average
count	number	count
current_version_average	number	current_version_average
current_version_count	number	current_version_count

返回示例

{
  "code": 0,
  "msg": "成功",
  "data": {
    "app_id": 414478124,
    "name": "微信",
    "bundle_id": "com.tencent.xin",
    "developer": {
      "name": "WeChat",
      "seller_name": "Tencent Technology (Shenzhen) Company Limited",
      "url": "https://.../developer/..."
    },
    "icon": {
      "small": "https://.../60x60.jpg",
      "medium": "https://.../100x100.jpg",
      "large": "https://.../512x512.jpg"
    },
    "price": {
      "amount": 0,
      "currency": "CNY",
      "formatted": "免费",
      "is_free": true
    },
    "version": {
      "current": "8.0.75",
      "release_date": "2026-06-14",
      "release_notes": "本次更新：解决了一些已知问题。",
      "days_since_update": 17
    },
    "rating": {
      "average": 4.15,
      "count": 8010302,
      "current_version_average": 4.15,
      "current_version_count": 8010302
    },
    "category": {
      "primary": "Social Networking",
      "primary_id": 6005,
      "all": [
        "社交",
        "效率"
      ]
    },
    "compatibility": {
      "min_os_version": "15.0",
      "supported_devices_count": 128,
      "features": [
        "iosUniversal"
      ],
      "game_center": false
    },
    "content_rating": "12+",
    "advisories": [],
    "file_size": {
      "bytes": 851213312,
      "display": "811.78 MB"
    },
    "description": "微信是一个生活方式……",
    "screenshots": {
      "iphone": [
        "https://.../1.jpg"
      ],
      "ipad": [],
      "appletv": []
    },
    "languages": [
      "ZH",
      "EN",
      "JA"
    ],
    "language_count": 25,
    "store_url": "https://apps.apple.com/cn/app/id414478124",
    "first_release_date": "2011-01-21",
    "country": "CN"
  },
  "request_id": "a1b2c3d4",
  "tips": "极数本源 · https://apizero.cn"
}

请求示例

示例都是服务端写法。Python / JavaScript 各有常规写法和官方库。

curl -sS -X POST "https://v1.apizero.cn/api/app-store" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "app_id": "414478124",
  "url": "https://apps.apple.com/cn/app/id414478124",
  "country": "cn"
}'

错误码

先看业务 code。HTTP 也可能不是 200。

0200

成功

4000400

参数错误

4011401

API Key 无效

4013403

API Key 已暂停

4014403

当前 IP 不在 Key 白名单

4015401

此接口需要 API Key

4022402

余额不足

4029429

调用过快（QPS）

4030429

今日免费额度已用完

4040503

接口已下线

4041404

接口不存在

5000500

服务器内部错误

5020502

上游暂时不可用

5021502

上游返回格式异常

5030502

暂无可用节点

业务码	HTTP	说明
0	200	成功
4000	400	参数错误
4011	401	API Key 无效
4013	403	API Key 已暂停
4014	403	当前 IP 不在 Key 白名单
4015	401	此接口需要 API Key
4022	402	余额不足
4029	429	调用过快（QPS）
4030	429	今日免费额度已用完
4040	503	接口已下线
4041	404	接口不存在
5000	500	服务器内部错误
5020	502	上游暂时不可用
5021	502	上游返回格式异常
5030	502	暂无可用节点

调用限制

计费模式: 完全免费
QPS 限制: QPS 3
登录免费额度: 1000 次（已认证）
匿名每日额度: 500 次（无 API Key）
黄金会员: 每天 50,000 次 · QPS 10
钻石会员: 每天 100,000 次 · QPS 30
企业会员: 每天 1,000,000 次 · QPS 120

计费模式	完全免费
QPS 限制	QPS 3
登录免费额度	1000 次（已认证）
匿名每日额度	500 次（无 API Key）
黄金会员	每天 50,000 次 · QPS 10
钻石会员	每天 100,000 次 · QPS 30
企业会员	每天 1,000,000 次 · QPS 120

购买套餐、看评价请走商城详情。购买 / 调试

更新日志

v1.02026-07-01
首次上线：支持 app_id/链接查询，返回名称/开发者/版本/评分/价格/截图/兼容性等完整信息，支持多国家/地区。