Skip to content

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 提供数据。

数据范围与结果一致性

返回结果由请求中的 languagelocation 参数决定。本平台会尽可能精确地模拟指定地区,因此返回结果应与任务创建时该地区和语言下的搜索结果保持一致。

部分响应会返回 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 目前支持标准任务模式。该模式需要分别发送 POSTGET 请求:

  1. 使用 POST 提交一个或多个任务;
  2. 等任务处理完成;
  3. 使用任务 ID 通过 GET 请求获取结果。

您也可以在创建任务时指定以下回调参数:

  • pingback_url:任务完成后,本平台向指定地址发送通知;
  • postback_url:任务完成后,本平台将结果发送到指定地址。

如果使用标准任务模式且未指定 pingback_urlpostback_url,可以通过任务就绪接口获取所有已完成但尚未提取的任务 ID,然后使用任务结果接口获取数据。

请求限制

平台限流以认证说明中的 30/60/120 次/分钟规则为准POST 和 GET API 请求,POST 与 GET 请求合计计算;

  • 每次 POST 请求最多 100 个任务;
  • 如需提高请求限制,请联系技术支持。

优级与计费

标准任务模式支持两种执行优级:

  1. 普通优级:执行速度和计费标准较低;
  2. 高优级:任务处理速度更快,计费标准不同。

不同接口、任务类型和优级的费用可能不同。扣费以响应头 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 应用,分析竞品可见度和排名变化。
  • 分析应用分类竞争格局:获取指定分类下的热门应用榜单,评估市场集中度、头部应用表现和潜在机会。
  • 构建竞品应用档案:通过应用接口汇总量、评分、评价数量、描述和素材信息,支持竞品研究与产品定位。
  • 挖掘用户评价反馈:采集应用评价、评分和发布时间,识别用户痛点、功能需求及版本迭代方向。
  • 筛选目标应用单:按应用标题、描述和分类搜索上架应用,为市场调研、广告投放和应用生态分析建立数据集。

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