Google 评论支持语言列表

接口说明

通过本接口可获取 Google Reviews 支持的语言列表。

• 请求方式：GET
• 请求地址：https://api.seermartech.cn/v3/reviews/google/languages
• 计费说明：接口，不产生扣费
• 返回格式：JSON

接口响应中会返回 tasks 数组，本次请求的任务信息及结果数据。

请求信息

HTTP Request

GET /v3/reviews/google/languages

请求头

Authorization: Bearer smt_live_YOUR_KEY
Content-Type: application/json

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

响应结构

顶层字段

字段名	类型	说明
version	string	当前 API 版本
status_code	integer	接口通用状态码，可参考 /v3/appendix/errors
status_message	string	接口通用状态信息，可参考 /v3/appendix/errors
time	string	执行时间，单位秒
cost	float	本次请求总成本，单位 USD；该接口通常为 0，扣费以响应头 X-SeerMarTech-Charge-CNY 为准
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	任务状态信息
time	string	任务执行时间，单位秒
cost	float	当前任务成本，单位 USD
result_count	integer	result 数组中的数量
path	array	URL 路径
data	array	GET 请求 URL 中传的参数
result	array	结果数组

result[] 字段

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

调用示例

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)
result = response.json

# 可根据返回的 status_code 判断是否成功
if result.get("status_code") == 20000:
 print(result)
else:
 print(f'error. Code: {result.get("status_code")} Message: {result.get("status_message")}')

TypeScript

import axios from "axios";

axios({
 method: "get",
 url: "https://api.seermartech.cn/v3/reviews/google/languages",
 headers: {
 Authorization: "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json",
 },
})
 .then((response) => {
 // 返回结果
 console.log(response.data);
 })
 .catch((error) => {
 console.error(error);
 });

响应示例

{
 "version": "0.1.20200325",
 "status_code": 20000,
 "status_message": "Ok.",
 "time": "0.0964 sec.",
 "cost": 0,
 "tasks_count": 1,
 "tasks_error": 0,
 "tasks": [
 {
 "data": {
 "api": "reviews",
 "function": "languages",
 "se": "google"
 },
 "result": [
 {
 "language_name": "English",
 "language_code": "en"
 }
 ]
 }
 ]
}

状态码说明

可通过以下字段判断调用结果：

• 顶层 status_code：本次接口请求的整体状态
• tasks[].status_code：任务的执行状态

常见成功状态：

• 20000：请求成功

错误码及通用信息可参考 /v3/appendix/errors。

使用建议

在调用评论采集、评论搜索或评论分析接口前，建议通过本接口获取可用语言代码，以便：

• 规范传参，传无效语言值
• 为多语言评论抓取建立统一语言映射
• 在前端语言下拉选项时，直接使用接口返回值

实用场景

• 初始化语言：获取 Google 评论支持的语言单，用于后台中心或前端筛选器，减少人工维护成本。
• 校验评论采集参数：在发起评论任务前校验 language_code，因语言参数无效导致请求失败。
• 构建多语言评论监测：基于支持语言列表批量建立多国家、多语种的评论抓取任务，提升化品牌监测覆盖率。
• 统一语言映射表：将接口返回的 ISO 639-1 语言代码接数据仓库，便于跨系统对齐评论数据字段。
• 驱动产品界面选项：将返回的语言名称与代码直接用于表单、筛选器或运营界面，提高效率与准确性。