SeerMarTech API 文档

主题

Google Play 应用列表数据库 ​

概述 ​

Google Play 应用列表数据库收录了百万级的 Google Play 应用及信息，可用于批量获取应用数据。数据库中的应用字段通常：

  • 应用 ID
  • 图标
  • 评论数
  • 评分
  • 图片
  • 安量
  • 价格
  • 开发信息
  • 分类与标签等

本数据库提供 JSON 格式。

注意：当前提供 美国 地区数据，对应 location_code=2840。

如需查询可用地区与语言，可调用以下接口：

  • 地区列表：/v3/app_data/google/locations
  • 语言列表：/v3/app_data/google/languages

说明：

  • 2840 对应 United States
  • en 对应 English

计费说明 ​

该数据库的费用取决于的数据规模和地区参数。

由于平台按数据库体量定价，本文不固定展示单次价格；扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

字段说明 ​

下表为数据库中主要字段定义。

字段名类型说明
app_idstring应用 ID
location / location_codestring / integer地区唯一标识。当前支持 2840（美国）
languagestring语言代码，例如 en 表示英文
check_urlstring直达 Google Play 页面 URL，可用于人工核验结果准确性
time_updatestring应用数据最近更新时间，ISO 8601 格式，例如 2020-09-12T00:07:43.0733218Z
se_domainstring搜索引擎域名，例如 play.google.com
itemobject应用对象

item 对象字段 ​

字段名类型说明
developer_emailstring开发邮箱
developer_addressstring开发地址
developer_websitestring开发官网
installsstring页面展示的量区间，如 1,000+
installs_countinteger安量精确值
versionstring当前版本号
minimum_os_versionstring可所需最低系统版本
released_datestring应用发布时间，UTC 格式
last_update_datestring最近更新时间，UTC 格式
update_notesstring最近一次更新说明
imagesarray应用页面图片 URL 列表
videosstring / null应用视频 URL
genresarray应用所属题材/类别
tagsarray应用标签
typestring结果类型，固定可能值：google_play_info_organic
rank_groupinteger同类型中的分组排名
rank_absoluteinteger在完整列表中的绝对排名
positionstring素位置，可能值：left
app_idstring应用 ID
titlestring应用标题
urlstringGoogle Play 应用页 URL
iconstring应用图标 URL
descriptionstring应用描述
reviews_countinteger / null评论总数
ratingobject评分对象
priceobject价格对象
is_freeboolean是否
main_categorystring主分类
similar_appsarray相似应用列表
more_apps_by_developerarray同开发应用列表
sizestring / null应用大小
developerstring开发名称
developer_idstring开发 ID
developer_urlstring开发在 Google Play 的主页 URL

rating 对象字段 ​

字段名类型说明
rating_typestring评分类型，可能值：Max5
valuefloat / null平均评分值
votes_countinteger / null评分反馈数；某些场景下可能为 null
rating_maxinteger当前评分体系的最大值；Max5 时为 5

price 对象字段 ​

字段名类型说明
currentfloat当前价格
regularfloat / null原价
max_valuefloat / null价格区间中的最高值
currencystring币种 ISO 代码
is_price_rangeboolean是否为区间价格
displayed_pricestring / null页面展示的原始价格字符串

similar_apps / more_apps_by_developer 子项字段 ​

字段名类型说明
app_idstring应用 ID
titlestring应用标题
urlstring应用页 URL

数据结构示例 ​

以下为 JSON 数据示例，结构与数据库输出一致：

json
{
 "app_id": "com.gg.smashtheplanet",
 "location": 2840,
 "language": "en",
 "check_url": "https://play.google.com/store/apps/details?id=com.gg.smashtheplanet&hl=en&gl=us",
 "time_update": "2023-06-12T19:03:08.0000000Z",
 "se_domain": "play.google.com",
 "item": {
 "developer_email": "gaminggaloresofficial@gmail.com",
 "developer_address": "48,A.I.T, Lahore",
 "developer_website": "https://gaminggaloresstudioz.blogspot.com",
 "installs": "1,000+",
 "installs_count": 2471,
 "version": "1.1",
 "minimum_os_version": "5.1",
 "released_date": "2023-05-19T03:00:00",
 "last_update_date": "2023-05-30T03:00:00",
 "update_notes": "New Features Added.nBugs Fixed.nRealistic Demolition.",
 "images": [],
 "videos": null,
 "genres": [],
 "tags": [],
 "type": "google_play_info_organic",
 "rank_group": 1,
 "rank_absolute": 1,
 "position": "left",
 "app_id": "com.gg.smashtheplanet",
 "title": "Smash planets: Solar Smasher",
 "url": "https://play.google.com/store/apps/details?id=com.gg.smashtheplanet&hl=en&gl=us",
 "icon": "https://play-lh.googleusercontent.com/7C4454TIN3hI5ww9mIQ1BZBnRhyHeCFT_J4AleqgPCGOWeey1yCgdWamCeN8Jr0BidJI",
 "description": "Welcome to Cosmic Destruction, the ultimate planet-smashing game...",
 "reviews_count": null,
 "rating": {
 "rating_type": "Max5",
 "value": null,
 "votes_count": null,
 "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": "Simulation",
 "similar_apps": [],
 "more_apps_by_developer": [],
 "size": null,
 "developer": "Gaming Galores",
 "developer_id": "6717484826927450279",
 "developer_url": "https://play.google.com/store/apps/dev?id=6717484826927450279"
 }
}

地区与语言接口示例 ​

如果需要获取可用地区和语言，可调用容接口。

获取地区列表 ​

bash
curl -X GET "https://api.seermartech.cn/v3/app_data/google/locations" \
 -H "Authorization: Bearer smt_live_YOUR_KEY"

获取语言列表 ​

bash
curl -X GET "https://api.seermartech.cn/v3/app_data/google/languages" \
 -H "Authorization: Bearer smt_live_YOUR_KEY"

Python 示例 ​

python
import requests

headers = {
 "Authorization": "Bearer smt_live_YOUR_KEY"
}

# 获取地区列表
locations = requests.get(
 "https://api.seermartech.cn/v3/app_data/google/locations",
 headers=headers
)

# 获取语言列表
languages = requests.get(
 "https://api.seermartech.cn/v3/app_data/google/languages",
 headers=headers
)

print(locations.json)
print(languages.json)

TypeScript 示例 ​

ts
const headers = {
 Authorization: "Bearer smt_live_YOUR_KEY"
};

// 获取地区列表
const locationsResponse = await fetch(
 "https://api.seermartech.cn/v3/app_data/google/locations",
 { headers }
);

// 获取语言列表
const languagesResponse = await fetch(
 "https://api.seermartech.cn/v3/app_data/google/languages",
 { headers }
);

console.log(await locationsResponse.json);
console.log(await languagesResponse.json);

使用说明 ​

该页面描述的是一份离线数据库的数据结构，而非单一查询接口。使用时，通常需要确定：

  1. 目标地区 location_code
  2. 目标语言 language_code
  3. 所需字段范围与数据规模

当前可用范围限：

  • 地区：2840
  • 语言：通常为该地区支持的语言集合，示例为 en

建议在正式处理数据前，通过地区/语言接口核验参数可用性，并结合样例数据检查字段容性，注意以下字段可能返回 null：

  • reviews_count
  • rating.value
  • rating.votes_count
  • price.regular
  • price.max_value
  • price.displayed_price
  • size
  • videos

注意事项 ​

  • 本数据库提供 JSON 格式。
  • 当前支持美国地区数据。
  • 部分应用字段可能为空或为 null，这通常与应用本身信息缺失或商店页面未展示。
  • installs 为页面展示值，适合展示；installs_count 为更精确的数值，适合建模与排序。
  • similar_apps 与 more_apps_by_developer 适合做推荐、竞品扩展和开发矩阵分析。
  • check_url 可用于人工抽样校验数据准确性。

实用场景 ​

  • 监控竞品应用表现：批量追踪竞品的量、评分、评论数和版本更新节奏，帮助产品与增长团队评估市场竞争态势。
  • 挖掘细分类目机会：结合 main_category、genres、tags 和相似应用信息，识别高增长或低竞争的应用赛道。
  • 构建 ASO 分析样本库：基于标题、描述、图标、截图、评分等字段建立样本集，用于分析商店素材与转化表现的。
  • 分析开发矩阵布局：通过 developer、developer_id、more_apps_by_developer 识别同开发产品组合，评估品牌与发行策略。
  • 筛选商业化模式：利用 is_free、price.current、currency 等字段区分与付费应用，为定价研究和商业模式分析提供依据。

统一入口：官网 · LLM API · 控制台

© 2026 SeerMarTech · GEO · SEO 营销数据 API