概览
App Store 榜单·评分·评论(Charts / Ratings / Reviews):一个 App 三个采集动作。「榜单 Charts」返回各国家/地区、各分类的免费/付费/畅销/新品榜单前 N 名;「评分概览 Ratings」批量返回指定应用(最多 20 个,名称/ID/链接均可)的当前评分、评分人数、版本与价格;「评论 Reviews」分页抓取指定应用的最新或最有用用户评论。仅覆盖 Apple App Store,不支持 Google Play。适合榜单监控、ASO 竞品对比与应用口碑分析。
数据说明
- 数据来源是 Apple 面向公众的 RSS 榜单 / customerreviews、search 与 lookup 接口,纯 HTTP 直连。
- 支持 15 个常用国家/地区 storefront(us/cn/jp/de/gb/fr/au/ca/kr/tw/hk/sg/in/br/mx),榜单与评分因地区而异,应按目标市场分别查询。
- 榜单记录的排名按接口返回顺序从 1 编号;limit 超过实际返回条数时以实际为准。
- ratings / reviews 的 apps 支持 App Store 链接、数字 App ID 或应用名称;名称经 search 取第一个结果( documented 假设)。
- 评论每页 50 条,公开 RSS 最多约 500 条/应用;不提供评论回复数等未公开字段。
- 接口不可用时明确报告失败,不用空结果冒充成功。
结果示例
| 记录ID | 类型 | 国家 | 排名 | App | 开发者 | 评分 | 版本 | 分类 | 价格 |
|---|---|---|---|---|---|---|---|---|---|
| us:top-free:games:1 | 榜单 | us | 1 | Meowdoku! | Oakever Games | Games | 0 | ||
| rating:us:414478124 | 评分概览 | us | 3.9252 | 8.0.80 | Social Networking | 0 | |||
| 14799850652 | 评论 | us | 1 | 8.0.80 |
使用场景
- 榜单监控:定时抓取核心分类榜单,跟踪自家与竞品排名变化。
- ASO 竞品对比:同一榜单并排对比竞品构成、价格与评分水平。
- 口碑分析:批量抓取自家与竞品的最新评论,做 VOC 与产品改进分析。
- 多市场策略:按国家/地区分别查询榜单与评分,制定不同市场的发布策略。
适用边界
仅覆盖 Apple App Store(Apple 公开 RSS 榜单 / lookup / search / customerreviews 接口);不支持 Google Play(对应 Apify actor 2728 的 Google Play 侧不在边界内);不提供关键词联想/推荐词;不提供 Apple 未公开的下载量、Search Popularity 等指标
- 适合用于
- 查看某个国家/地区、某个分类的 App Store 免费/付费/畅销/新品榜单前 N 名应用
- 批量查询一批应用(名称/App ID/链接均可)的当前评分、评分人数、版本与价格
- 抓取指定应用的最新或最有用用户评论,做口碑与竞品分析
- 不要用于
- 需要 Google Play 榜单、评分或评论
- 需要 Apple 未公开的下载量、Search Popularity、关键词难度等指标
- 需要评论回复数等 Apple 评论接口未返回的字段
失败处理
开发者声明的失败与重试处理方式,接入时建议一并写进系统提示词。
- 1接口返回非 200 或非 JSON 时视为采集失败并明确报错,不用空结果冒充成功
- 2输入的应用无法解析(search/lookup 无结果)时记 warning 跳过该条,不中断整体运行;全部无法解析时运行成功但记录为 0
- 3榜单实际返回条目少于 limit 时以实际返回为准(合法空/短结果不报错)
输入参数
调用本 Data App 需要传入的参数,与 manifest.json 的 input.schema 同源。
- 采集动作
action选填string(enum)charts:榜单排名(免费/付费/畅销/新品,可按分类);ratings:批量评分概览(需填 apps);reviews:用户评论分页抓取(需填 apps)。可选值榜单charts评分概览ratings评论reviews默认值charts示例charts - 榜单类型
chart_type选填string(enum)仅 charts 动作使用。top-free:免费榜;top-paid:付费榜;top-grossing:畅销榜;new-apps:新品榜。可选值免费榜top-free付费榜top-paid畅销榜top-grossing新品榜new-apps默认值top-free示例top-free - 应用分类
genre选填string(enum)仅 charts 动作使用。all 表示全部分类的总榜;选择具体分类时榜单仅含该分类应用。可选值如 all / business / weather / utilities / travel / sports / social / reference …(共 23 项,试运行表单可搜索)默认值all示例all - 榜单条数
limit选填integer仅 charts 动作使用。期望返回的榜单条数,实际以接口返回为准。范围1–100默认值50示例10 - 应用列表
apps选填array<string>ratings / reviews 动作必填(≤20 个)。支持 App Store 链接、数字 App ID 或应用名称(名称通过 search 取第一个结果)。示例["wechat"] - 国家/地区
country选填string(enum)App Store 国家/地区代码,榜单与评分因地区而异。可选值如 us / cn / jp / de / gb / fr / au / ca …(共 15 项,试运行表单可搜索)默认值us示例us - 评论排序
sort选填string(enum)仅 reviews 动作使用。mostrecent:最新;mosthelpful:最有用。可选值最新mostrecent最有用mosthelpful默认值mostrecent示例mostrecent - 每应用评论数
max_reviews_per_app选填integer仅 reviews 动作使用。每个应用最多抓取的评论数,公开 RSS 每页 50 条、最多约 500 条。范围1–500默认值50示例30
输出数据
单条记录的字段结构,与 manifest.json 的 output.schema 同源。
- 记录ID
record_idstring记录唯一标识,用作去重键。榜单为 国家:榜单类型:分类:排名;评分概览为 rating:国家:AppID;评论为 Apple 评论 ID。示例us:top-free:games:1 - 记录类型
record_typestring本条记录所属的动作类型:榜单 / 评分概览 / 评论。示例chart - 国家/地区
countrystring本条记录所属的国家/地区代码。示例us - 榜单类型
chart_typestring榜单记录所属榜单:top-free / top-paid / top-grossing / new-apps。示例top-free
示例数据
以下示例按 output.schema 生成;未提供示例值的字段使用结构占位符。
{
"record_id": "us:top-free:games:1",
"record_type": "chart",
"country": "us",
"chart_type": "top-free",
"genre": "games",
"genre_name": "Games",
"position": 1,
"app_id": "6761760135",
"app_name": "Meowdoku!",
"publisher": "Oakever Games",
"rating": 4.5,
"rating_count": 81820,
"app_version": "8.0.80",
"current_version_release_date": "2026-10-23T01:46:47Z",
"price": 0,
"author_name": "scottsanett",
"title": "No iPhone Duo support",
"text": "Great app but…",
"published_date": "2026-11-16T18:07:53-07:00",
"vote_count": 0,
"review_url": "https://itunes.apple.com/us/review?id=414478124&type=Purple%20Software"
}调用方式
本 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=Matrix_He/appstore-charts-ratings",
"headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
}
}
}让 AI 自己完成配置
不想手动改配置?复制配置提示词,粘贴到任意 AI 客户端对话框,由它按自身方式完成接入(默认引导你登录授权,不会让你把 API Key 发在对话里)。
如需在同一个 MCP 连接里指定多个 Data App,前往 MCP 连接页(已为你指定本 Data App)。
价格
按实际成功返回的数据条数计费,任务失败不计费。
多个计费事件按各自口径独立累计,具体以每一项说明为准;任务失败不计费。
立即体验
填写参数直接运行,结果来自真实调用。
共 23 项,输入筛选