Business Data API：Trustpilot 概览

本接口组用于获取 Trustpilot 平台展示的企业信息企业搜索结果、企业及用户评价数据。可通过接口按行业或企业名称查找目标企业，并获取指定企业的评论、评分及评论资料。

可用的主要接口：

Trustpilot 企业搜索：POST /v3/business_data/trustpilot/search/task_post/
Trustpilot 评论任务提交：POST /v3/business_data/trustpilot/reviews/task_post/
Trustpilot 评论任务结果获取：通过对应的 Task GET 接口获取已完成任务结果。

支持的数据类型

企业搜索

企业搜索接口根据任务请求中的 keyword 字段返回的 Trustpilot 企业实体。

keyword 应填写企业所属行业、服务类别或企业名称，例如：

行业类别：restaurant
企业名称：taco bell

使用行业可以发现该类别下的企业；使用企业名称可定位特定品牌或。

企业评论

企业评论接口根据任务请求中的 domain 字段返回指定企业在 Trustpilot 平台上的评价数据。

可获取的数据通常：

评论总数；
评论提交时间；
星级评分及评分明细；
评论正文；
评论上传的图片；
评论资料；
企业信息；
评价页面中的字段。

domain须对应 Trustpilot 中已存在的企业实体。该值通常可从企业评价页 URL 中提取。

例如，某企业的评价页面地址为：

text

https://www.trustpilot.com/review/www.thepearlsource.com

则请求中应使用：

json

[
  {
    "domain": "www.thepearlsource.com"
  }
]

任务提交与结果获取

本接口组采用标准异步任务模式。您需要提交任务，再获取任务执行结果。

标准流程如下：

调用对应的 Task POST 接口创建任务；
平台采集并处理数据；
调用对应的 Task GET 接口获取任务结果。

也可以在创建任务时以下回调字段：

pingback_url：任务完成后，平台向该地址发送完成通知；
postback_url：任务完成后，平台将任务结果主动推送至该地址。

如果未设置 pingback_url 或 postback_url，可通过 Tasks Ready 接口获取所有已完成但尚未提取结果的任务 ID，再使用相应的 Task GET 接口拉取结果。

搜索结果说明

本平台会尽可能提交任务时指定的参数模拟对应平台的搜索与评价页面结果。返回结果反映任务创建时可获取的数据。

响应中如 check_url，可使用浏览器无痕模式访问该地址，以核对采集结果与页面。

为降低个性化因素对结果的影响，系统不会使用用户搜索历史、登录状态、偏好设置或个性化信息。因此，返回结果不会由此类因素导致的个性化排序或展示差异。

调用限制

接口调用限制如下：

项目	限制
POST 与 GET 请求总量	每分钟最多 2,000 次
单个 POST 请求中的任务数量	最多 100 个

如需提高调用额，请联系技术支持。

优级与计费

Business Data API 支持以下任务优级：

优级	说明
`normal`	常规优级，适用于大多数批量采集场景。
`high`	高优级，通常更快的任务执行速度。

不同优级对应不同计费标准。扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

请求示例

以下示例创建一个 Trustpilot 企业搜索任务。

bash

curl -X POST "https://api.seermartech.cn/v3/business_data/trustpilot/search/task_post/" \
  -H "Authorization: Bearer smt_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '[
    {
      "keyword": "restaurant",
      "location_name": "United States",
      "language_name": "English"
    }
  ]'

以下示例创建一个指定企业的评论采集任务。

bash

curl -X POST "https://api.seermartech.cn/v3/business_data/trustpilot/reviews/task_post/" \
  -H "Authorization: Bearer smt_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '[
    {
      "domain": "www.thepearlsource.com"
    }
  ]'

Python 示例

python

import requests

url = "https://api.seermartech.cn/v3/business_data/trustpilot/reviews/task_post/"

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

# POST 请求体为 JSON 数组
payload = [
    {
        "domain": "www.thepearlsource.com"
    }
]

response = requests.post(url, headers=headers, json=payload, timeout=30)
response.raise_for_status()

print(response.json())

TypeScript 示例

typescript

const response = await fetch(
  "https://api.seermartech.cn/v3/business_data/trustpilot/reviews/task_post/",
  {
    method: "POST",
    headers: {
      Authorization: "Bearer smt_live_YOUR_KEY",
      "Content-Type": "application/json",
    },
    // POST 请求体为 JSON 数组
    body: JSON.stringify([
      {
        domain: "www.thepearlsource.com",
      },
    ]),
  }
);

const result = await response.json();
console.log(result);

实用场景

监控品牌口碑：定期获取指定品牌的评论数量、星级和评论正文，及时发现服务质量、物流、售后等负面反馈趋势。
筛选行业竞品：使用行业搜索企业，快速建立目标市场中的竞品名单，为竞品研究和市场分析提供基础数据。
分析用户评价主题：采集企业评论文本并进行感分析、聚类，识别最的产品质量、价格和服务问题。
评估合作伙伴信誉：查询潜在供应商、渠道商或服务商的评价与评分，商务合作前的风险评估。
追踪声誉优化效果：对比不同时间段的评分、评论量和评价变化，衡量客户体验优化与品牌声誉管理措施的效果。

Business Data API：Trustpilot 概览 ​

支持的数据类型 ​

企业搜索 ​

企业评论 ​

任务提交与结果获取 ​

搜索结果说明 ​

调用限制 ​

优级与计费 ​

请求示例 ​

Python 示例 ​

TypeScript 示例 ​

实用场景 ​