主题
Google 应用数据 API 概览
POST /v3/app_data/google/app_searches/task_post
本接口用于获取 Google Play 平台上架移动应用的数据。本文涵盖以下 API 路径:/v3/app_data/google/app_searches/task_get/advanced、/v3/app_data/google/app_list/task_get/advanced、/v3/app_data/google/app_info/task_get/advanced、/v3/app_data/google/app_reviews/task_get/advanced 和 /v3/app_data/google/app_listings/search/live/。
通过 Google 应用数据 API,您可以:
- 根据获取 Google Play 应用排名列表;
- 获取指定应用分类下的完整应用列表;
- 查询指定应用的详细信息;
- 获取 Google Play 应用的用户评价;
- 按标题、描述和分类搜索 Google Play 上架应用。
目前本接口基于 Google Play 提供数据。
数据范围与结果一致性
返回结果由请求中的 language 和 location 参数决定。本平台会尽可能精确地模拟指定地区,因此返回结果应与任务创建时该地区和语言下的搜索结果保持一致。
部分响应会返回 check_url。您可以在无痕浏览模式下访问该地址,核验返回结果是否与目标地区和语言。
系统不会使用用户偏好、搜索历史及个性化因素,因此这些因素不会反映在返回结果中。
Google 应用数据 API 功能
应用搜索
接口路径: /v3/app_data/google/app_searches/task_get/advanced
请求方式: 标准任务模式,使用 POST 创建任务,使用 GET 获取结果。
根据请求中的 keyword 查询 Google Play 应用排名,并返回以下应用信息:
- 应用 ID;
- 应用图标;
- 评价数量;
- 评分;
- 价格;
- 应用。
返回结果由请求中的、地区和语言参数决定。
如需获取 HTML 格式结果,请使用:
/v3/app_data/google/app_searches/task_get/html/
应用列表
接口路径: /v3/app_data/google/app_list/task_get/advanced
请求方式: 标准任务模式,使用 POST 创建任务,使用 GET 获取结果。
获取 Google Play 应用榜单及应用数据。返回结果由请求中的 app_collection、地区和语言参数决定。
如需获取 HTML 格式结果,请使用:
/v3/app_data/google/app_list/task_get/html/
应用
接口路径: /v3/app_data/google/app_info/task_get/advanced
请求方式: 标准任务模式,使用 POST 创建任务,使用 GET 获取结果。
根据请求中的 app_id 获取指定移动应用的详细信息:
- 应用 ID;
- 应用图标;
- 应用描述;
- 评价数量;
- 评分;
- 安数量;
- 应用图片;
- 应用数据。
如需获取 HTML 格式结果,请使用:
/v3/app_data/google/app_info/task_get/html/
应用评价
接口路径: /v3/app_data/google/app_reviews/task_get/advanced
请求方式: 标准任务模式,使用 POST 创建任务,使用 GET 获取结果。
获取 Google Play 应用的用户评价数据:
- 评价星级;
- 评价;
- 评价用户资料;
- 评价发布时间;
- 评价信息。
返回结果由请求中的 app_id、地区和语言参数决定。
如需获取 HTML 格式结果,请使用:
/v3/app_data/google/app_reviews/task_get/html/
应用搜索列表
接口路径: /v3/app_data/google/app_listings/search/live/
请求方式: POST
根据应用标题、描述和分类等参数,搜索 Google Play 上架应用,并返回应用的信息:
- 应用 ID;
- 应用图标;
- 评价数量;
- 评分;
- 价格;
- 应用数据。
请求格式
所有 POST 请求体均使用 JSON 数组格式,即使只提交一个任务,也需要将任务对象放数组中:
json
[
{
"keyword": "photo editor",
"location_code": 2840,
"language_code": "en"
}
]参数及字段定义请以对应接口文档为准。
认证方式
请求时在 HTTP Header 中携带 API 密钥:
http
Authorization: Bearer smt_live_YOUR_KEY示例:
bash
curl --request POST \
--url https://api.seermartech.cn/v3/app_data/google/app_searches/task_post \
--header 'Authorization: Bearer smt_live_YOUR_KEY' \
--header 'Content-Type: application/json' \
--data '[
{
"keyword": "photo editor",
"location_code": 2840,
"language_code": "en"
}
]'> 上例用于说明认证方式和 JSON 请求格式。任务创建路径及参数请以对应接口文档为准。
数据获取方式
Google 应用数据 API 目前支持标准任务模式。该模式需要分别发送 POST 和 GET 请求:
- 使用
POST提交一个或多个任务; - 等任务处理完成;
- 使用任务 ID 通过
GET请求获取结果。
您也可以在创建任务时指定以下回调参数:
pingback_url:任务完成后,本平台向指定地址发送通知;postback_url:任务完成后,本平台将结果发送到指定地址。
如果使用标准任务模式且未指定 pingback_url 或 postback_url,可以通过任务就绪接口获取所有已完成但尚未提取的任务 ID,然后使用任务结果接口获取数据。
请求限制
平台限流以认证说明中的 30/60/120 次/分钟规则为准POST 和 GET API 请求,POST 与 GET 请求合计计算;
- 每次 POST 请求最多 100 个任务;
- 如需提高请求限制,请联系技术支持。
优级与计费
标准任务模式支持两种执行优级:
- 普通优级:执行速度和计费标准较低;
- 高优级:任务处理速度更快,计费标准不同。
不同接口、任务类型和优级的费用可能不同。扣费以响应头 X-SeerMarTech-Charge-CNY 为准。
路径
| 功能 | 高级 JSON 接口 | HTML 接口 |
|---|---|---|
| 应用搜索 | /v3/app_data/google/app_searches/task_get/advanced | /v3/app_data/google/app_searches/task_get/html/ |
| 应用列表 | /v3/app_data/google/app_list/task_get/advanced | /v3/app_data/google/app_list/task_get/html/ |
| 应用 | /v3/app_data/google/app_info/task_get/advanced | /v3/app_data/google/app_info/task_get/html/ |
| 应用评价 | /v3/app_data/google/app_reviews/task_get/advanced | /v3/app_data/google/app_reviews/task_get/html/ |
| 应用搜索列表 | /v3/app_data/google/app_listings/search/live/ | — |
实用场景
- 监控下的应用排名:定期查询目标对应的 Google Play 应用,分析竞品可见度和排名变化。
- 分析应用分类竞争格局:获取指定分类下的热门应用榜单,评估市场集中度、头部应用表现和潜在机会。
- 构建竞品应用档案:通过应用接口汇总量、评分、评价数量、描述和素材信息,支持竞品研究与产品定位。
- 挖掘用户评价反馈:采集应用评价、评分和发布时间,识别用户痛点、功能需求及版本迭代方向。
- 筛选目标应用单:按应用标题、描述和分类搜索上架应用,为市场调研、广告投放和应用生态分析建立数据集。