概览
按关键词、App ID 或排行榜采集苹果 App Store 的应用详情,可选同时抓评分分布与用户评论。
数据说明
数据来自苹果应用商店的公开目录,覆盖美国、中国、日本等 40 多个地区。应用行与评论行混在同一张表里,用「行类型」区分:应用行的评论列为空,评论行的应用信息只保留 App ID、应用名称和地区。
几个容易看错的地方:「价格」是商店标价,单位见「币种」,不含各地区的税费与促销折扣;「价格(展示值)」是商店页面上原样展示的文本。「平均评分」与「评分总数」是采集当刻的累计值,不是当天新增;「当前版本评分数」目前恒等于「评分总数」,苹果已不再分别提供这两个口径。「评论时间」带发布地的时区偏移,同一批数据里可能混着多个时区。
覆盖范围只含商店里公开可见的应用与评论:已下架应用、已被删除的评论、订阅专享内容都不在其中。
结果长什么样
每条记录是一个应用或一条评论。一条应用行是这样的:
| 应用名称 | 商店地区 | 主分类 | 平均评分 | 评分总数 | 当前版本号 |
|---|---|---|---|---|---|
| us | Photo & Video | 4.69 | 28826312 | 421.0.0 |
一条评论行是这样的:
| 评论者 | 评论星级 | 评论针对的版本 | 有用票净值 | 评论时间 |
|---|---|---|---|---|
| PhotoFan2024 | 4 | 421.0.0 | 12 | 2026-03-15T10:59:33-07:00 |
此外还有开发者、应用介绍、更新说明、图标与截图地址、支持语言、支持设备、年龄分级、价格与币种等列。
应用场景
做竞品评分监控,看「平均评分」和「评分总数」:连续几天跑同一批应用,能看出分数是被新增评价拉高还是拉低,评价量是在涨还是停滞。
定位差评原因,把「评论星级」筛到 1~2 星,读「评论正文」和「评论针对的版本」,可以判断问题集中在哪个版本、是不是某次更新引入的。
判断分数结构是否健康,看「评分分布」里一星到五星各自的条数:平均分不高但高分占大头,通常是少数一星在拉低,而不是整体口碑差。
看某个国家或分类的竞争格局,用排行榜方式取前 50 名,对比「主分类」「评分总数」和「当前版本号」,能看出头部产品最近是否在密集更新。
适用边界
只采集 App Store 公开的应用元数据、评分分布与评论正文,不含用户隐私、不下载应用包、不绕过付费或地区限制;单次最多 1000 条应用 + 1000 条评论,评论单应用单地区最多 500 条
- 适合用于
- 想看某国免费榜 / 付费榜上都有谁,需要榜单名次对应的一批应用详情
- 做 ASO,需要某个关键词下应用的评分与 1~5 星分布,判断分数是被差评拉低还是样本太少
- 做评论挖掘,只要 1~2 星差评或只要最近半年的评论
- 一次对比同一个应用在多个国家区的价格、评分和上架状态
- 不要用于
- 需要下载应用安装包(IPA)或破解付费应用
- 需要开发者后台数据(下载量、收入),App Store 公开接口不提供
- 需要 Google Play 或其他安卓商店的数据
失败处理
开发者声明的失败与重试处理方式,接入时建议一并写进系统提示词。
- 1某个 App ID 查不到时跳过并记日志,不影响其他记录;常见原因是该应用不在所选 country 上架
- 2评分分布要逐应用请求网页接口,实测容量约 1 次/10 秒;被限流时该列为空,应用行其余字段照常输出
- 3评论抓到 0 条时先确认该应用在该地区是否真有评论:新上架应用、非英语区的小众应用常常就是没有评论
- 4星级与日期过滤在抓回来之后做,单应用单地区最多 500 条;过滤条件太严时可能一条都不剩,可放宽条件或分多次跑
输入参数
调用本 Data App 需要传入的参数,与 manifest.json 的 input.schema 同源。
- 采集方式
mode选填string(enum)search 按关键词搜应用;details 按 App ID 查应用详情;reviews 只抓评论(可筛星级与日期);charts 抓免费榜 / 付费榜前 N 名再补详情可选值关键词搜索search应用详情details只抓评论reviews排行榜charts默认值search - 搜索关键词
search_term选填stringsearch 模式下要搜的词。官方搜索接口单次最多给 200 条,超过的部分取不到(不是程序限制)默认值weather - 多个搜索关键词
search_terms选填array<string>一次跑多个词,填了它就忽略「搜索关键词」。形如 ["weather","meditation"],最多 200 个;「最多采集应用数」是整个运行共享的上限示例["weather","meditation"] - App ID 列表
app_ids选填array<string>要查的应用,数字 ID 或详情页链接都行(如 ["389801252","https://apps.apple.com/us/app/x/id6444880223"]),最多 200 个。ID 就是链接里 /id 后面那串数字示例["389801252","6444880223"] - 榜单类型
chart_type选填string(enum)charts 模式抓哪个榜:免费榜或付费榜可选值免费榜top-free付费榜top-paid默认值top-free - 榜单取前几名
chart_limit选填integercharts 模式抓榜单前多少名去补详情。苹果榜单接口一次最多 100 名范围1–100默认值50 - 商店地区
country选填string要查哪个区的 App Store,两位国家码:us 美国、cn 中国、jp 日本、hk 中国香港、tw 中国台湾。同一个应用在不同区的价格、上架状态、评分都不一样默认值us - 多个商店地区
countries选填array<string>一次跑多个区,填了它就忽略「商店地区」。形如 ["us","jp"],最多 20 个;每条记录会用 country 列标明来自哪个区示例["us","jp"] - 最多采集条数
max_items选填integer应用行和评论行各自的上限(不是加起来)。0 表示不限,上限 1000范围0–1000默认值50 - 同时抓评论
include_reviews选填booleansearch / details / charts 模式下,每个应用再抓评论并单独输出评论行。会明显变慢:评论接口实测约 1 次/10 秒,且每页只有 20 条默认值false - 同时抓评分分布
include_rating_histogram选填boolean给每个应用补 1~5 星各自的评分数(ratingHistogram 列)。同样要过慢接口,约 1 次/10 秒,所以只给前 50 个应用取;超过部分该列为空默认值false - 评论排序
review_sort选填string(enum)按最新还是按最有帮助排序,只影响抓到哪批评论,不影响总条数上限可选值最新优先mostRecent最有帮助优先mostHelpful默认值mostRecent - 最低星级
review_min_rating选填integer只要不低于这么多星的评论,填 1~5;留空不限。注意过滤发生在抓回来之后:只要 1 星时,最多翻 10 页(200 条)里面挑,可能挑不满范围1–5 - 最高星级
review_max_rating选填integer只要不高于这么多星的评论,填 1~5;留空不限。和「最低星级」一起填就是取中间区间范围1–5 - 评论起始日期
reviews_since选填string只要这一天及之后的评论,格式 YYYY-MM-DD(如 2026-01-01);留空不限。同样是抓回来之后过滤
输出数据
单条记录的字段结构,与 manifest.json 的 output.schema 同源。
- 行唯一键
recordKeystring本行的去重键:应用行为 app:{appId}:{country},评论行为 review:{reviewId}:{country}。同一应用在多国、同一应用的多条评论都不会互相覆盖示例app:389801252:us - 行类型
rowTypestringapp 表示应用行(应用字段有值、评论字段为空);review 表示评论行(评论字段有值、应用字段只留 appId / appName / country)示例app - App ID
appIdstring苹果应用数字 ID,同一个应用在不同国家是同一个 ID;本表用它关联应用行与评论行示例389801252 - 应用名称
appNamestringApp Store 展示的应用名示例Instagram
示例数据
以下示例按 output.schema 生成;未提供示例值的字段使用结构占位符。
{
"recordKey": "app:389801252:us",
"rowType": "app",
"appId": "389801252",
"appName": "Instagram",
"bundleId": "com.burbn.instagram",
"country": "us",
"searchTerm": "<searchTerm>",
"appUrl": "https://apps.apple.com/us/app/instagram/id389801252",
"developer": "Instagram, Inc.",
"developerUrl": "https://apps.apple.com/us/developer/instagram-inc/id389801255",
"sellerName": "Instagram, Inc.",
"sellerUrl": "http://instagram.com/",
"description": "Ever wish your photos could really show...",
"ratingHistogram": "{\"star1\":1238676,\"star2\":277271,\"star3\":700017,\"star4\":2010788,\"star5\":25495053}",
"releaseNotes": "Bug fixes and performance improvements.",
"version": "421.0.0",
"currentVersionDate": "2026-03-16T17:05:13Z",
"releaseDate": "2010-10-06T04:01:00Z",
"price": 0,
"currency": "USD",
"formattedPrice": "Free",
"rating": 4.69,
"ratingCount": 28826312,
"ratingCountCurrentVersion": 28826312,
"contentRating": "12+",
"genres": "[\"Photo & Video\",\"Social Networking\"]",
"primaryGenre": "Photo & Video",
"iconUrl": "https://is1-ssl.mzstatic.com/image/thumb/.../512x512bb.jpg",
"screenshotUrls": "[\"https://.../1.png\"]",
"ipadScreenshotUrls": "[]",
"minimumOsVersion": "16.0",
"fileSizeBytes": 291938304,
"languages": "[\"EN\",\"ZH\",\"JA\"]",
"features": "[\"iosUniversal\"]",
"supportedDevices": "[\"iPhone8,1\"]",
"reviewId": "13851595728",
"reviewTitle": "Great app but needs improvements",
"reviewContent": "I love using this app for photo sharing...",
"reviewRating": 4,
"reviewAuthor": "PhotoFan2024",
"reviewAuthorUrl": "https://itunes.apple.com/us/reviews/id249089736",
"reviewAppVersion": "421.0.0",
"reviewDate": "2026-03-15T10:59:33-07:00",
"reviewVoteSum": 12,
"reviewVoteCount": 7
}调用方式
本 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/apple-app-store-scraper",
"headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
}
}
}让 AI 自己完成配置
不想手动改配置?复制配置提示词,粘贴到任意 AI 客户端对话框,由它按自身方式完成接入(默认引导你登录授权,不会让你把 API Key 发在对话里)。
如需在同一个 MCP 连接里指定多个 Data App,前往 MCP 连接页(已为你指定本 Data App)。
价格
每提交一次任务计费一次,与返回条数无关。
按实际成功返回的数据条数计费,任务失败不计费。
多个计费事件按各自口径独立累计,具体以每一项说明为准;任务失败不计费。
立即体验
填写参数直接运行,结果来自真实调用。