获取 Trustpilot 评论任务结果

接口说明

用于按任务 id 获取已采集完成的 Trustpilot 评论结果。返回对应指定企业实体在 Trustpilot 上展示的评论数据。

本接口会尽可能高精度复现任务创建时的采集参数，使返回结果尽量贴近当时的页面。你也可以使用响应中的 check_url 自行校验结果性。建议在无痕模式下访问该链接，以减少个性化因素干扰。

需要注意的是，系统不会考虑用户偏好、历史记录及个性化搜索因素，因此这些因素不会体现在返回结果中。

请求方式

GET https://api.seermartech.cn/v3/business_data/trustpilot/reviews/task_get/{id}

计费说明

账户在创建任务时扣费；任务创建后，30 天可多次获取结果。

扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

路径参数

字段	类型	说明
id	string	任务唯一标识，UUID 格式。任务创建后可在 30 天随时通过该 id 获取结果。

返回结构

接口返回 JSON 数据，顶层 tasks 数组，用于承载任务结果。

顶层字段

字段	类型	说明
version	string	当前 API 版本。
status_code	integer	接口级状态码。完整错误码请参考 /v3/appendix/errors。建议在接时设计完善的异常处理机制。
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。完整状态码请参考 /v3/appendix/errors。
status_message	string	任务级状态说明。
time	string	任务执行耗时，单位秒。
cost	float	该任务成本，单位 USD。
result_count	integer	result 数组中的结果数量。
path	array	URL 路径。
data	object	与创建任务时 POST 请求中提交的参数一致。
result	array	结果数组。

tasks[].result[] 字段

字段	类型	说明
domain	string	企业实体域名。
type	string	创建任务时指定的搜索引擎类型。
se_domain	string	创建任务时指定的搜索引擎域名。
check_url	string	结果校验链接，可用于验证返回结果准确性。
datetime	string	结果采集时间，UTC 格式：yyyy-mm-dd hh-mm-ss +00:00。示例：2019-11-15 12:57:46 +00:00
title	string	Trustpilot 中 reviews 模块标题，通常为企业名称。
location	string	企业在 Trustpilot 中显示的位置/地址。
reviews_count	integer	评论总数。
rating	object	企业评分信息。
items_count	integer	items 数组中的评论条数。创建任务时可通过 depth 参数获取更多结果。
items	array	评论列表。创建任务时可通过 depth 参数获取更多结果。

rating 字段

字段	类型	说明
rating_type	string	评分类型，可为：Max5、Percents、CustomMax
value	float	基于评论计算出的平均分。
votes_count	integer	投票数。
rating_max	integer	当前 rating_type 对应的最大值。

items[] 字段

字段	类型	说明
type	string	评论类型，当前可能值：trustpilot_review_search
rank_group	integer	在相同 type 分组的位置。不同 type 的不会计该排序。
rank_absolute	integer	在评论中的绝对位置。
position	string	评论在结果页中的位置。文档中说明可能值为 right，响应中可能出现 left，请以返回值为准。
url	string	评论链接。
rating	object	用户提交的评论评分。
verified	boolean	是否带有 “Verified” 标记。
language	string	评论语言。
timestamp	string	评论发布时间，UTC 格式：yyyy-mm-dd hh-mm-ss +00:00。
title	string	评论标题。
review_text	string	评论正文。
review_images	array	评论附带图片链接。注意：该平台通常不支持评论附图，因此该字段通常恒为 null。
user_profile	object	评论用户资料。
responses	array	商家对该评论的回复。

items[].rating 字段

字段	类型	说明
rating_type	string	评分类型，当前可能值：Max5
value	float	评分值。
votes_count	integer	该评论获得的反馈数。
rating_max	integer	当前评分类型的最大值；Max5 的最大值为 5。

items[].user_profile 字段

字段	类型	说明
name	string	评论姓名。
url	string	评论个人主页链接。
image_url	string	评论头像链接。
location	string	评论所在国家/地区。
reviews_count	integer	该评论累计发布的评论数。

items[].responses[] 字段

字段	类型	说明
title	string	商家回复标题。
text	string	商家回复。
timestamp	string	回复发布时间，UTC 格式：yyyy-mm-dd hh-mm-ss +00:00。

沙箱调试

可通过以下沙箱地址查看本接口支持的完整字段结构，返回数据为模拟值，不会扣费：

https://sandbox.seermartech.cn/v3/business_data/trustpilot/reviews/task_get/00000000-0000-0000-0000-000000000000

调用示例

cURL

id="04011058-0696-0199-0000-2196151a15cb"

curl --location --request GET "https://api.seermartech.cn/v3/business_data/trustpilot/reviews/task_get/${id}" \
--header "Authorization: Bearer smt_live_YOUR_KEY" \
--header "Content-Type: application/json"

Python

import requests

task_id = "02231934-2604-0066-2000-570459f04879"
url = f"https://api.seermartech.cn/v3/business_data/trustpilot/reviews/task_get/{task_id}"

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

response = requests.get(url, headers=headers)
print(response.status_code)
print(response.json)

TypeScript

import axios from "axios";

const taskId = "02231934-2604-0066-2000-570459f04879";

axios({
 method: "get",
 url: `https://api.seermartech.cn/v3/business_data/trustpilot/reviews/task_get/${taskId}`,
 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.20210917",
 "status_code": 20000,
 "status_message": "Ok.",
 "time": "0.1143 sec.",
 "cost": 0,
 "tasks_count": 1,
 "tasks_error": 0,
 "tasks": [
 {
 "data": {
 "api": "business_data",
 "function": "reviews",
 "se": "trustpilot",
 "domain": "abetter.bid",
 "pingback_url": "https://your-server.com/pingback.php?id=$id&tag=$tag",
 "tag": "test",
 "language_name": "English",
 "language_code": "en",
 "location_name": "United States",
 "device": "desktop",
 "os": "windows"
 },
 "result": [
 {
 "type": "trustpilot_review_search",
 "rank_group": 3,
 "rank_absolute": 3,
 "position": "left",
 "url": "https://www.trustpilot.com//reviews/612851369c391649d84aa0fb",
 "rating": {
 "rating_type": "Max5",
 "value": 1,
 "votes_count": null,
 "rating_max": 5
 },
 "verified": false,
 "language": "en",
 "timestamp": "2021-08-27 02:43:02 +00:00",
 "title": "This whole site is a SCAM!!",
 "review_text": "This whole site is a SCAM!!! Don’t believe the customer service when you call them!! Do not I repeat do not put a $400 deposit down. These are scammers from another country they are scamming!!! This morning I put down a $400 deposit to bid on a vehicle there was no chance for me to win the bid (I was bidding against a computer) soon as I was done bidding they started calling my phone and emailing me saying that my deposit is no longer refundable and that I owe them $5000 for a vehicle that I cannot go get it does not run and I have to get it towed to my house for an additional fee of $190 call me if u want and I will send you screen shots of EVERYTHING (7026881933) I am currently trying to dispute this with my bank",
 "review_images": null,
 "user_profile": {
 "name": "Phoenix",
 "url": "https://www.trustpilot.com//users/6128512524140e00125f13a7",
 "image_url": "https://user-images.trustpilot.com/6128512524140e00125f13a7/73x73.png",
 "location": "US",
 "reviews_count": 1
 },
 "responses": null
 },
 {
 "type": "trustpilot_review_search",
 "rank_group": 4,
 "rank_absolute": 4,
 "position": "left",
 "url": "https://www.trustpilot.com//reviews/6121897e6e38167b798d0204",
 "rating": {
 "rating_type": "Max5",
 "value": 1,
 "votes_count": null,
 "rating_max": 5
 },
 "verified": false,
 "language": "en",
 "timestamp": "2021-08-21 23:17:18 +00:00",
 "title": "scammers.. stay away",
 "review_text": "sell every car \"as is\". trickin any new costumer. from 3700 auction bid to 5520.. i will lose a lot of money. when i just wanted to make a couple hundreds",
 "review_images": null,
 "user_profile": {
 "name": "Hernando Taveras",
 "url": "https://www.trustpilot.com//users/6121897875a58d0013734e34",
 "image_url": "https://user-images.trustpilot.com/6121897875a58d0013734e34/73x73.png",
 "location": "DO",
 "reviews_count": 1
 },
 "responses": null
 }
 ]
 }
 ]
}

错误处理建议

• 检查顶层 status_code 与 status_message，判断请求是否成功。
• 再检查 tasks[].status_code，确认任务是否成功返回结果。
• 若 tasks[].result 为空，通常表示任务尚未完成、任务不存在，或请求参数有误。
• 建议统一处理 /v3/appendix/errors 中定义的错误码与异常状态。

使用说明补

• 本接口用于获取已创建任务的结果，不会重复触发采集。
• 若需要获取更多评论，请在创建任务时通过 depth 参数提高抓取深度。
• 若需批量获取已完成任务，可调用 /v3/business_data/trustpilot/reviews/tasks_ready 获取可拉取任务列表，再逐个调用本接口。

实用场景

• 监控品牌口碑：定期拉取企业评论与平均评分，及时发现负面舆变化，品牌与客户成功团队快速响应。
• 识别差评主题：提取 title、review_text 与 rating.value，归纳退款、物流、客服等高频投诉点，指导运营优化服务流程。
• 跟踪商家回复率：分析 responses 字段，评估品牌是否及时回复评论，帮助制定评论运营与声誉管理 KPI。
• 评估海外市场反馈：结合 language、user_profile.location 查看不同国家/语言用户的评论表现，为区域市场运营提供依据。
• 构建竞品口碑对比：按多个企业域名创建任务并汇总 reviews_count、平均评分、评论，横向比较行业品牌信任度与用户满意度。