获取 Gemini LLM 抓取器已完成任务

GET /v3/ai_optimization/gemini/llm_scraper/tasks_ready

本接口使用 GET 方法，请求路径为：

/v3/ai_optimization/gemini/llm_scraper/tasks_ready

接口说明

“Tasks Ready”接口用于获取尚未领取的已完成任务列表。

当您使用标准任务提交方式且未设置 postback_url 时，可通过本接口获取所有已完成任务的 id，然后使用对应的任务结果接口获取详细结果。

> 注意：由于任务完成队列存在少量同步延迟，高并发场景下可能无法立即获取刚完成的任务。

如果系统需要每分钟领取 1000 个任务，建议优使用回调通知机制。本接口更适合用于补偿获取回调失败的任务 ID。

请求限制

本接口不收取结果获取费用。
每个任务会一直保留在已完成任务列表中，直到被成功领取。
每分钟最多调用 20 次。
每次调用最多返回过去 3 天完成的 1000 个任务。
已经领取的任务不会再次出现在列表中。
完成后 3 天仍未领取的任务将从列表中移除。
如果提交任务时设置了 postback_url，任务通常不会出现在本接口返回结果中。
只有当回调请求失败，且您的服务器返回的 HTTP 状态码小于 200 或大于 300 时，该任务才可能出现在已完成任务列表中。

本接口返回 JSON 数据 tasks 数组已完成任务的信息。

扣费以响应头 X-SeerMarTech-Charge-CNY 为准。本接口获取结果本身不产生费用。

请求示例

curl

bash

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

Python

python

import requests

url = "https://api.seermartech.cn/v3/ai_optimization/gemini/llm_scraper/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(
        "请求失败，错误码：%s，错误信息：%s"
        % (data.get("status_code"), data.get("status_message"))
    )

TypeScript

typescript

import axios from "axios";

axios
  .get(
    "https://api.seermartech.cn/v3/ai_optimization/gemini/llm_scraper/tasks_ready",
    {
      headers: {
        Authorization: "Bearer smt_live_YOUR_KEY",
        "Content-Type": "application/json",
      },
    }
  )
  .then((response) => {
    const result = response.data;

    if (result.status_code === 20000) {
      console.log(result);
      // 在此处理已完成任务列表
    } else {
      console.error(
        `请求失败，错误码：${result.status_code}，错误信息：${result.status_message}`
      );
    }
  })
  .catch((error) => {
    console.error("网络请求失败：", error.message);
  });

响应字段

顶层字段

字段名	类型	说明
`version`	string	当前 API 版本
`status_code`	integer	请求级状态码
`status_message`	string	请求级提示信息
`time`	string	请求执行耗时，单位为秒
`cost`	float	平台原始 USD 成本兼容字段；人民币实扣以 `X-SeerMarTech-Charge-CNY` 为准。
`tasks_count`	integer	`tasks` 数组中的任务数量
`tasks_error`	integer	`tasks` 数组中返回错误的任务数量
`tasks`	array	已完成任务列表

`tasks` 数组字段

字段名	类型	说明
`id`	string	任务唯一标识，采用 UUID 格式
`status_code`	integer	任务状态码，取值范围为 `10000-60000`
`status_message`	string	任务状态说明
`time`	string	任务执行耗时，单位为秒
`cost`	float	平台原始 USD 成本兼容字段；人民币实扣以 `X-SeerMarTech-Charge-CNY` 为准。
`result_count`	integer	`result` 数组中的结果数量
`path`	array	用于获取任务结果的 URL 路径信息
`data`	object	请求 URL 中传的参数
`result`	array	已完成任务的结果列表

`tasks[].result` 字段

字段名	类型	说明
`id`	string	已完成任务的唯一标识，采用 UUID 格式
`se`	string	创建任务时指定的搜索引擎，本接口通常为 `gemini`
`function`	string	搜索引擎功能名称，例如 `llm_scraper`
`date_posted`	string	任务提交时间，使用 UTC 时间格式
`tag`	string	用户自定义任务标识
`endpoint_advanced`	string / null	获取高级任务结果的 URL；如果当前端点不支持高级任务，则为 `null`
`endpoint_html`	string / null	获取 HTML 任务结果的 URL；如果当前端点不支持 HTML 任务，则为 `null`

响应示例

json

{
  "version": "0.1.20260218",
  "status_code": 20000,
  "status_message": "Ok.",
  "time": "0.1259 sec.",
  "cost": 0,
  "tasks_count": 1,
  "tasks_error": 0,
  "tasks": [
    {
      "id": "11111111-2222-3333-4444-555555555555",
      "status_code": 20000,
      "status_message": "Ok.",
      "time": "0.1250 sec.",
      "cost": 0,
      "result_count": 1,
      "path": [
        "v3",
        "ai_optimization",
        "gemini",
        "llm_scraper",
        "tasks_ready"
      ],
      "data": {
        "api": "ai_optimization",
        "function": "llm_scraper",
        "se": "gemini"
      },
      "result": [
        {
          "id": "11111111-2222-3333-4444-555555555555",
          "se": "gemini",
          "function": "llm_scraper",
          "date_posted": "2026-02-18 08:30:00 +00:00",
          "tag": "seo-batch-001",
          "endpoint_advanced": null,
          "endpoint_html": null
        }
      ]
    }
  ]
}

状态码与异常处理

status_code = 20000 表示请求成功。
顶层 status_code 表示本次接口请求的整体状态。
tasks[].status_code 表示单个任务的处理状态。
建议在系统中同时检查：
- HTTP 响应状态码；
- 顶层 status_code；
- tasks_error；
- 每个任务的 status_code 和 status_message。
对于回调失败、任务过期、结果领取失败等异常，应建立重试、记录和告警机制。

实用场景

轮询获取批量完成任务：定期获取未领取的任务 ID，集中拉取 Gemini 抓取结果，降低任务管理复杂度。
补偿回调失败任务：定时检查因业务服务器异常而未成功回调的任务， SEO 数据丢失。
构建任务结果队列：将返回的任务 ID 写消息队列，异步分发给结果采集服务，提高批处理吞吐量。
监控任务处理状态：根据 tasks_count、tasks_error 和任务状态码统计处理成功率，及时发现异步任务异常。
理过期任务：在三天保留窗口自动领取已完成任务，任务过期后无法获取结果。

获取 Gemini LLM 抓取器已完成任务 ​

接口说明 ​

请求限制 ​

请求示例 ​

curl ​

Python ​

TypeScript ​

响应字段 ​

顶层字段 ​

tasks 数组字段 ​

tasks[].result 字段 ​

响应示例 ​

状态码与异常处理 ​

实用场景 ​