App Store 用户评论采集
按应用与国家抓 App Store 的真实用户评论,返回星级、标题、正文、时间、作者与是否修改过
概览
把某个应用的真实用户评论拉成一张表:给了几星、标题和正文写了什么、什么时候写的、评论后来改过没有。想搞清楚用户到底在抱怨什么、海外用户和国内用户说的差多少,不用再一条条往下翻评论页。
同一个应用在不同国家的评论是分开的两套,所以「看哪个市场」要一起定。苹果对每个应用在每个国家只公开最近约 500 条公开评论,更早的拿不到。
数据说明
评论来自苹果应用商店网页版自己在用的评论接口,覆盖各区市场。只覆盖苹果 App Store,不含安卓的 Google Play。
一行是一条评论,不是一次评分。苹果的评论由「标题 + 正文」两段组成,两段都保留原文,不做翻译、不做改写、不做情感判断。
「评论时间」是苹果这条评论记录的时间;评论被作者改过时,「是否修改过」为 true,此时这个时间是最后一次修改时间,不是最初发表时间。
「星级」是评论者自己打的 1 到 5 星,和商店页上显示的综合评分不是一回事,后者是所有打分用户的平均,包括只打分不写字的。
苹果这个公开接口不提供「评论针对哪个应用版本」,也不提供「有帮助票数」,更不提供开发者回复和评论语言标注。所以这四项这里没有,不要拿别的字段凑数。想要差评就按星级筛,想要新评论就按起始日期筛,想只要评论正文有没有改过就看「是否修改过」。
接口按出口 IP 限流,一次跑太多会被要求排队等待。碰到这种情况程序会自动等一会儿再试,日志里会写明,已经拿到的评论照样写回,不会整次失败。同一个应用在国家多、条数大的场景下跑得会慢一些,属于正常。
结果长什么样
每行是一条评论。
| 星级 | 评论标题 | 评论正文 | 评论时间 |
|---|---|---|---|
| 3 | Chess matches with Oscar | I love that the app added chess, but I would much rather have the option to start a harder match rather than it being forced and randomized. | 2026-11-15 |
| 1 | 垃圾 | 有錢高級 說什麼就什麼 隨時可以封帳號禁言 小心小心 | 2026-11-16 |
| 4 | 尺寸不符iP15pro | 更新后经常性点不到左右上角的选项 size与屏幕不合 | 2026-11-15 |
此外还有来源、应用编号、应用名、评论者、评论编号、是否修改过、国家或地区、应用页面链接、采集时间等字段。
应用场景
- 差评归集:按「星级」筛出 1 星和 2 星,把「评论标题」和「评论正文」贴进表格做归类,一天之内就能看清主要抱怨集中在哪几类问题。
- 跨国本地化对比:同一个应用在多个市场各抓一批,比较各国用户在意的东西——定价、语言、支付方式、离线可用性,通常差得很明显。
- 只看新反馈:用「评论编号」在下游去重,或者把「只看这个日期之后」设成 7 days,就能只拿到最近一周的新评论。
- 人工润色过的评论:「是否修改过」为 true 的评论是作者事后改过的,做原话引用时优先用 false 的。
适用边界
只覆盖苹果 App Store,不含 Google Play;每个应用在每个国家最多取到最近约 500 条评论;单次最多 20 个应用、10 个国家,写回上限 2 万条
- 适合用于
- 要读某个应用的真实用户评论,找出用户到底在抱怨什么、哪些版本问题集中
- 只想要差评:按 1 星、2 星筛选,直接拿来做问题归集
- 看同一个应用在多个国家或地区的评论差异,判断本地化做得好不好
- 不要用于
- 要安卓端 Google Play 的评论:这里只覆盖苹果 App Store
- 要开发者对评论的回复内容:苹果公开的评论接口不提供这一项
- 要每条评论针对哪个应用版本:苹果公开的评论接口不提供这一项
- 要某个应用的全部历史评论:苹果每个应用每个国家只公开最近约 500 条
失败处理
开发者声明的失败与重试处理方式,接入时建议一并写进系统提示词。
- 1应用名搜索匹配错了,换成商店链接或应用编号再跑,日志里会写明匹配到了哪个应用
- 2某个国家的评论为 0 条,多半是该应用没在那个市场上架,换个国家试试
- 3过滤条件太窄(比如只看 1 星又要最近 3 天)返回很少是正常的,放宽日期或星级
- 4日志里出现「被限流」是这个接口按出口 IP 排队,程序会自动等待重试;实在拿不满就把每个应用每个国家的条数调小,或过几分钟重跑
- 5网络临时不通导致失败时,隔几分钟原样重跑即可
输入参数
调用本 Data App 需要传入的参数,与 manifest.json 的 input.schema 同源。
- 应用
apps必填array<string>要抓哪些应用的评论。可以填商店链接(apps.apple.com/us/app/xxx/id426826309)、数字编号(426826309)或应用名(Duolingo、微信)。填应用名时会在第一个国家里搜索并取最匹配的一条,日志会写明匹配到了哪个应用;怕抓错就直接贴链接。一次最多 20 个。数量最多 20 项示例["Duolingo"] - 国家或地区
countries选填array<string>要抓哪些市场的评论,填两位国家或地区代码,例如 US、CN、JP、GB、HK。苹果的评论按市场上架情况分开,同一个应用在不同国家的评论完全不同;一个应用在每个市场最多只有最近约 500 条公开评论。数量最多 10 项默认值US示例["US"] - 每个应用每个国家取多少条
maxReviews选填integer每个应用在每个国家最多写回多少条符合筛选条件的评论,默认 100。苹果对每个应用每个国家只公开最近约 500 条,填超过 500 也只能到这;筛选条件很窄时会一直翻到最后一页才停。范围1–500默认值100 - 只看这些星级
ratings选填array<string>只保留指定星级的评论,例如填 1 和 2 就只要差评。留空表示五个星级全要。数量最多 5 项 - 只看这个日期之后
reviewsSince选填string只保留这个日期当天及之后的评论,可以填具体日期(2026-10-01),也可以填相对期(7 days、2 weeks、1 month,从这次运行时刻往回推)。留空表示不限时间。
输出数据
单条记录的字段结构,与 manifest.json 的 output.schema 同源。
- 评论编号
review_keystring由来源、应用编号、国家、评论编号拼成,同一条评论恒定不变,可用于跨次运行去重(只看上次之后的新评论就靠它)示例app_store|426826309|US|14794437439 - 来源
sourcestring固定为 app_store,表示苹果应用商店示例app_store - 应用编号
app_idstring苹果应用商店里的应用编号示例426826309 - 应用名
app_namestring解析出来的应用名,可用来核对应用名搜索是否匹配到了正确的那一个示例Strava: Run, Bike, Walk
示例数据
以下示例按 output.schema 生成;未提供示例值的字段使用结构占位符。
{
"review_key": "app_store|426826309|US|14794437439",
"source": "app_store",
"app_id": "426826309",
"app_name": "Strava: Run, Bike, Walk",
"review_id": "14794437439",
"user_name": "Sirwaterloo",
"rating": 1,
"title": "Audio Ducking",
"text": "A few weeks out from my first marathon and I got the audio ducking bug.",
"date": "2026-11-15T16:16:53+00:00",
"is_edited": false,
"country": "US",
"app_url": "https://apps.apple.com/us/app/id426826309",
"collected_at": "2026-11-17T08:57:31+00:00"
}调用方式
本 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=bazhuayu_Beth/app-store-reviews",
"headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
}
}
}让 AI 自己完成配置
不想手动改配置?复制配置提示词,粘贴到任意 AI 客户端对话框,由它按自身方式完成接入(默认引导你登录授权,不会让你把 API Key 发在对话里)。
如需在同一个 MCP 连接里指定多个 Data App,前往 MCP 连接页(已为你指定本 Data App)。
价格
按实际成功返回的数据条数计费,任务失败不计费。
多个计费事件按各自口径独立累计,具体以每一项说明为准;任务失败不计费。
立即体验
填写参数直接运行,结果来自真实调用。