keywords_data/bing/keyword_suggestions_for_url/languages

获取 Bing URL 建议支持的语言

请求方式： GET
请求路径： /v3/keywords_data/bing/keyword_suggestions_for_url/languages

本接口返回 Bing URL 建议功能支持的语言列表。响应为 JSON 格式，任务执行状态以及可用语言信息。

计费说明

本接口调用，不扣除账户余额。响应中的 cost 字段（平台原始 USD 成本兼容字段）通常为 0。

请求示例

cURL

bash

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

PHP

php

<?php

$ch = curl_init();

curl_setopt_array($ch, [
    CURLOPT_URL => 'https://api.seermartech.cn/v3/keywords_data/bing/keyword_suggestions_for_url/languages',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer smt_live_YOUR_KEY',
        'Content-Type: application/json',
    ],
]);

$response = curl_exec($ch);

if ($response === false) {
    echo '请求失败：' . curl_error($ch);
} else {
    $result = json_decode($response, true);
    print_r($result);
}

curl_close($ch);

TypeScript

typescript

import axios from 'axios';

axios({
  method: 'get',
  url: 'https://api.seermartech.cn/v3/keywords_data/bing/keyword_suggestions_for_url/languages',
  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

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

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

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

if response.status_code == 200:
    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)

C#

csharp

using System;
using System.Net.Http;
using System.Net.Http.Headers;
using System.Threading.Tasks;
using Newtonsoft.Json.Linq;

namespace SeerMarTechDemos
{
    public static class Demos
    {
        public static async Task GetBingKeywordSuggestionLanguages()
        {
            using var httpClient = new HttpClient();

            httpClient.DefaultRequestHeaders.Authorization =
                new AuthenticationHeaderValue("Bearer", "smt_live_YOUR_KEY");

            var response = await httpClient.GetAsync(
                "https://api.seermartech.cn/v3/keywords_data/bing/keyword_suggestions_for_url/languages"
            );

            var content = await response.Content.ReadAsStringAsync();
            var result = JObject.Parse(content);

            if ((int?)result["status_code"] == 20000)
            {
                Console.WriteLine(result);
            }
            else
            {
                Console.WriteLine(
                    $"接口错误。错误码：{result["status_code"]}，错误信息：{result["status_message"]}"
                );
            }
        }
    }
}

响应字段

顶层字段

字段名	类型	说明
`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	请求路径中使用的接口参数
`result`	array	支持的语言列表

`tasks[].data` 字段

字段名	类型	说明
`api`	string	API 模块名称，通常为 `keywords_data`
`function`	string	接口功能名称，通常为 `languages`
`se`	string	搜索引擎名称，值为 `bing`
`se_type`	string	数据类型，值为 `keyword_suggestions_for_url`

`tasks[].result[]` 字段

字段名	类型	说明
`language_name`	string	语言名称
`language_code`	string	语言代码，遵循 ISO 639-1 标准

响应示例

json

{
  "version": "0.1.20240801",
  "status_code": 20000,
  "status_message": "Ok.",
  "time": "0.0638 sec.",
  "cost": 0,
  "tasks_count": 1,
  "tasks_error": 0,
  "tasks": [
    {
      "id": "01234567-89ab-cdef-0123-456789abcdef",
      "status_code": 20000,
      "status_message": "Ok.",
      "time": "0.0210 sec.",
      "cost": 0,
      "result_count": 3,
      "path": [
        "v3",
        "keywords_data",
        "bing",
        "keyword_suggestions_for_url",
        "languages"
      ],
      "data": {
        "api": "keywords_data",
        "function": "languages",
        "se": "bing",
        "se_type": "keyword_suggestions_for_url"
      },
      "result": [
        {
          "language_name": "English",
          "language_code": "en"
        },
        {
          "language_name": "German",
          "language_code": "de"
        },
        {
          "language_name": "French",
          "language_code": "fr"
        }
      ]
    }
  ]
}

状态码

当顶层或任务级别的 status_code 为 20000 时，表示请求成功。状态码表示请求或任务执行异常，请结合对应的 status_message 排查问题。

实用场景

获取支持语言列表，在提交 URL 建议任务前校验语言参数，因语言代码不受支持导致任务失败。
构建多语言 SEO 工，根据接口返回的语言名称和 ISO 639-1 代码动态生成语言选择器，支持不同市场的研究。
同步 Bing 市场，定期更新系统中的可用语言单，确保 SEO 分析平台与平台能力保持一致。
校验跨地区流程，在批量处理不同国家和语言的页面前完成参数预检，减少无效请求和任务重试。
生成语言覆盖报告，统计建议功能覆盖的语言范围，为化和市场拓展提供依据。

keywords_data/bing/keyword_suggestions_for_url/languages ​

获取 Bing URL 建议支持的语言 ​

计费说明 ​

请求示例 ​

cURL ​

PHP ​

TypeScript ​

Python ​

C# ​

响应字段 ​

顶层字段 ​

tasks 数组中的任务字段 ​

tasks[].data 字段 ​

tasks[].result[] 字段 ​

响应示例 ​

状态码 ​

实用场景 ​