Google 评论支持的语言列表

接口概述

本接口用于获取 Google 评论数据支持的语言列表。

请求方法： GET
请求路径： /v3/reviews/google/languages

调用成功后，接口将返回语言名称和 ISO 639-1 语言代码的 JSON 数据。

计费说明

本接口调用，任务成本返回值为 0。扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

请求示例

cURL

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

Python

import requests

url = "https://api.seermartech.cn/v3/reviews/google/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(
            f"接口错误：{result.get('status_code')} "
            f"{result.get('status_message')}"
        )
else:
    print(f"HTTP 错误：{response.status_code}")

TypeScript

import axios from "axios";

axios
  .get("https://api.seermartech.cn/v3/reviews/google/languages", {
    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.message);
  });

响应结构

接口返回 JSON 对象，主要字段如下：

字段	类型	说明
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	GET 请求中传的参数信息
result	array	语言列表结果

result 结果字段

字段	类型	说明
language_name	string	语言名称
language_code	string	符合 ISO 639-1 标准的语言代码

如需查看完整状态码和错误信息，请参考错误码文档。

响应示例

{
  "version": "0.1.20200325",
  "status_code": 20000,
  "status_message": "Ok.",
  "time": "0.0964 sec.",
  "cost": 0,
  "tasks_count": 1,
  "tasks_error": 0,
  "tasks": [
    {
      "id": "00000000-0000-0000-0000-000000000000",
      "status_code": 20000,
      "status_message": "Ok.",
      "time": "0.0500 sec.",
      "cost": 0,
      "result_count": 2,
      "path": [
        "v3",
        "reviews",
        "google",
        "languages"
      ],
      "data": {
        "api": "reviews",
        "function": "languages",
        "se": "google"
      },
      "result": [
        {
          "language_name": "English",
          "language_code": "en"
        },
        {
          "language_name": "Chinese",
          "language_code": "zh"
        }
      ]
    }
  ]
}

状态码说明

• 20000：请求成功。
• 状态码：请求或任务处理失败，原因请查看 status_message。

实用场景

• 获取支持语言列表：在创建 Google 评论采集任务前校验语言代码，因传不支持的语言参数导致任务失败。
• 构建多语言评论筛选器：将返回的语言名称和代码接后台筛选组件，支持运营人员按语言分析评论。
• 化 SEO 报表：根据语言代码拆分不同市场的评论数据，比较各地区用户反馈与本地搜索表现。
• 规范化评论数据字段：使用 ISO 639-1 代码统一不同来源的语言标识，便于后续统计、聚合和数据仓库建模。