概览
按关键词、App ID、Bundle ID、开发者 ID 或应用链接查苹果 App Store 的应用详情,可选同时抓评论与相似应用,共 45 列。
数据说明
数据来自苹果公开的应用目录,覆盖美国、中国、日本等 40 多个地区。一个应用一行,评论挂在「评论」列里存成数组,不拆成多行——要一行一条评论请用专门的评论采集包。带附加项时,同一个应用也可以同时拿到相似应用那一列。
几个容易看错的地方:「当前版本评分数」取自苹果的当前版本维度,但目前与「评分总数」同值,苹果已不再分别提供这两个口径;「当前版本平均分」与「平均评分」通常也是同一个数,不是其中一个错了。「相似应用」苹果网页端公开接口不返回这层关系,这一列通常是空数组,属于能力缺口而不是解析失败——需要同品类应用,用「主分类 + 关键词搜索」自己取更实在。「包装类型」实测是 software,旧文档写的 track 是过时口径;4 个「合集」列只有返回合集对象时才有值,单应用查询下是空串。
覆盖范围只含商店里公开可见的应用与评论:已下架应用、已被删除的评论、订阅专享内容都不在其中。关键词搜索一次最多 200 条(苹果接口上限),评论单应用单地区最多 500 条。
结果长什么样
一条应用行是这样的:
| 应用名称 | 商店地区 | 主分类 | 平均评分 | 评分总数 | 当前版本号 |
|---|---|---|---|---|---|
| us | Photo & Video | 4.69 | 28826312 | 421.0.0 |
另外还有标识(App ID、Bundle ID、卖家)、名称、页面地址、四种尺寸图标、分类、版本与更新说明、价格与币种、开发者、评分与截图、支持设备等列;带附加项时多出「评论」与「相似应用」两列,评论是数组,每条含星级、标题、正文、作者、版本与有用票。
应用场景
做竞品评分监控,看「平均评分」和「评分总数」:连续几天跑同一批应用,能看出分数是被新增评价拉高还是拉低,评价量是在涨还是停滞。
定位差评原因,打开评论附加项,把「星级」筛到 1~2 星,读评论正文和评论时的版本,可以判断问题集中在哪个版本、是不是某次更新引入的。
做 ASO 复盘,按关键词搜索取一批应用,对比「主分类」「评分总数」和「当前版本号」,能看出同类产品最近是否在密集更新、谁的评价基数更大。
看某个应用在不同市场的状态,用同一个 App ID 分别填不同「商店地区」:价格、上架状态、评分都不一样,跨境选品时这一步比看官网准。
适用边界
只采集 App Store 公开的应用元数据、评分与评论正文,不含用户隐私、不下载应用包、不绕过付费或地区限制
- 适合用于
- 做 ASO,想知道某关键词下有哪些应用在榜、它们的评分和分类
- 盯竞品的版本更新、价格调整、评分变化,需要按天反复跑同一批 App ID
- 手上有一批应用链接或开发者 ID,要批量转成一张结构化应用表
- 要一批评论正文做情感分析或问题挖掘
- 不要用于
- 需要下载应用安装包(IPA)或破解付费应用
- 需要开发者后台数据(下载量、收入),App Store 公开接口不提供
- 需要 Google Play 或其他安卓商店的数据
失败处理
开发者声明的失败与重试处理方式,接入时建议一并写进系统提示词。
- 1某个 App ID 查不到时跳过并记日志,不影响其他记录;常见原因是该应用不在所选 country 上架
- 2评论与相似应用是附加项,Apple 对这两条接口有频率限制,被限流时对应列为空数组,其余字段照常返回
- 3关键词搜索结果超过 200 条时只拿得到前 200 条,这是官方搜索接口的上限
输入参数
调用本 Data App 需要传入的参数,与 manifest.json 的 input.schema 同源。
- 查询方式
mode选填string(enum)auto 按你填的输入自动判断(填了 term 就搜关键词,填了 ID 或链接就逐个查);search 只走关键词搜索;lookup 只走 ID / 链接查询可选值自动判断auto只搜关键词search只查指定应用lookup默认值auto - 搜索关键词
term选填string在 App Store 里搜这个词,返回匹配的应用。官方搜索接口单次最多给 200 条,超过的部分取不到(不是程序限制)默认值weather - App ID 列表
app_ids选填array<string>要查的应用数字 ID,必须是 JSON 数组,形如 ["389801252", "6444880223"];最多 200 个。ID 就是详情页链接里 /id 后面那串数字示例["389801252"] - Bundle ID 列表
bundle_ids选填array<string>应用的包标识,形如 ["com.crunchyroll.sfduel"];不知道 App ID 但有 Bundle ID 时用这个,最多 200 个示例["com.crunchyroll.sfduel"] - 开发者 ID 列表
developer_ids选填array<string>开发者的数字 ID,会返回该开发者名下全部应用,形如 ["1447891276"];开发者页链接 https://apps.apple.com/us/developer/xxx/id1447891276 里的数字就是它示例["1447891276"] - 应用链接
start_urls选填array<string>应用详情页或开发者页地址,必须是 JSON 数组。支持 apps.apple.com / itunes.apple.com 链接,也认单独的数字 ID 和 bundle ID;最多 200 条示例["https://apps.apple.com/us/app/street-fighter-duel/id6444880223"] - 商店地区
country选填string要查哪个区的 App Store,两位国家码:us 美国、cn 中国、jp 日本、hk 中国香港、tw 中国台湾。同一个应用在不同区的价格、上架状态、评分都不一样默认值us - 返回语言
lang选填string应用名、更新说明等文案的语言,形如 en-us、zh-cn;只影响文案语言,不影响取哪些应用。留空时按商店地区推断默认值en-us - 起始页
page选填integer关键词搜索从第几页开始,每页 50 条。官方搜索接口一次最多给 200 条,所以只有 1~4 页有效,填 5 以上会取不到数据范围1–100默认值1 - 结束页
end_page选填integer关键词搜索翻到第几页为止,0 表示翻到搜索接口给完为止;同时开启评论时,这个数字也是每个应用最多翻几页评论。评论每页 50 条,最多 10 页范围0–100默认值0 - 同时抓评论
include_reviews选填boolean开启后每个应用额外抓评论挂到 reviews 列,单个应用在单个地区最多 500 条(苹果硬上限),抓满约 15 秒。某个应用没有评论时该列为空数组,其余字段正常默认值false - 评论排序
reviews_sort选填string(enum)评论按最新排序还是按最有帮助排序,只在开启「同时抓评论」时生效可选值最新优先recent最有帮助优先helpful默认值recent - 同时抓相似应用
include_similar_apps选填boolean开启后每个应用额外尝试抓相似应用挂到 similarApps 列。⚠ 实测苹果网页端公开接口不返回该关系,此列大概率仍为空数组;需要相似应用可改用「主分类 + 关键词搜索」自行取同品类应用默认值false - 最多采集应用数
max_items选填integer本次运行最多返回多少个应用,按输入顺序取满即停。填 0 视为不限,上限 1000范围0–1000默认值50
输出数据
单条记录的字段结构,与 manifest.json 的 output.schema 同源。
- 来源标记
inputSourcestring这条记录由哪条查询产出。flow 取值:search(关键词搜索)、lookup-app(按 App ID)、lookup-bundle(按 Bundle ID)、lookup-url(按详情页链接)、developer(按开发者);sourceId 是触发它的原始输入。一次运行混多种查询时用它回溯示例{"flow":"lookup-app","sourceId":"389801252"} - 记录类型
wrapperTypestringiTunes 返回的对象类型。应用都是 software(实测 32/32);旧文档里写的 track 是过时口径,不要按它判断示例software - 对象种类
kindstring应用恒为 software示例software - App ID
trackIdstring应用在 App Store 的数字编号,同一条应用的稳定标识,也用作去重键示例389801252
示例数据
以下示例按 output.schema 生成;未提供示例值的字段使用结构占位符。
{
"inputSource": "{\"flow\":\"lookup-app\",\"sourceId\":\"389801252\"}",
"wrapperType": "software",
"kind": "software",
"trackId": "389801252",
"collectionId": "<collectionId>",
"bundleId": "com.facebook.Facebook",
"trackName": "Facebook",
"collectionName": "<collectionName>",
"trackCensoredName": "Facebook",
"collectionCensoredName": "<collectionCensoredName>",
"trackViewUrl": "https://apps.apple.com/us/app/facebook/id284882215",
"collectionViewUrl": "<collectionViewUrl>",
"artworkUrl60": "https://is1-ssl.mzstatic.com/image/thumb/.../60x60bb.png",
"artworkUrl100": "https://is1-ssl.mzstatic.com/image/thumb/.../100x100bb.png",
"artworkUrl512": "https://is1-ssl.mzstatic.com/image/thumb/.../512x512bb.png",
"artworkUrl600": "https://is1-ssl.mzstatic.com/image/thumb/.../600x600bb.png",
"primaryGenreName": "Social Networking",
"primaryGenreId": "6005",
"genres": "[\"Social Networking\",\"Lifestyle\"]",
"genreIds": "[\"6005\",\"6012\"]",
"contentAdvisoryRating": "12+",
"languageCodesISO2A": "[\"EN\",\"ZH\",\"JA\"]",
"fileSizeBytes": "389325824",
"minimumOsVersion": "15.0",
"releaseDate": "2019-02-05T08:00:00Z",
"currentVersionReleaseDate": "2026-11-10T08:00:00Z",
"releaseNotes": "修复若干问题并提升稳定性。",
"version": "Varies with device",
"price": 0,
"formattedPrice": "Free",
"currency": "USD",
"artistId": "284882215",
"artistName": "Meta Platforms, Inc.",
"artistViewUrl": "https://apps.apple.com/us/developer/meta-platforms-inc/id284882215",
"sellerUrl": "https://www.meta.com/",
"averageUserRating": 4.1,
"userRatingCount": 32000000,
"averageUserRatingForCurrentVersion": -1,
"currentVersionScore": -1,
"screenshotUrls": "[\"https://is1-ssl.mzstatic.com/image/thumb/.../1.png\"]",
"ipadScreenshotUrls": "[]",
"appletvScreenshotUrls": "[]",
"supportedDevices": "[\"iPhone8,1\",\"iPhone8,2\"]",
"similarApps": "[]",
"reviews": "[]"
}调用方式
本 Data App 支持通过 MCP、API、SDK 与文件导出方式接入,各接入方式共享同一套能力与计价。所有请求统一使用 Authorization: Bearer 请求头完成身份认证,凭证为 API Key(长期有效,在开放平台创建);MCP 客户端另支持 OAuth 免密钥登录。CLI、Skill 等更多接入方式正在规划中。本 Data App 异步运行,支持中途取消:取消后任务停止;已写回的部分保留,按写回计费。
通过 MCP(Model Context Protocol)协议,可在 Claude、Cursor 等 AI 客户端中直接调用本 Data App。选择你的客户端与认证方式,复制下方配置即可接入。
客户端配置
把 Bearer 后替换为长期有效的 API Key 即可,各类客户端与 CI、无浏览器环境通用。
{
"mcpServers": {
"bazhuayu_datahub": {
"type": "http",
"url": "https://mcp-v2.bazhuayu.com?pin=slzc81gz/appstore-scraper",
"headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
}
}
}让 AI 自己完成配置
不想手动改配置?复制配置提示词,粘贴到任意 AI 客户端对话框,由它按自身方式完成接入(默认引导你登录授权,不会让你把 API Key 发在对话里)。
如需在同一个 MCP 连接里指定多个 Data App,前往 MCP 连接页(已为你指定本 Data App)。
价格
按实际成功返回的数据条数计费,任务失败不计费。
多个计费事件按各自口径独立累计,具体以每一项说明为准;任务失败不计费。
立即体验
填写参数直接运行,结果来自真实调用。