Tripadvisor 语言列表

GET /v3/business_data/tripadvisor/languages

接口概述

通过本接口可获取 Tripadvisor Business Data API 支持的语言列表。

• 请求方式：GET
• 请求地址：https://api.seermartech.cn/v3/business_data/tripadvisor/languages
• 是否收费：不收费
• 计费说明：扣费以响应头 X-SeerMarTech-Charge-CNY 为准；该接口通常返回 0

接口返回 JSON 数据，响应体中 tasks 数组，每个任务含对应结果信息。

请求信息

HTTP 请求

GET /v3/business_data/tripadvisor/languages

请求头

Authorization: Bearer smt_live_YOUR_KEY
Content-Type: application/json

请求参数

该接口无需请求体。

响应结构

字段名	类型	说明
version	string	当前 API 版本
status_code	integer	通用状态码
status_message	string	通用提示信息
time	string	执行时间，单位：秒
cost	float	本次请求总费用，单位：USD
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
result_count	integer	result 数组中的数量
path	array	URL 路径
data	object	GET 请求 URL 中携带的参数信息
result	array	结果数组

result 数组字段

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

状态码说明

• 通用状态码见：/v3/appendix/errors
• 任务级状态码见：/v3/appendix/errors

常见成功状态码：

状态码	说明
20000	请求成功

调用示例

cURL

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

Python

import requests

url = "https://api.seermartech.cn/v3/business_data/tripadvisor/languages"
headers = {
 "Authorization": "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json"
}

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

# 成功时可进一步读取 tasks/result 数据
print(result)

TypeScript

import axios from "axios";

// 获取 Tripadvisor 支持的语言列表
axios({
 method: "get",
 url: "https://api.seermartech.cn/v3/business_data/tripadvisor/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.20220627",
 "status_code": 20000,
 "status_message": "Ok.",
 "time": "0.0521 sec.",
 "cost": 0,
 "tasks_count": 1,
 "tasks_error": 0,
 "tasks": [
 {
 "id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
 "status_code": 20000,
 "status_message": "Ok.",
 "time": "0.0000 sec.",
 "cost": 0,
 "result_count": 1,
 "path": [
 "v3",
 "business_data",
 "tripadvisor",
 "languages"
 ],
 "data": {
 "api": "business_data",
 "function": "languages",
 "se": "tripadvisor"
 },
 "result": [
 {
 "language_name": "English",
 "language_code": "en"
 }
 ]
 }
 ]
}

字段解读

data 对象示例

字段名	说明
api	API 模块名称，固定为 business_data
function	当前功能名称，固定为 languages
se	数据源标识，固定为 tripadvisor

result 使用说明

result 中返回当前接口支持的语言集合。每个都：

• language_name：可读的语言名称
• language_code：对应的 ISO 639-1 双字母语言代码

这些语言代码通常可用于后续 Tripadvisor 接口中的 language_code 参数校验与枚举选择。

使用建议

在调用 Tripadvisor 数据接口前，建议通过本接口同步一次可用语言列表，并将结果缓存到本地系统中，以便：

• 为前端下拉选项提供合法语言值
• 在任务提交前做参数校验
• 减少因传无效语言代码导致的请求失败

实用场景

• 同步语言枚举：拉取 Tripadvisor 支持语言并写本地中心，确保前端筛选项与平台能力保持一致。
• 校验请求参数：在提交商家、评论或搜索类任务前校验 language_code，减少无效请求和排错成本。
• 驱动多语言采集：根据返回的语言列表批量构建多语种采集任务，扩展化 SEO 或舆分析覆盖范围。
• 生成运营后台选项：为运营或分析平台动态生成语言下拉菜单，手工维护枚举值。
• 监控能力变更：定期比对语言列表变动，及时发现平台 API 新增或下线的语言支持，便于调整采集策略。