按任务 ID 获取 Google 应用信息 HTML 结果

接口说明

GET https://api.seermartech.cn/v3/app_data/google/app_info/task_get/html/$id

根据任务 ID 获取 Google 应用信息 HTML 结果。任务提交成功后，可在 7 天通过任务 ID 查询结果；查询已提交任务的结果不额外收费，计费在提交任务时产生。

扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

请求参数

任务 ID 作为 URL 路径参数传递。

参数	类型	说明
`id`	string	任务唯一标识，UUID 格式。任务提交后，可在 7 天使用该 ID 查询任务结果。

请求示例

cURL

bash

id="04171455-0696-0192-0000-4c69cc29b945"

curl --location --request GET \
  "https://api.seermartech.cn/v3/app_data/google/app_info/task_get/html/${id}" \
  --header "Authorization: Bearer smt_live_YOUR_KEY" \
  --header "Content-Type: application/json"

TypeScript

typescript

import axios from "axios";

const taskId = "02201115-0001-0066-0000-c06c8f23fce5";

axios
  .get(
    `https://api.seermartech.cn/v3/app_data/google/app_info/task_get/html/${taskId}`,
    {
      headers: {
        Authorization: "Bearer smt_live_YOUR_KEY",
        "Content-Type": "application/json",
      },
    }
  )
  .then((response) => {
    console.log("结果数据：", response.data);
  })
  .catch((error) => {
    console.error("请求失败：", error.response?.data || error.message);
  });

Python

python

import requests

task_id = "04171455-0696-0192-0000-4c69cc29b945"

response = requests.get(
    f"https://api.seermartech.cn/v3/app_data/google/app_info/task_get/html/{task_id}",
    headers={
        "Authorization": "Bearer smt_live_YOUR_KEY",
        "Content-Type": "application/json",
    },
)

response.raise_for_status()
print(response.json())

获取已完成任务后再查询结果

也可以调用以下接口获取已完成任务列表，再根据返回的任务 ID 查询 HTML 结果：

http

GET /v3/app_data/google/app_info/tasks_ready

查询单个任务结果：

http

GET /v3/app_data/google/app_info/task_get/html/$id

响应结构

接口返回 JSON 数据，顶层 tasks 数组。

顶层字段

字段	类型	说明
`version`	string	当前 API 版本。
`status_code`	integer	通用响应状态码。完整状态码列表请参考 `/v3/appendix/errors`。建议客户端对异常及错误状态进行统一处理。
`status_message`	string	通用状态说明。完整说明请参考 `/v3/appendix/errors`。
`time`	string	请求执行耗时，单位为秒。
`cost`	float	平台原始 USD 成本兼容字段；人民币实扣以 `X-SeerMarTech-Charge-CNY` 为准。
`tasks_count`	integer	`tasks` 数组中的任务数量。
`tasks_error`	integer	`tasks` 数组中返回错误的任务数量。
`tasks`	array	任务结果数组。

`tasks` 数组中的字段

字段	类型	说明
`id`	string	任务唯一标识，UUID 格式。
`status_code`	integer	任务状态码，通常为 `10000` 至 `60000`。完整状态码列表请参考 `/v3/appendix/errors`。
`status_message`	string	任务状态说明。
`time`	string	任务执行耗时，单位为秒。
`cost`	float	平台原始 USD 成本兼容字段；人民币实扣以 `X-SeerMarTech-Charge-CNY` 为准。
`result_count`	integer	`result` 数组中的结果数量。
`path`	array	请求 URL 路径信息。
`data`	object	提交任务时使用的参数。
`result`	array	任务结果数组。

`data` 字段

data含提交任务时指定的参数，例如：

字段	类型	说明
`se_type`	string	搜索引擎数据类型，例如 `app_info`。
`api`	string	API 分类，例如 `app_data`。
`function`	string	功能名称，例如 `app_info`。
`se`	string	搜索引擎类型，例如 `google`。
`app_id`	string	Google 应用 ID。
`location_code`	integer	地区代码。
`language_code`	string	语言代码。
`device`	string	设备类型，例如 `desktop`。
`os`	string	操作系统，例如 `windows`。

`result` 数组中的字段

字段	类型	说明
`app_id`	string	提交任务时指定的应用 ID。
`type`	string	提交任务时指定的搜索引擎类型。
`se_domain`	string	提交任务时指定的搜索引擎域名。
`location_code`	integer	地区代码。
`language_code`	string	语言代码。
`datetime`	string	获取结果的日期和时间，使用 UTC 格式：`yyyy-mm-dd hh-mm-ss +00:00`。示例：`2019-11-15 12:57:46 +00:00`。
`items_count`	integer	`items` 数组中的结果数量。
`items`	array	HTML 页面及数据。

`items` 数组中的字段

字段	类型	说明
`page`	integer	返回 HTML 页面的序号。
`date`	string	HTML 页面抓取日期和时间，使用 UTC 格式：`yyyy-mm-dd hh-mm-ss +00:00`。示例：`2019-11-15 12:57:46 +00:00`。
`html`	string	HTML 页面。

响应示例

json

{
  "version": "0.1.20220422",
  "status_code": 20000,
  "status_message": "Ok.",
  "time": "0.0874 sec.",
  "cost": 0,
  "tasks_count": 1,
  "tasks_error": 0,
  "tasks": [
    {
      "id": "04171455-0696-0192-0000-4c69cc29b945",
      "status_code": 20000,
      "status_message": "Ok.",
      "time": "0.0451 sec.",
      "cost": 0,
      "result_count": 1,
      "path": [
        "v3",
        "app_data",
        "google",
        "app_info",
        "task_get",
        "html"
      ],
      "data": {
        "se_type": "app_info",
        "api": "app_data",
        "function": "app_info",
        "se": "google",
        "app_id": "org.telegram.messenger",
        "location_code": 2840,
        "language_code": "en",
        "device": "desktop",
        "os": "windows"
      },
      "result": [
        {
          "app_id": "org.telegram.messenger",
          "type": "app_info",
          "se_domain": "play.google.com",
          "location_code": 2840,
          "language_code": "en",
          "datetime": "2019-11-15 12:57:46 +00:00",
          "items_count": 1,
          "items": [
            {
              "page": 1,
              "date": "2019-11-15 12:57:46 +00:00",
              "html": "<html>...</html>"
            }
          ]
        }
      ]
    }
  ]
}

状态码与错误处理

顶层 status_code 用于表示本次 API 请求的总体状态。
tasks[].status_code 用于表示任务的执行状态。
当任务状态码表示错误，或 result 为空时，客户端应记录 status_code 和 status_message，并执行重试、告警或人工排查。
完整响应状态码和通用状态说明请参考 /v3/appendix/errors。

实用场景

抓取 Google Play 应用页 HTML，建立应用信息原始快，便于后续解析和历史对比。
监控竞品应用页面变化，及时发现应用名称、描述、版本或页面结构更新。
归档指定地区和语言下的应用页面，支持多市场 SEO 研究与本地化分析。
解析 HTML 页面中的应用数据，批量构建应用名称、描述、开发和页面标签等分析数据集。
对比不同时间获取的应用 HTML，评估竞品 ASO 优化和页面调整效果。

按任务 ID 获取 Google 应用信息 HTML 结果 ​

接口说明 ​

请求参数 ​

请求示例 ​

cURL ​

TypeScript ​

Python ​

获取已完成任务后再查询结果 ​

响应结构 ​

顶层字段 ​

tasks 数组中的字段 ​

data 字段 ​

result 数组中的字段 ​

items 数组中的字段 ​

响应示例 ​

状态码与错误处理 ​

实用场景 ​