Business Data API：Tripadvisor 概览

本接口用于获取 Tripadvisor 上展示的商家信息及评论数据。

接口：

• POST /v3/business_data/tripadvisor/search/task_post/：按和地点搜索 Tripadvisor 上的商家，获取商家名称、评分及 url_path 等信息。
• POST /v3/business_data/tripadvisor/reviews/task_post/：根据商家的 url_path 或获取评论数据。
• /v3/business_data/tripadvisor/locations/：获取可用于搜索的地点列表。

通过 Tripadvisor 搜索接口，可以获取商家名称、评分以及 url_path。随后，可将 url_path 传 Tripadvisor 评论接口，获取该商家的完整评论数据。

评论接口支持返回以下信息：

• 评论总数
• 评论提交时间
• 评分
• 评论正文
• 评论发布的图片
• 评论个人资料信息
• 评论数据

设置任务

Tripadvisor 搜索

搜索结果取决于指定的和地点。地点参数应使用本平台支持的地点值，详见 /v3/business_data/tripadvisor/locations/。

应表示商家类别或商家名称，例如：

[
  {
    "keyword": "pizza restaurant",
    "location_name": "New York, New York, United States"
  }
]

也可以直接指定商家名称：

[
  {
    "keyword": "Margaritaville",
    "location_name": "New York, New York, United States"
  }
]

> 注意：如果需要返回 Tripadvisor 上的商家列表，keyword 应填写商家类别或名称，而不是过于宽泛的描述。

Tripadvisor 评论

评论结果取决于指定的 url_path 或。

如需获取指定商家的 Tripadvisor 评论，url_path须对应 Tripadvisor 上已存在的商家实体。

url_path 可以从 Tripadvisor 商家页 URL 中获取。例如，Margaritaville Resort Times Square 的页面 URL 为：

https://www.tripadvisor.com/Hotel_Review-g60763-d23462501-Reviews-Margaritaville_Times_Square-New_York_City_New_York.html

对应的 url_path 为：

Hotel_Review-g60763-d23462501-Reviews-Margaritaville_Times_Square-New_York_City_New_York.html

请求示例：

[
  {
    "url_path": "Hotel_Review-g60763-d23462501-Reviews-Margaritaville_Times_Square-New_York_City_New_York.html"
  }
]

本平台会尽可能准确地模拟指定参数下的搜索条件，使返回结果与任务提交时可见的搜索结果保持一致。

可以通过响应中的 check_url 在无痕模式下打开结果页面，以核验返回数据是否与目标搜索条件匹。

> 注意：系统不会使用用户偏好、搜索历史或个性化搜索因素，因此这些因素不会反映在返回结果中。

数据获取方式

Business Data API 的所有端点均支持标准数据获取方式。该方式需要分别发起 POST 和 GET 请求：

1. 通过 POST 请求提交任务；
2. 等任务完成；
3. 通过 GET 请求获取任务结果。

如果提交任务时指定了 pingback_url 或 postback_url，任务完成后，本平台会向指定地址发送通知或结果数据。

如果未指定 pingback_url 或 postback_url，可以通过 Tasks Ready 接口获取所有已完成但尚未读取的任务 ID，再使用 Task GET 接口获取结果。

请求限制

平台限流以认证说明中的 30/60/120 次/分钟规则为准；

• 每次 POST 请求最多 100 个任务；
• 如需提高请求限制，请联系平台支持团队。

认证示例

curl --request POST \
  --url https://api.seermartech.cn/v3/business_data/tripadvisor/search/task_post/ \
  --header 'Authorization: Bearer smt_live_YOUR_KEY' \
  --header 'Content-Type: application/json' \
  --data '[
    {
      "keyword": "pizza restaurant",
      "location_name": "New York, New York, United States"
    }
  ]'

优级与计费

Business Data API 支持两种任务优级，不同优级对应不同的任务执行速度和费用：

1. 普通优级：适用于对返回速度要求一般的任务；
2. 高优级：适用于需要更快完成任务的场景。

扣费以响应头 X-SeerMarTech-Charge-CNY 为准。任务费用会根据接口、优级及任务数量计算。

接口

接口	方法	用途
/v3/business_data/tripadvisor/search/task_post/	POST	按和地点搜索 Tripadvisor 商家
/v3/business_data/tripadvisor/reviews/task_post/	POST	获取指定商家的 Tripadvisor 评论
/v3/business_data/tripadvisor/locations/	GET	获取可用地点列表
Tasks Ready	GET	获取已完成但尚未读取的任务 ID
Task GET	GET	获取指定任务的结果数据

实用场景

• 搜索指定城市和商家类别下的 Tripadvisor 商家，建立本地生活或行业的竞品名单。
• 采集商家评分及评论，分析用户对服务、环境和产品的主要反馈。
• 监测目标、餐或景点的评论数量与评分变化，支持品牌口碑追踪。
• 提取评论发布的图片和用户资料信息，用于研究用户生成及客群特征。
• 对比不同地点或同类商家的评分与评论表现，为选址、竞品分析和 SEO规划提供依据。