获取 Trustpilot Reviews 已完成任务列表

接口说明

Tasks Ready 接口用于获取已执行完成但尚未被获取结果的任务列表。

如果你没有使用 postback_url，可以通过本接口获取所有已完成任务的 id，然后再使用对应的 Task GET 接口拉取任务结果。

需要注意的是，由于平台 API 的任务队列存在轻微延迟，已完成任务列表不会实时刷新。对于高并发场景，如果你的系统需要每分钟处理 1000 个任务，建议优使用 pingback/postback 回调机制，而将 Tasks Ready 用于补偿拉取那些回调失败的任务 ID。

接口地址

获取 Trustpilot Reviews 已完成任务列表：

GET https://api.seermartech.cn/v3/business_data/trustpilot/reviews/tasks_ready

通用容路径如下：

• 指定搜索引擎的已完成任务列表：GET /v3/business_data/$se/tasks_ready -部 Business Data API 已完成任务列表：GET /v3/business_data/tasks_ready

本文档对应的端点为：/v3/business_data/trustpilot/reviews/tasks_ready

计费与调用限制

• 获取已完成任务列表不收费
• 每个任务会一直保留在列表中，直到你主动获取结果
• 每分钟最多可调用 20 次
• 单次调用最多返回 1000 个在过去 3 天完成的任务
• 已经被成功拉取的任务，不会再次出现在列表中
• 任务完成后若** 3 天仍未拉取**，也不会再出现在列表中

postback_url 的说明

如果你在创建任务时指定了 postback_url，该任务通常不会出现在已完成任务列表中。

只有在回调请求发送失败时，任务才可能该列表，例如：

• 你的服务端请求失败
• 你的服务端返回的 HTTP 状态码 小于 200
• 你的服务端返回的 HTTP 状态码 大于 300

返回结果说明

接口返回 JSON 格式数据，顶层 tasks 数组，每个表示一次接口调用结果。

顶层字段

字段名	类型	说明
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	object	请求 URL 中传的参数信息
result	array	已完成任务列表

tasks[].result[] 字段

字段名	类型	说明
id	string	已完成任务的唯一标识，UUID 格式
se	string	创建任务时指定的搜索引擎；当前端点固定为 trustpilot
se_type	string	搜索引擎类型
date_posted	string	任务提交时间，UTC 格式
tag	string	自定义任务标识
endpoint	string	用于拉取该任务结果的接口地址

请求示例

cURL

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

Python

import requests

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

# 获取已完成但尚未拉取的任务列表
response = requests.get(url, headers=headers)
result = response.json

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/business_data/trustpilot/reviews/tasks_ready",
 headers: {
 "Authorization": "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json"
 }
}).then((response) => {
 // 返回结果数据
 console.log(response.data);
}).catch((error) => {
 console.error(error);
});

响应示例

以下示例为参考文档原始结构的中文化整理。原始页面中的示例 JSON 存在排版缺失，响应请以线上返回为准。

{
 "version": "0.1.20210917",
 "status_code": 20000,
 "status_message": "Ok.",
 "time": "0.1630 sec.",
 "cost": 0,
 "tasks_count": 1,
 "tasks_error": 0,
 "tasks": [
 {
 "id": "018a597f-0f94-0000-0000-9f7b2d8e1234",
 "status_code": 20000,
 "status_message": "Ok.",
 "time": "0.0181 sec.",
 "cost": 0,
 "result_count": 1,
 "path": [
 "v3",
 "business_data",
 "trustpilot",
 "reviews",
 "tasks_ready"
 ],
 "data": {
 "api": "business_data",
 "function": "reviews",
 "se": "trustpilot",
 "se_type": "reviews"
 },
 "result": [
 {
 "id": "018a597f-1ab2-0000-0000-3a5d4e6f7890",
 "se": "trustpilot",
 "se_type": "reviews",
 "date_posted": "2023-10-31 12:15:20 +00:00",
 "tag": "brand-review-batch-01",
 "endpoint": "/v3/business_data/trustpilot/reviews/task_get/018a597f-1ab2-0000-0000-3a5d4e6f7890"
 }
 ]
 }
 ]
}

使用建议

1. 调用本接口获取已完成任务 ID
2. 遍历 tasks[].result[] 中的 id 或 endpoint
3. 再调用对应的 Task GET 接口获取完整评论结果
4. 如果你的系统使用了 postback_url，建议将本接口作为失败补偿机制，而不是主拉取方案

错误处理建议

• 请基于顶层 status_code 判断请求是否成功
• 同时检查 tasks[].status_code，部分任务失败被忽略
• 建议对 /v3/appendix/errors 中的状态码建立统一异常处理逻辑
• 对于高吞吐任务场景，建议重试、限流和任务去重机制

实用场景

• 补拉失败回调任务：当异步回调因网络抖动或服务异常失败时，通过本接口找回遗漏任务，评论数据丢失。
• 轮询获取已完成评论抓取结果：未回调时，定时拉取已完成任务 ID，再批量获取评论，构建稳定的数据采集流程。
• 监控任务执行积压：统计 3 天未被拉取的完成任务数量，及时发现下游消费异常或结果处理延迟。
• 业务标签追踪批次任务：结合 tag 字段识别不同品牌、门店或采集批次，便于排查任务完成。
• 构建评论采集补偿链路：将 Tasks Ready 与结果拉取接口组合使用，形成“回调优 + 轮询底”的可靠采集架构。