获取 Google My Business Info 已完成任务列表

接口说明

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

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

如需了解任务完成机制以及已完成任务列表的获取方式，可参考文档中的说明。

注意： 由于平台架构特性，已完成任务队列的更新会有轻微延迟。对于高并发场景，如果你的系统需要每分钟拉取 1000 个任务，建议优使用 pingback/postback 方式在回调失败时再使用 Tasks Ready 接口补拉失败任务的 ID。

请求地址

当前端点

GET https://api.seermartech.cn/v3/business_data/google/my_business_info/tasks_ready

同类容路径

可按搜索引擎维度获取已完成任务列表：

GET https://api.seermartech.cn/v3/business_data/$se/tasks_ready

获取 Business Data API 已完成任务列表：

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

计费说明

获取已完成任务列表不会产生费用。

• 参考价约 ¥0.0000 / 次
• 实扣费以响应头 X-SeerMarTech-Charge-CNY 为准

使用限制

• 每分钟最多调用 20 次
• 每次调用最多返回过去 3 天完成的 1000 个任务
• 已经成功拉取过结果的任务，不会再次出现在列表中
• 任务完成后 3 天未拉取，也不会继续保留在列表中

postback 说明

如果任务设置了 postback_url，该任务通常不会出现在已完成任务列表中。

只有以下，该任务才可能出现在列表中：

• 回调请求发送到你的服务器失败
• 你的服务器返回的 HTTP 状态码小于 200 或大于 300

因此，本接口也适合用作 postback 失败任务补偿拉取 的底方案。

返回结果说明

接口返回 JSON 数据，顶层 tasks 数组，每个任务对象中一组结果信息。

顶层字段

字段名	类型	说明
version	string	当前 API 版本
status_code	integer	接口整体状态码，可参考 /v3/appendix/errors
status_message	string	接口整体状态信息，可参考 /v3/appendix/errors
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	请求路径
data	object	请求 URL 中携带的参数信息
result	array	结果数组

tasks[].result[] 字段

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

请求示例

cURL

curl --location --request GET "https://api.seermartech.cn/v3/business_data/google/my_business_info/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/google/my_business_info/tasks_ready"
headers = {
 "Authorization": "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json"
}

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

if data.get("status_code") == 20000:
 print(data)
else:
 print(f'error. Code: {data.get("status_code")} Message: {data.get("status_message")}')

TypeScript

import axios from "axios";

// 获取已完成但尚未拉取的任务列表
axios({
 method: "get",
 url: "https://api.seermartech.cn/v3/business_data/google/my_business_info/tasks_ready",
 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.20200909",
 "status_code": 20000,
 "status_message": "Ok.",
 "time": "0.2261 sec.",
 "cost": 0,
 "tasks_count": 1,
 "tasks_error": 0,
 "tasks": [
 {
 "data": {
 "se_type": "my_business_info",
 "se": "google",
 "api": "business_data",
 "function": "my_business_info"
 },
 "result": []
 }
 ]
}

说明：平台原始示例中的响应结构存在排版缺失，此处按可解析的 JSON 形式整理展示。返回时，tasks[].result[] 中会提供已完成任务的 id、endpoint、date_posted、tag 等信息，用于后续结果拉取。

获取结果流程建议

推荐按以下流程使用本接口：

1. 提交 Google My Business Info 任务
2. 轮询 /v3/business_data/google/my_business_info/tasks_ready
3. 获取已完成任务的 id 和 endpoint
4. 调用对应的 Task GET 接口拉取
5. 将结果库并标记任务已消费

如果你已经使用 postback_url，则建议：

• 正常通过回调接收结果
• 在回调失败或漏收时，使用本接口补查任务 ID

错误处理建议

建议对以下做健壮性处理：

• 接口整体 status_code 非 20000
• tasks_error 大于 0
• tasks 为空
• result 为空
• 返回结果延迟，短时间未查到刚完成的任务
• 任务已 3 天未拉取，导致无法通过本接口获取

完整错误码可参考：

/v3/appendix/errors

实用场景

• 补拉漏收任务：当 postback 回调丢失或处理失败时，快速找回已完成任务 ID，数据缺口。
• 轮询完成队列：在未回调的，定时查询已完成任务并批量获取结果，构建稳定的异步采集流程。
• 监控任务产出：统计最近 3 天已完成任务数量，评估 Google 商家信息采集任务的执行效率。
• 建立结果消费队列：将 tasks_ready 返回的任务 ID 写消息队列，供后续结果抓取服务异步消费。
• 排查回调异常：结合失败回调任务才会列表的特性，快速定位服务端回调状态码异常或网络问题。