按 App Store 榜单查询 iPhone 应用

选择 App Store 榜单类型和应用分类，并提供支持的地区、语言代码。查询成功完成后，获取最多 20 条可用的 iOS 应用记录，查看记录中的榜单位置和商店信息。

你的 AI

在你的 AI 中使用

多步骤任务，也可以在你常用的 AI 中继续完成。

CodexClaude CodeCursorWindsurfCline

查看指令

使用 apple-app-list 获取用户指定的 Apple App Store 榜单。接受日常说法的榜单类型、应用分类、国家或地区、语言，并对应到受支持的 app_collection、app_category、location_code 和 language_code。只有用户表述清楚时，才将免费应用、付费应用、高收入应用、新应用、新上架免费应用或新上架付费应用对应到已记录的榜单类型。把清楚的日常分类名称对应到受支持分类。若任何选择含糊或不受支持，请让用户用日常名称重新选择，不要要求代码；不要猜测或使用默认值。始终设置必需的固定 request.depth=20，不要询问用户，也不要承诺返回二十条应用。保留榜单、分类、国家和语言背景。查询成功后，整理可用的应用名称、榜单位置、App Store 链接、带评分上限的评分、评论数量，以及标明币种的展示价格。区分两种位置含义和来源总数与实际返回条目。缺失值保留为未知。说明榜单位置不代表推荐或收入，显示价格不包括所有应用内费用，结果接收时间也不能保证商店信息仍是当前状态。

任务:
请查看[美国] App Store 中[英语]的[免费 iPhone 应用]和[游戏分类]榜单。整理应用、商店链接、在榜单中的位置、评分及价格所用货币（例如美元）；说明用了哪个榜单，并标出缺失信息。

粘贴到已连接工具的 AI 对话中。

连接指南

每次调用最多 0.15 积分

按确认的实际用量结算，未使用的预留额度会恢复到可用余额。

DataForSEO

按 App Store 榜单查询 iPhone 应用

得到的结果

榜单查询成功完成后，获取所选 App Store 榜单、分类和地区语言范围内的可用应用。每条记录可能包括应用 ID 与名称、榜单位置、商店页面和图标链接，以及可用的评分及评分上限、评论数量、显示价格与币种。 Agent 可以将返回条目整理成榜单摘要。列表旁应保留榜单类型、分类、地区和语言，以便按正确范围解读位置及商店信息。

从你的任务开始

请查看[美国] App Store 中[英语]的[免费 iPhone 应用]和[游戏分类]榜单。整理应用、商店链接、在榜单中的位置、评分及价格所用货币（例如美元）；说明用了哪个榜单，并标出缺失信息。

你需要了解的范围

固定 depth 20 限制请求深度，不保证返回二十条或完整榜单。位置属于所选榜单和地区，不是编辑推荐、全球排名、安装量或收入。完成时间和信息新鲜程度没有保证，结果接收时间也不代表每项位置或价格的更新时间。缺失信息保持未知。

输入与输出

开始前检查当前输入要求、可用状态和最高预留费用。

输入参数

输入参数
字段 / 路径	类型	是否必填	含义
榜单查询请求`request`	`object`	必填	必填 App Store 榜单查询，包括榜单类型、分类、支持的语言代码、地区代码及 depth 20。五项都需提供，示例值不会自动填入。必填字段 `app_collection, location_code, language_code, depth, app_category`
榜单条目上限`request.depth`	`integer`	必填	必填整数，只能为 20，设置请求的解析深度并限制列表请求，不保证返回二十个应用或覆盖完整榜单。固定值 `20`
应用分类`request.app_category`	`string`	必填	必填的受支持 App Store 分类代码，长度为 1–256 字符，例如 games 或 lifestyle。使用分类代码，不是应用名称、应用 ID 或任意描述；本工具不能省略分类。最小长度 `1` 最大长度 `256`
语言代码`request.language_code`	`string`	必填	必填的受支持 App Data Apple 语言代码，长度为 1–256 字符。例如 en 表示英语。使用代码而非语言名称；en 只是示例，不是固定语言或默认值。最小长度 `1` 最大长度 `256`
地区代码`request.location_code`	`integer`	必填	必填的受支持 App Data Apple 商店地区代码，为 1 至 100,000,000 的整数。例如 2840 表示美国。示例不是默认值或固定市场，符合数值范围也不代表该地区一定受支持。最小值 `1` 最大值 `100000000`
榜单类型`request.app_collection`	`string`	必填	必填的受支持 iOS 榜单类型，长度为 1–256 字符。文档列出的值为 top_free_ios、top_paid_ios、top_grossing_ios、new_ios、new_free_ios 和 new_paid_ios，分别选择相应免费、付费、畅销或新应用列表，需明确填写要查询的类型。最小长度 `1` 最大长度 `256`

查看原始 JSON

{
  "type": "object",
  "required": [
    "request"
  ],
  "properties": {
    "request": {
      "type": "object",
      "required": [
        "app_collection",
        "location_code",
        "language_code",
        "depth",
        "app_category"
      ],
      "properties": {
        "depth": {
          "type": "integer",
          "const": 20
        },
        "app_category": {
          "type": "string",
          "maxLength": 256,
          "minLength": 1
        },
        "language_code": {
          "type": "string",
          "maxLength": 256,
          "minLength": 1
        },
        "location_code": {
          "type": "integer",
          "maximum": 100000000,
          "minimum": 1
        },
        "app_collection": {
          "type": "string",
          "maxLength": 256,
          "minLength": 1
        }
      },
      "additionalProperties": false
    }
  },
  "additionalProperties": false
}

返回结构

暂未配置返回字段说明。

关于这个工具，你可能还想知道。

输入要求、结果含义，以及使用前需要了解的细节。

连接指南

按任务选择免费、付费、畅销榜或新应用榜中的一种，并提供受支持的分类代码，例如 games 或 lifestyle；本工具必须填写分类。选择畅销榜只返回榜单记录，不返回各应用收入。语言和地区也需使用 App Data 支持的代码，en 和 2840 只是示例，不是默认值或唯一可用的地区语言组合。

按 App Store 榜单查询 iPhone 应用

按 App Store 榜单查询 iPhone 应用

得到的结果

从你的任务开始

你需要了解的范围

输入与输出

输入参数

返回结构

选择榜单类型

选择分类和地区

了解榜单结果

关于这个工具，你可能还想知道。

得到的结果

从你的任务开始

你需要了解的范围

输入与输出

输入参数

返回结构

选择榜单类型

选择分类和地区

了解榜单结果

关于这个工具，你可能还想知道。

榜单类型和分类怎么选择？

一定会返回二十个应用吗？

榜单位置数字代表什么？

免费标记、价格和评分能证明价值或全部费用吗？

何时拿到榜单，是否实时？