logo

App Store 评论 API(22 字段)

按 App ID 或应用名批量取苹果 App Store 评论,每条一行 22 列,带序号、页码与采集时间,便于分页续跑和跨批次对账

发布者
价格
¥0.0053 / 条
最近更新
2026-11-18

概览

按 App ID 或应用名批量取苹果 App Store 的公开评论,每条评论一行,共 22 列,带序号、页码与采集时间。

数据说明

数据来自苹果 App Store 的公开评论目录,可按国家店铺分别采集,覆盖美国、英国、加拿大、澳洲、德国、法国、日本、中国等主流地区。每条记录就是一条评论,不会混入应用行;同一个应用在不同店铺的评论算不同记录。

与只保留正文和星级的取法相比,这里多了几列用于追溯的元数据:「全局序号」「页内序号」「来源页号」记录这条评论是第几次请求、第几页的第几条,多次运行的结果可以按序号对齐,也能接着上次的页数续跑;「采集时间」是这条记录抓下来的时刻,用于判断数据新旧。

几个容易看错的地方:「评论日期(原样)」是苹果返回的原始字符串,带发布地时区偏移;「评论日期(ISO)」是同一时刻换算出的日期,两列同源,排序按前者更准、入库用后者更省事。「有用票描述」不是原文,是按「有用票数」和「投票总数」拼出来的句子。「当前版本评论数」恒为 0,苹果已不再按版本拆分这个口径。「页数上限」固定 10 是苹果每个国家的上限,不是该应用真实有几页。

覆盖范围只含商店里公开可见的评论:已被删除的评论、订阅专享内容、开发者后台数据都不在其中。单个应用在单个店铺最多 500 条。

结果长什么样

每条记录是一条评论:

评论 ID星级评论者昵称评论时的版本评论日期(原样)有用票数
122603653491Fox3782365.0.02026-02-01T22:53:54-07:003

此外还有评论标题、评论正文、评论者 ID、App ID、平台、商店地区、排序方式、全局序号、页内序号、来源页号、页数上限、当前版本评论数、采集时间等列。

应用场景

把评论导进数仓或训练集,看「全局序号」和「采集时间」:同一批数据反复跑会追加新评论,靠序号能判断哪些是这次新增的,不必按正文去重;采集时间还能直接做数据新鲜度监控。

按页续跑评论多的长尾应用,用「来源页号」接着上次的位置:一次翻不完,下次从上次的最大页号加一开始,既不重复也不漏。

跟新版本的口碑变化,按「评论时的版本」分组看「星级」分布:某一版之后一星占比抬升,再去读该版本下的「评论正文」,通常能锁定是哪个改动引起的不满。

区分 iOS 与 macOS 应用的反馈,用「平台」列拆开:同一个应用两端的功能和评分体系不同,混在一起算平均分容易得出错误结论。

适用边界

只采集 App Store 公开评论与其元数据,不含用户隐私,不绕过地区或付费限制

  • 适合用于
  • 要把评论导进数仓/NLP 训练集,需要带序号、页号、采集时间这类可追溯字段
  • 需要区分 iOS 与 macOS 应用,或跳过 macOS 只跑 iOS
  • 需要评论者 ID 做跨应用关联(比昵称稳定)
  • 按页续跑:上次跑到第 7 页,这次从第 8 页接着采
  • 不要用于
  • 只要评论正文、不需要元数据(用 appstore-reviews 更轻)
  • 需要按星级筛选(RSS 只给排序不给过滤)
  • 需要 Google Play 评论

失败处理

开发者声明的失败与重试处理方式,接入时建议一并写进系统提示词。

  1. 1每个应用每国最多 500 条(10 页 × 50 条),第 11 页苹果返回 400,属上游上限
  2. 2App ID 认不出会跳过;全部跳过时报 invalid-input
  3. 3苹果限流会退避重试,仍失败报 upstream-rate-limited
  4. 4include_macos=false 且目标全是 macOS 时报 no-records(这是预期行为,不是故障)

输入参数

调用本 Data App 需要传入的参数,与 manifest.json 的 input.schema 同源。

  • Apple 应用 IDproduct_ids选填array<string>
    必须是 JSON 数组,形如 ["389801252"]。数字 ID 或应用链接都行;不是 ID 的值会跳过,不计入结果。多个 ID 会依次采集
    示例["389801252"]
  • 按名字自动找应用app_name选填string
    只知道名字时填这个(如 netflix),会先在该国搜索再抓第一条命中的评论。product_ids 非空时忽略此项
  • 商店地区country选填string
    两位国家码小写,如 us / gb / jp / cn / hk / tw。支持:us gb ca au nz ie in sg ph my de fr es it nl be at ch se no dk fi pt pl cz gr hu ro tr ru ua il ae sa eg za ng ke gh jp kr cn tw hk th id vn br mx ar cl co pe
    默认值us
  • 排序sort选填string(enum)
    mostrecent 最新 / mosthelpful 按有用票。mostfavorable、mostcritical 苹果 RSS 不支持,填了会按最新抓(结果里 sort_order 仍如实回填)
    可选值最新mostrecent最有用mosthelpful最有好评(会退回最新)mostfavorable最有差评(会退回最新)mostcritical默认值mostrecent
  • 每个应用最多条数max_reviews选填integer
    默认 100;填 0 表示不限(内部兜底 1250,即 10 页 × 50 条 × 2.5 个国家的量级)
    范围0–10000默认值100
  • 从第几页开始start_page选填integer
    默认 1。上次跑到第几页就从下一页接着跑,便于续跑;超过 10 页苹果会返回 400,本包会直接结束
    范围1–500默认值1
  • 包含 macOS 应用include_macos选填boolean
    关闭后,识别为 macOS 的 App ID 会被跳过、不产生记录(判断依据是 lookups 返回的支持机型里含 Mac)
    默认值true

输出数据

单条记录的字段结构,与 manifest.json 的 output.schema 同源。

  • 全局序号position_globalinteger
    本次运行里第几条(从 1 开始,跨应用连续计数)
    示例1
  • 页内序号position_on_pageinteger
    在该页 50 条里的位置(从 1 开始)
    示例1
  • 评论 IDreview_idstring
    苹果给这条评论的编号,按它 + 国家去重
    示例12260365349
  • 评论标题review_titlestring
    评论的标题行,可能为空串
    示例Filters

示例数据

以下示例按 output.schema 生成;未提供示例值的字段使用结构占位符。

output.example
{
  "position_global": 1,
  "position_on_page": 1,
  "review_id": "12260365349",
  "review_title": "Filters",
  "review_text": "INSTAGRAM WHERE ARE MY CUTE FILTERS?! Bring them back.",
  "rating": 1,
  "review_date": "Feb 01, 2025",
  "review_date_iso": "2025-02-01",
  "reviewed_version": "365.0.0",
  "helpfulness_text": "3 out of 9 customers found this review helpful",
  "helpful_count": 3,
  "total_helpful_count": 9,
  "author_name": "Fox3782",
  "author_id": "566053959",
  "product_id": "389801252",
  "app_platform": "ios",
  "app_country": "gb",
  "sort_order": "mostrecent",
  "page_number": 1,
  "total_page_count": 10,
  "reviews_for_current_version": 0,
  "fetch_timestamp": "2026-11-18T00:20:00Z"
}

调用方式

本 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 配置
{
  "mcpServers": {
    "bazhuayu_datahub": {
      "type": "http",
      "url": "https://mcp-v2.bazhuayu.com?pin=slzc81gz/appstore-reviews-api",
      "headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
    }
  }
}

让 AI 自己完成配置

不想手动改配置?复制配置提示词,粘贴到任意 AI 客户端对话框,由它按自身方式完成接入(默认引导你登录授权,不会让你把 API Key 发在对话里)。

如需在同一个 MCP 连接里指定多个 Data App,前往 MCP 连接页(已为你指定本 Data App)。

价格

每次运行

每提交一次任务计费一次,与返回条数无关。

¥0.0004/ 次
按条计费

按实际成功返回的数据条数计费,任务失败不计费。

¥0.0053/ 条

多个计费事件按各自口径独立累计,具体以每一项说明为准;任务失败不计费。

立即体验

填写参数直接运行,结果来自真实调用。

示例
参数按 input.schema 校验后提交
¥0.0053 / 条