主题
App Store 搜索结果数据库(高级版)
概述
App Store 搜索结果数据库(高级版)收录了数百万条 App Store 搜索结果页及应用数据。
该数据库提供 JSON 格式。
如需快速了解数据结构,可下载并查看示例数据(美国地区、英文): https://api.seermartech.cn/examples/databases/apple/serp_advanced/US_en.json.gz
数据库说明
该数据库中的每条记录,表示某个在指定地区与语言下对应的一组 App Store 搜索结果数据,主要:
- 基础信息
- 地区与语言标识
- 搜索量信息
- 搜索结果页信息
- 搜索结果中的应用列表
计费说明
该数据库费用通常与数据规模以及地区参数。
由于不同导出条件下价格可能不同,本文不固定列出金额。扣费以响应头 X-SeerMarTech-Charge-CNY 为准。
字段说明
顶层字段
| 字段名 | 类型 | 说明 |
|---|---|---|
keyword | string | ,采用 UTF-8 编码 |
location | integer | 地区代码,对应地区的唯一标识。例如:2840 表示 United States |
language | string | 语言代码,对应指定地区可用语言的唯一标识。例如:en 表示 English |
keyword_info | object | 返回的数据 |
serp_info | object | 返回对应的搜索结果页信息 |
keyword_info 对象
| 字段名 | 类型 | 说明 |
|---|---|---|
search_volume | integer | 平均月搜索量,表示该在 App Store 上的大致搜索次数 |
time_update | string | 数据最后更新时间,采用 ISO 8601 格式:YYYY-MM-DDThh:mm:ss.sssssssZ。示例:2020-09-12T00:07:43.0733218Z |
serp_info 对象
| 字段名 | 类型 | 说明 |
|---|---|---|
check_url | string | 指向搜索结果页的直接链接,可用于核对结果准确性 |
items_count | integer | serp 数组中返回的结果数量 |
se_results_count | integer | 该搜索结果页中的总结果数 |
time_update | string | 搜索结果数据最后更新时间,采用 ISO 8601 格式:YYYY-MM-DDThh:mm:ss.sssssssZ。示例:2020-09-12T00:07:43.0733218Z |
serp | array | 当前对应的搜索结果列表 |
serp 数组说明
该数据库中的搜索结果类型为 app_store_search_organic。
app_store_search_organic素字段
| 字段名 | 类型 | 说明 |
|---|---|---|
type | string | 素类型,固定为 app_store_search_organic |
rank_group | integer | 在相同 type素组的位置。不同 type素的位置不会计该值 |
rank_absolute | integer | 在已列出应用中的绝对排名 |
position | string | 素在搜索结果页中的位置。当前可取值:left |
app_id | string | 返回应用的 ID |
title | string | 返回应用的标题 |
url | string | 指向 App Store 应用页的链接 |
icon | string | 应用图标链接 |
reviews_count | integer | 应用的评论总数 |
rating | object | 应用平均评分信息 |
is_free | boolean | 是否为应用 |
price | object | 应用价格信息 |
rating 对象
| 字段名 | 类型 | 说明 |
|---|---|---|
rating_type | string | 评分类型。当前可取值:Max5 |
value | float | 评分值 |
votes_count | integer | 反馈数量;在此类结果中该值可能为 null |
rating_max | integer | 当前 rating_type 对应的最大分值;Max5 的最大值为 5 |
price 对象
| 字段名 | 类型 | 说明 |
|---|---|---|
current | float | 当前价格,即结果中展示的当前售价 |
regular | float | 常规价格,即结果中展示的原价或日常价格 |
max_value | float | 最高价格,表示结果中出现的最高价格值 |
currency | string | 价格币种,使用 ISO 货币代码 |
is_price_range | boolean | 是否以价格区间形式展示 |
displayed_price | string | 结果中原样返回的价格字符串 |
数据结构示例
JSON 数据库中的单条记录结构如下:
json
{
"keyword": "100 push-ups a day challenge",
"location": 2840,
"language": "en",
"keyword_info": {
"search_volume": 10,
"time_update": "2022-06-07T18:14:49.5631353Z"
},
"serp_info": {
"check_url": null,
"items_count": 7,
"se_results_count": 8,
"time_update": "2022-06-02T02:16:07.4999155Z",
"serp": []
}
}获取与使用说明
该页面描述的是数据库数据结构,并非单一实时查询接口。使用时通常是按数据库文件进行下载、解析与导。
如果你需要:
- 拉取指定地区 / 语言的 App Store 搜索结果数据库
- 批量处理对应的应用排名
- 分析搜索量、评分、价格与评论量之间的
建议结合本平台对应的数据库交付方式或数据导出能力使用。
认证说明
如需调用本平台 API,请使用如下认证方式:
http
Authorization: Bearer smt_live_YOUR_KEY示例代码
以下示例演示如何下载数据库样例文件。
cURL
bash
# 下载 App Store 搜索结果数据库样例
curl -L "https://api.seermartech.cn/examples/databases/apple/serp_advanced/US_en.json.gz" -o US_en.json.gzPython
python
# 下载 App Store 搜索结果数据库样例
import requests
url = "https://api.seermartech.cn/examples/databases/apple/serp_advanced/US_en.json.gz"
response = requests.get(url, timeout=60)
response.raise_for_status
with open("US_en.json.gz", "wb") as f:
f.write(response.content)
print("下载完成:US_en.json.gz")TypeScript
typescript
// 下载 App Store 搜索结果数据库样例
const url = "https://api.seermartech.cn/examples/databases/apple/serp_advanced/US_en.json.gz";
async function downloadSample {
const response = await fetch(url);
if (!response.ok) {
throw new Error(`下载失败: ${response.status} ${response.statusText}`);
}
const arrayBuffer = await response.arrayBuffer;
const fs = await import("node:fs");
fs.writeFileSync("US_en.json.gz", Buffer.from(arrayBuffer));
console.log("下载完成:US_en.json.gz");
}
downloadSample.catch(console.error);使用建议
在落库与分析时,建议重点以下字段:
keyword:用于维度分析keyword_info.search_volume:用于评估搜索需求规模serp_info.se_results_count:用于观察结果丰富度serp[].rank_absolute:用于分析应用排序serp[].rating.value、serp[].reviews_count:用于评估口碑表现serp[].price.current、serp[].is_free:用于分析/付费竞争格局
实用场景
- 监控下的应用排名:按追踪
rank_absolute变化,评估自家应用或竞品在 App Store 搜索中的自然表现。 - 筛选高潜力:结合
search_volume与搜索结果数量,识别搜索需求存在但竞争相对可控的。 - 分析竞品定价策略:基于
is_free、price.current、displayed_price对比同类应用的/付费分布与价格带。 - 评估应用口碑对排名的影响:联合
rating.value、reviews_count与排名数据,分析评分和评论规模对搜索表现的。 - 构建 ASO 数据仓库:将、地区、语言、排名、价格、评分等字段统一库,为 ASO 监控、竞品研究和市场分析提供底层数据支持。