Bing Ads 数据状态

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

/v3/keywords_data/bing/status

用于查询 Bing 是否已更新上一个月的数据，以及当前可用的搜索量数据月份。通常，Bing 会在每月初更新数据。例如，如果 Bing 在 10 月更新数据，则可查询到 9 月的数据；如果 10 月未完成更新，则最新可用数据可能仍为 8 月。

计费说明

调用本接口不收取费用，参考价为 ¥0 / 次。扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

请求方式

请求地址

GET https://api.seermartech.cn/v3/keywords_data/bing/status

请求头

Authorization: Bearer smt_live_YOUR_KEY
Content-Type: application/json

本接口为 GET 请求，无需请求体。

响应说明

接口返回 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	请求路径
data	object	本次 API 调用的请求参数及上下文信息
result	array	查询结果数组

result 字段

字段	类型	说明
actual_data	boolean	是否已更新上一个月的数据
date_update	string	Bing Ads 数据的最近更新时间，格式为 YYYY-MM-DD
last_year_in_monthly_searches	integer	当前可用月度搜索量数据的最近年份
last_month_in_monthly_searches	integer	当前可用月度搜索量数据的最近月份

actual_data 返回值说明

• true：Bing 已更新上一个月的数据，当前可提供最新的上月数据。
• false：Bing 尚未更新上一个月的数据，当前无法提供上月数据。

状态码

建议在业务系统中对请求级和任务级状态码进行统一处理。

• 20000：请求成功
• 状态码：表示请求或任务执行异常

完整状态码请参考本平台的错误码文档。

请求示例

cURL

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

Python

import requests

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

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

response = requests.get(url, headers=headers, timeout=30)
result = response.json()

if result.get("status_code") == 20000:
    print(result)
else:
    print(
        "请求失败，状态码：{}，说明：{}".format(
            result.get("status_code"),
            result.get("status_message"),
        )
    )

TypeScript

const response = await fetch(
  "https://api.seermartech.cn/v3/keywords_data/bing/status",
  {
    method: "GET",
    headers: {
      Authorization: "Bearer smt_live_YOUR_KEY",
      "Content-Type": "application/json",
    },
  }
);

const result = await response.json();

if (result.status_code === 20000) {
  console.log(result);
} else {
  console.error(
    `请求失败，状态码：${result.status_code}，说明：${result.status_message}`
  );
}

响应示例

{
  "version": "0.1.20260731",
  "status_code": 20000,
  "status_message": "Ok.",
  "time": "0.0615 sec.",
  "cost": 0,
  "tasks_count": 1,
  "tasks_error": 0,
  "tasks": [
    {
      "id": "01234567-89ab-cdef-0123-456789abcdef",
      "status_code": 20000,
      "status_message": "Ok.",
      "time": "0.0521 sec.",
      "cost": 0,
      "result_count": 1,
      "path": [
        "v3",
        "keywords_data",
        "bing",
        "status"
      ],
      "data": {
        "api": "keywords_data",
        "function": "status",
        "se": "bing"
      },
      "result": [
        {
          "actual_data": true,
          "date_update": "2026-07-03",
          "last_year_in_monthly_searches": 2026,
          "last_month_in_monthly_searches": 6
        }
      ]
    }
  ]
}

字段解读示例

在以下返回结果中：

{
  "actual_data": true,
  "date_update": "2026-07-03",
  "last_year_in_monthly_searches": 2026,
  "last_month_in_monthly_searches": 6
}

表示：

• Bing 最近一次更新数据的日期为 2026-07-03。
• 当前已提供截至 2026 年 6 月 的月度搜索量数据。
• actual_data 为 true，说明上一个月的数据已完成更新，可以使用最新数据。

实用场景

• 检查月度数据是否更新：在生成报告前确认 Bing 是否已发布上月数据，使用过期搜索量影响报告准确性。
• 控制数据采集任务：根据 actual_data 自动决定是否启动新一轮数据同步，减少无效请求和重复处理。
• 标记 SEO 报告数据周期：使用 date_update 和最新可用年月标注数据版本，帮助团队识别报告所依据的数据时间范围。
• 监控搜索量数据延迟：持续记录 last_year_in_monthly_searches 和 last_month_in_monthly_searches，及时发现 Bing 月度数据更新滞后。
• 触发月度运营流程：将接口状态接定时任务，在检测到上月数据可用后自动生成排名、搜索量和投放分析报表。