dataforseo_labs/status：数据更新状态

GET /v3/dataforseo_labs/status

本接口使用 GET 方法，请求路径为：

/v3/dataforseo_labs/status

调用本接口可查询本平台 Labs 数据的最近更新时间。响应会分别返回 Google、Bing 和 Amazon 端点的数据更新时间。

计费说明

本接口调用，不产生任务费用。

请求

请求地址

GET https://api.seermartech.cn/v3/dataforseo_labs/status

请求头

Authorization: Bearer smt_live_YOUR_KEY
Content-Type: application/json

本接口无需请求体。

响应字段

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

字段名	类型	说明
version	string	当前 API 版本
status_code	integer	请求的通用状态码。完整状态码列表请参考错误码文档
status_message	string	请求的通用提示信息
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 范围
status_message	string	任务状态说明
time	string	任务执行耗时，单位为秒
cost	float	平台原始 USD 成本兼容字段；人民币实扣以 X-SeerMarTech-Charge-CNY 为准。
result_count	integer	result 数组中的数量
path	array	请求 URL 路径
data	object	本次 API 调用对应的请求数据
result	array	任务结果数组

result 数组字段

字段名	类型	说明
google	object	Google 端点的数据更新信息
bing	object	Bing 端点的数据更新信息
amazon	object	Amazon 端点的数据更新信息

数据更新信息字段

字段名	类型	说明
date_update	string	对应端点最近一次数据更新时间，格式为 YYYY-MM-DD

示例：

2022-05-16

curl 示例

curl --location --request GET "https://api.seermartech.cn/v3/dataforseo_labs/status" \
  --header "Authorization: Bearer smt_live_YOUR_KEY" \
  --header "Content-Type: application/json"

Python 示例

import requests

url = "https://api.seermartech.cn/v3/dataforseo_labs/status"

headers = {
    "Authorization": "Bearer smt_live_YOUR_KEY",
    "Content-Type": "application/json",
}

response = requests.get(url, headers=headers)

if response.ok:
    result = response.json()

    if result.get("status_code") == 20000:
        print(result)
        # 在此处处理返回结果
    else:
        print(
            "请求失败。状态码: %s，消息: %s"
            % (result.get("status_code"), result.get("status_message"))
        )
else:
    print("HTTP 请求失败:", response.status_code, response.text)

TypeScript 示例

import axios from "axios";

axios
  .get("https://api.seermartech.cn/v3/dataforseo_labs/status", {
    headers: {
      Authorization: "Bearer smt_live_YOUR_KEY",
      "Content-Type": "application/json",
    },
  })
  .then((response) => {
    const result = response.data;

    if (result.status_code === 20000) {
      console.log(result);
      // 在此处处理返回结果
    } else {
      console.error(
        `请求失败。状态码: ${result.status_code}，消息: ${result.status_message}`
      );
    }
  })
  .catch((error) => {
    console.error("请求异常:", error.response?.data || error.message);
  });

响应示例

{
  "version": "0.1.20220428",
  "status_code": 20000,
  "status_message": "Ok.",
  "time": "0.0938 sec.",
  "cost": 0,
  "tasks_count": 1,
  "tasks_error": 0,
  "tasks": [
    {
      "id": "00000000-0000-0000-0000-000000000000",
      "status_code": 20000,
      "status_message": "Ok.",
      "time": "0.0938 sec.",
      "cost": 0,
      "result_count": 1,
      "path": [
        "v3",
        "dataforseo_labs",
        "status"
      ],
      "data": {
        "api": "dataforseo_labs",
        "function": "status"
      },
      "result": [
        {
          "google": {
            "date_update": "2022-05-16"
          },
          "bing": {
            "date_update": "2022-05-16"
          },
          "amazon": {
            "date_update": "2022-05-23"
          }
        }
      ]
    }
  ]
}

状态码处理

建议在业务系统中对以下进行处理：

• 检查顶层 status_code 是否为 20000，确认请求是否成功。
• 检查 tasks_error 是否大于 0，确认是否存在任务级错误。
• 结合 tasks[].status_code 和 tasks[].status_message 定位任务问题。
• 不要依赖 HTTP 状态码，应同时校验 API 返回的业务状态码和提示信息。

实用场景

• 监控数据更新时间：定期查询 Google、Bing 和 Amazon 数据的最近更新时间，使用过期数据生成 SEO 报告。
• 校验分析数据时效性：在执行、域名或竞品分析前确认数据是否已更新，提升分析结果的可靠性。
• 触发数据同步任务：根据 date_update 的变化自动启动下游数据同步或报表刷新流程。
• 展示数据新鲜度：在 SEO 平台或客户报表中展示各搜索渠道的数据更新时间，增强数据透明度。
• 排查结果异常：当分析结果与预期不一致时，通过更新时间判断问题是否可能由数据延迟造成。