Bing 搜索量历史支持的地区与语言列表

GET /v3/keywords_data/bing/search_volume_history/locations_and_languages

接口说明

该接口用于获取 Bing Search Volume History 端点当前支持的语言及对应可用地区列表。

• 请求方式：GET
• 请求地址：https://api.seermartech.cn/v3/keywords_data/bing/search_volume_history/locations_and_languages
• 计费说明：调用此接口不收费
• 实扣费以响应头 X-SeerMarTech-Charge-CNY 为准

接口返回 JSON 结构 tasks 数组本次请求的任务信息，result 数组中列出所有可用语言及对应的可用地区。

---

响应字段说明

顶层字段

字段名	类型	说明
version	string	当前 API 版本
status_code	integer	通用状态码，完整列表参考 /v3/appendix/errors
status_message	string	通用状态信息，完整列表参考 /v3/appendix/errors
time	string	执行耗时，单位秒
cost	float	本次请求总费用，单位 USD
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	任务状态信息，完整列表参考 /v3/appendix-errors/
time	string	当前任务执行耗时，单位秒
cost	float	当前任务费用，单位 USD
result_count	integer	result 数组中的数量
path	array	URL 路径
data	object	GET 请求 URL 中传的参数信息
result	array	结果数组

tasks[].data 字段

字段名	类型	说明
api	string	API 模块名称
function	string	调用的方法名称
se	string	搜索引擎，固定为 bing
se_type	string	数据类型，固定为 search_volume_history

tasks[].result[] 字段

字段名	类型	说明
language_name	string	语言名称
language_code	string	语言代码，遵循 ISO 639-1
available_locations	array	该语言下可用的地区列表

tasks[].result[].available_locations[] 字段

字段名	类型	说明
location_code	integer	地区代码
location_name	string	地区称
country_iso_code	string	地区所属国家的 ISO 国家代码
location_type	string	地区类型

---

请求示例

cURL

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

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)
print(response.json)

TypeScript

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

async function main {
 const response = await fetch(url, {
 method: "GET",
 headers: {
 "Authorization": "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json"
 }
 });

 const data = await response.json;
 console.log(data);
}

main;

---

响应示例

{
 "version": "0.1.20240626",
 "status_code": 20000,
 "status_message": "Ok.",
 "time": "0.1915 sec.",
 "cost": 0,
 "tasks_count": 1,
 "tasks_error": 0,
 "tasks": [
 {
 "data": {
 "api": "keywords_data",
 "function": "locations_and_languages",
 "se": "bing",
 "se_type": "search_volume_history"
 },
 "result": [
 {
 "language_name": "Danish",
 "language_code": "da",
 "available_locations": []
 },
 {
 "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	请求整体状态码
tasks[].status_code	单个任务状态码

常见判断方式：

• 20000：请求成功
• 状态码：表示请求失败或部分异常，建议结合 status_message 排查
• 完整错误码列表参考 /v3/appendix/errors

---

使用说明

调用本接口后，可获得 Bing 搜索量历史接口支持的语言列表，以及每种语言下使用的地区集合。通常建议调用本接口缓存可用，再在后续搜索量历史查询中传合法的 language_code 和 location_code，以无效请求。

如果你需要构建参数选择器、地区语言联动下拉框，或在批量任务前做参数合法性校验，这个接口适合作为基础来源。

实用场景

• 校验查询参数：在提交 Bing 搜索量历史任务前，验证 language_code 与 location_code 是否受支持，减少无效请求和失败任务。
• 生成地区语言下拉列表：为后台、SaaS 面板或客户自助分析页动态生成可选语言与地区，提高准确性。
• 同步平台基础字：定期拉取最新支持范围并写本地数据库，便于后续分析流程统一复用。
• 限制业务投放范围：根据接口返回的可用地区与语言，约束 SEO 市场分析范围，向不支持的市场发起数据请求。
• 构建多市场分析流程：识别可用语言及地区组合，再批量发起不同国家/语言的搜索量历史分析，提升化 SEO 研究效率。