Bing「搜索量历史」支持的地点与语言列表

GET /v3/keywords_data/bing/search_volume_history/locations_and_languages

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

/v3/keywords_data/bing/search_volume_history/locations_and_languages

调用后可获取 Bing「搜索量历史」接口支持的语言及可用地点列表。该接口本身不收费。扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

请求

请求地址

http

GET https://api.seermartech.cn/v3/keywords_data/bing/search_volume_history/locations_and_languages

请求头

http

Authorization: Bearer smt_live_YOUR_KEY
Content-Type: application/json

本接口无需请求体和查询参数。

响应字段

顶层字段

字段	类型	说明
`version`	string	当前 API 版本
`status_code`	integer	通用状态码，`20000` 表示成功
`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	请求路径对应的接口参数
`result`	array	返回结果数组

`data` 字段

字段	类型	说明
`api`	string	API 产品标识，值为 `keywords_data`
`function`	string	接口功能名称，值为 `locations_and_languages`
`se`	string	搜索引擎标识，值为 `bing`
`se_type`	string	数据类型，值为 `search_volume_history`

`result` 及嵌套字段

字段	类型	说明
`language_name`	string	语言名称
`language_code`	string	语言代码，遵循 ISO 639-1 或对应地区语言代码
`available_locations`	array	当前语言支持的地点列表
`available_locations[].location_code`	integer	地点代码
`available_locations[].location_name`	string	地点完整名称
`available_locations[].country_iso_code`	string	地点所属国家或地区的 ISO 代码
`available_locations[].location_type`	string	地点类型

支持的语言

响应中的 result 可能以下语言：

语言名称	语言代码
Dutch	`nl`
English	`en`
Finnish	`fi`
French	`fr`
German	`de`
Italian	`it`
Spanish	`es`
Swedish	`sv`
Chinese (Simplified)	`zh-CN`
Chinese (Traditional)	`zh-TW`
Norwegian	`no`

可用地点以接口实时返回的 available_locations 为准。

请求示例

cURL

bash

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

Python

python

import requests

url = (
    "https://api.seermartech.cn"
    "/v3/keywords_data/bing/search_volume_history/locations_and_languages"
)

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

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

if result.get("status_code") == 20000:
    print(result)
else:
    print(
        "请求失败。状态码: %s，消息: %s"
        % (result.get("status_code"), result.get("status_message"))
    )

TypeScript

typescript

const url =
  "https://api.seermartech.cn/v3/keywords_data/bing/search_volume_history/locations_and_languages";

const response = await fetch(url, {
  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}`
  );
}

响应示例

json

{
  "version": "0.1.20240626",
  "status_code": 20000,
  "status_message": "Ok.",
  "time": "0.1915 sec.",
  "cost": 0,
  "tasks_count": 1,
  "tasks_error": 0,
  "tasks": [
    {
      "id": "00000000-0000-0000-0000-000000000000",
      "status_code": 20000,
      "status_message": "Ok.",
      "time": "0.1800 sec.",
      "cost": 0,
      "result_count": 11,
      "path": [
        "v3",
        "keywords_data",
        "bing",
        "search_volume_history",
        "locations_and_languages"
      ],
      "data": {
        "api": "keywords_data",
        "function": "locations_and_languages",
        "se": "bing",
        "se_type": "search_volume_history"
      },
      "result": [
        {
          "language_name": "Dutch",
          "language_code": "nl",
          "available_locations": []
        },
        {
          "language_name": "English",
          "language_code": "en",
          "available_locations": []
        },
        {
          "language_name": "Finnish",
          "language_code": "fi",
          "available_locations": []
        },
        {
          "language_name": "French",
          "language_code": "fr",
          "available_locations": []
        },
        {
          "language_name": "German",
          "language_code": "de",
          "available_locations": []
        },
        {
          "language_name": "Italian",
          "language_code": "it",
          "available_locations": []
        },
        {
          "language_name": "Spanish",
          "language_code": "es",
          "available_locations": []
        },
        {
          "language_name": "Swedish",
          "language_code": "sv",
          "available_locations": []
        },
        {
          "language_name": "Chinese (Simplified)",
          "language_code": "zh-CN",
          "available_locations": []
        },
        {
          "language_name": "Chinese (Traditional)",
          "language_code": "zh-TW",
          "available_locations": []
        },
        {
          "language_name": "Norwegian",
          "language_code": "no",
          "available_locations": []
        }
      ]
    }
  ]
}

状态码

顶层 status_code 和任务级 status_code 为 20000 时，表示请求成功。
状态码表示请求或任务处理异常，含义请参错误码附录。
建议同时检查 tasks_error、任务级 status_code 和 status_message，以确认任务是否成功。

实用场景

查询可用语言和地点，在提交搜索量历史任务前校验参数，因语言或地域不受支持而失败。
构建语言与地域选择器，根据实时返回的地点列表生成 SEO 平台下拉选项，减少硬编码维护成本。
批量规划多市场研究，筛选目标国家或地区支持的语言组合，统一开展跨市场搜索需求分析。
校验历史数据覆盖范围，在报表生成前确认 Bing 搜索量历史数据是否覆盖目标市场，提升分析结果的可靠性。

Bing「搜索量历史」支持的地点与语言列表 ​

请求 ​

请求地址 ​

请求头 ​

响应字段 ​

顶层字段 ​

tasks 任务字段 ​

data 字段 ​

result 及嵌套字段 ​

支持的语言 ​

请求示例 ​

cURL ​

Python ​

TypeScript ​

响应示例 ​

状态码 ​

实用场景 ​