App Store 应用列表数据库

数据库概述

数据库名称：databases/app_store/listings

App Store 应用列表数据库收录百万个已发布应用及信息应用 ID、图标、描述、评论数量、评分、图片等。

本数据库提供 JSON 格式。

> 注意： 当前支持美国地区，地区代码为 2840。数据库中的语言代码为 en。

本页面描述数据库结构，不定义可直接调用的 HTTP 方法和 API 路径。数据获取方式以本平台提供的数据库服务为准。

计费说明

费用取决于所请求数据库的规模和地区参数。扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

字段说明

顶层字段

字段	类型	说明
app_id	string	应用 ID，对应请求中的应用标识
location	integer	地区代码，对应请求中的地区参数；美国为 2840
language	string	语言代码，对应请求中的语言参数
check_url	string	结果来源页面的直接 URL，可用于核验返回数据的准确性
time_update	string	数据获取时间，采用 UTC 格式 yyyy-mm-dd hh-mm-ss +00:00
se_domain	string	请求中使用的数据来源域名
item	object	应用详细信息

item 字段

字段	类型	说明
categories	array	应用所属的分类或类型
languages	array	应用支持的语言
version	string	当前应用版本
minimum_os_version	string	安应用所需的最低操作系统版本
released_date	string	应用发布日期和时间，采用 UTC 格式
last_update_date	string	应用最近一次更新时间，采用 UTC 格式
update_notes	string	开发提供的最新更新说明
images	array	应用页面中的图片 URL 列表
advisories	array	年龄评级及基于年龄的提示
type	string	数据项类型，目前可能为 app_store_info_organic
rank_group	integer	在相同 type 数据项中的排名；不同类型数据项不会计此排名
rank_absolute	integer	在应用中的绝对排名
position	string	数据项在结果页中的位置，目前可能为 left
app_id	string	应用 ID
title	string	应用名称
subtitle	string	应用副标题
url	string	应用页 URL
icon	string	应用图标 URL
description	string	应用描述
reviews_count	integer	应用评论总数
rating	object	应用平均评分
price	object	应用价格信息
is_free	boolean	是否为应用
main_category	string	应用的主要分类或类型
similar_apps	array	与当前应用相似的应用列表
more_apps_by_developer	array	同一开发发布的应用
size	string	应用大小
developer	string	开发名称
developer_id	string	开发 ID
developer_url	string	开发页 URL

rating 评分字段

字段	类型	说明
rating_type	string	评分类型，目前为 Max5
value	float	当前平均评分
votes_count	integer	反馈数量；在此数据结构中可能为 null
rating_max	integer	评分最大值；Max5 类型的最大值为 5

price 价格字段

字段	类型	说明
current	float	当前价格，即结果中展示的当前价格
regular	float	常规价格，即结果中展示的标准价格
max_value	float	最高价格，即结果中展示的价格范围上限
currency	string	价格币种，使用 ISO 币种代码
is_price_range	boolean	是否以价格区间形式提供
displayed_price	string	结果中原始展示的价格文本

similar_apps 相似应用字段

数组中的每个以下字段：

字段	类型	说明
app_id	string	应用 ID
title	string	应用名称
url	string	应用页 URL

more_apps_by_developer 开发应用字段

数组中的每个以下字段：

字段	类型	说明
app_id	string	应用 ID
title	string	应用名称
url	string	应用页 URL

日期时间格式

time_update、released_date 和 last_update_date 使用日期时间字符串表示。常见格式如下：

2019-11-15 12:57:46 +00:00

部分返回结果也可能使用 ISO 8601 格式，例如：

2023-05-18T01:20:23.0000000Z

JSON 数据示例

{
  "app_id": "1273381879",
  "location": 2840,
  "language": "en",
  "check_url": "https://apps.apple.com/us/app/id1273381879",
  "time_update": "2023-05-18T01:20:23.0000000Z",
  "se_domain": "itunes.apple.com",
  "item": {
    "categories": [],
    "languages": [],
    "version": "1.3.1",
    "minimum_os_version": "12.1",
    "released_date": "2017-08-26T03:00:00+03:00",
    "last_update_date": "2022-03-25T06:35:09+02:00",
    "update_notes": "Bug fixes and performance improvements.",
    "images": [],
    "advisories": [],
    "type": "app_store_info_organic",
    "rank_group": 1,
    "rank_absolute": 1,
    "position": "left",
    "app_id": "1273381879",
    "title": "Del Oro High School",
    "subtitle": "Del Oro High School App",
    "url": "https://apps.apple.com/us/app/del-oro-high-school/id1273381879",
    "icon": "https://is2-ssl.mzstatic.com/image/thumb/Purple122/v4/88/1d/64/881d6489-31f9-029c-fe97-fd01247295c9/AppIcon-0-0-1x_U007emarketing-0-0-0-8-0-0-sRGB-0-0-0-GLES2_U002c0-512MB-85-220-0-0.png/512x512bb.jpg",
    "description": "The Del Oro High School Mobile App connects parents & students with Del Oro and everything happening on campus.",
    "reviews_count": 4,
    "rating": {
      "rating_type": "Max5",
      "value": 3,
      "votes_count": 4,
      "rating_max": 5
    },
    "price": {
      "current": 0,
      "regular": null,
      "max_value": null,
      "currency": "USD",
      "is_price_range": false,
      "displayed_price": null
    },
    "is_free": true,
    "main_category": "Education",
    "similar_apps": null,
    "more_apps_by_developer": null,
    "size": 18640896,
    "developer": "SCHOOL APPTITUDE, LLC",
    "developer_id": "835022288",
    "developer_url": "https://apps.apple.com/us/developer/school-apptitude-llc/id835022288"
  }
}

数据处理注意事项

• location 当前固定为美国地区代码 2840，不要将解释为地区。
• rating.value 的评分范围由 rating_type 和 rating_max 确定。 -应用通常通过 is_free: true 和 price.current: 0 表示。
• similar_apps 和 more_apps_by_developer 可能为 null，调用方应进行空值处理。
• images、categories、languages 和 advisories 可能为空数组。
• size 示例中以字节数表示，使用时应根据业务需要换算为 KB、MB 或 GB。
• check_url 可用于回溯和人工核验应用页面信息。

实用场景

• 构建应用竞品库：汇总应用名称、描述、评分、评论量和价格，支持竞品定位与市场对比。
• 分析应用商店排名：利用 rank_group 和 rank_absolute 追踪应用在分类及量结果中的排名表现。
• 监测应用版本更新：结合 version、last_update_date 和 update_notes，识别竞品发布节奏与功能变化。
• 评估用户口碑：对比 rating.value、rating_max 和 reviews_count，衡量应用的用户反馈质量与规模。
• 挖掘开发产品矩阵：使用 more_apps_by_developer 同一开发的应用，分析产品布局和交叉竞争。