SeerMarTech API 文档

主题

keywords_data/bing/tasks_ready ​

获取已完成任务列表（V2） ​

本接口用于获取尚未领取结果的已完成任务列表。

请求方法与路径：

http
GET /v3/keywords_data/bing/v2/tasks_ready

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

> 注意：已完成任务队列可能存在短暂更新延迟。若系统每分钟需要领取 1000 个任务，建议优使用回调（pingback/postback）机制；本接口可用于补获取回调失败的任务 ID。

计费与调用限制 ​

  • 调用本接口获取任务列表不产生费用。
  • 每个已完成任务会持续保留在列表中，直到被领取。
  • 每分钟最多调用 20 次。
  • 每次调用最多返回过去 3 天完成的 1000 个任务。
  • 已领取的任务不会再次出现在列表中。
  • 任务完成后 3 天仍未领取的任务，将从列表中移除。
  • 如果提交任务时指定了 postback_url，任务通常不会出现在本列表中。
  • 当平台向您的服务器发送回调失败，且服务器返回的 HTTP 状态码小于 200 或大于 300 时，该任务才可能出现在本列表中。
  • 本接口本身不扣费；如需核对请求费用，请以响应头 X-SeerMarTech-Charge-CNY 为准。

请求示例 ​

cURL ​

bash
curl --location --request GET \
  "https://api.seermartech.cn/v3/keywords_data/bing/v2/tasks_ready" \
  --header "Authorization: Bearer smt_live_YOUR_KEY" \
  --header "Content-Type: application/json"

PHP ​

php
<?php
require('RestClient.php');

$api_url = 'https://api.seermartech.cn/';

try {
    // 使用本平台 API 密钥进行认证
    $client = new RestClient(
        $api_url,
        null,
        'smt_live_YOUR_KEY',
        ''
    );
} catch (RestClientException $e) {
    echo "\n";
    print "HTTP 状态码: {$e->getHttpCode()}\n";
    print "错误码: {$e->getCode()}\n";
    print "错误信息: {$e->getMessage()}\n";
    exit();
}

try {
    // 获取已完成任务列表
    // GET /v3/keywords_data/bing/v2/tasks_ready
    $result = $client->get('/v3/keywords_data/bing/v2/tasks_ready');
    print_r($result);
} catch (RestClientException $e) {
    echo "\n";
    print "HTTP 状态码: {$e->getHttpCode()}\n";
    print "错误码: {$e->getCode()}\n";
    print "错误信息: {$e->getMessage()}\n";
}

TypeScript / Axios ​

typescript
import axios from 'axios';

axios({
  method: 'get',
  url: 'https://api.seermartech.cn/v3/keywords_data/bing/v2/tasks_ready',
  headers: {
    'Authorization': 'Bearer smt_live_YOUR_KEY',
    'Content-Type': 'application/json'
  }
})
  .then((response) => {
    // 处理接口返回结果
    console.log(response.data);
  })
  .catch((error) => {
    console.error(error.response?.data || error.message);
  });

Python ​

python
from client import RestClient

client = RestClient("smt_live_YOUR_KEY", "")

# 获取已完成任务列表
# GET /v3/keywords_data/bing/v2/tasks_ready
response = client.get("/v3/keywords_data/bing/v2/tasks_ready")

# status_code 为 20000 表示请求成功
if response["status_code"] == 20000:
    print(response)
else:
    print(
        "错误。代码: %s，信息: %s"
        % (response["status_code"], response["status_message"])
    )

C# ​

csharp
using Newtonsoft.Json;
using System;
using System.Net.Http;
using System.Net.Http.Headers;
using System.Threading.Tasks;

namespace SeerMarTechDemos
{
    public static partial class Demos
    {
        public static async Task KeywordsDataTasksReady()
        {
            var httpClient = new HttpClient
            {
                BaseAddress = new Uri("https://api.seermartech.cn/"),
                DefaultRequestHeaders =
                {
                    Authorization = new AuthenticationHeaderValue(
                        "Bearer",
                        "smt_live_YOUR_KEY"
                    )
                }
            };

            // 获取已完成任务列表
            // GET /v3/keywords_data/bing/v2/tasks_ready
            var response = await httpClient.GetAsync(
                "/v3/keywords_data/bing/v2/tasks_ready"
            );

            var result = JsonConvert.DeserializeObject<dynamic>(
                await response.Content.ReadAsStringAsync()
            );

            if (result.status_code == 20000)
            {
                Console.WriteLine(result);
            }
            else
            {
                Console.WriteLine(
                    $"错误。代码: {result.status_code}，信息: {result.status_message}"
                );
            }
        }
    }
}

响应结构 ​

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

顶层字段 ​

字段类型说明
versionstring当前 API 版本
status_codeinteger请求级状态码。20000 表示成功；完整错误码请参考错误码文档
status_messagestring请求级提示信息
timestring接口执行耗时，单位为秒
costfloat平台原始 USD 成本兼容字段；人民币实扣以 X-SeerMarTech-Charge-CNY 为准。
tasks_countintegertasks 数组中的任务数量
tasks_errorintegertasks 数组中返回错误的任务数量
tasksarray任务信息数组

tasks 数组字段 ​

字段类型说明
idstring任务唯一标识，UUID 格式
status_codeinteger任务状态码，取值范围通常为 10000 至 60000
status_messagestring任务状态说明
timestring任务执行耗时，单位为秒
costfloat平台原始 USD 成本兼容字段；人民币实扣以 X-SeerMarTech-Charge-CNY 为准。
result_countintegerresult 数组中的数量
patharray用于获取任务结果的 URL 路径
dataobject请求路径中传的参数
resultarray已完成任务结果数组

result 数组字段 ​

字段类型说明
idstring已完成任务的唯一标识，UUID 格式
sestring创建任务时指定的搜索引擎，本接口通常为 bing
functionstring任务类型
date_postedstring任务提交时间，使用 UTC 格式
endpointstring用于领取任务结果的接口路径

响应示例 ​

json
{
  "version": "3.20191128",
  "status_code": 20000,
  "status_message": "Ok.",
  "time": "0.1927 sec.",
  "cost": 0,
  "tasks_count": 1,
  "tasks_error": 0,
  "tasks": [
    {
      "id": "01234567-89ab-cdef-0123-456789abcdef",
      "status_code": 20000,
      "status_message": "Ok.",
      "time": "0.0012 sec.",
      "cost": 0,
      "result_count": 1,
      "path": [
        "v3",
        "keywords_data",
        "bing",
        "v2",
        "tasks_ready"
      ],
      "data": {
        "api": "keywords_data",
        "function": "v2",
        "se": "bing"
      },
      "result": [
        {
          "id": "01234567-89ab-cdef-0123-456789abcdef",
          "se": "bing",
          "function": "v2",
          "date_posted": "2024-01-01 12:00:00 +00:00",
          "endpoint": "/v3/keywords_data/bing/v2/task_get/01234567-89ab-cdef-0123-456789abcdef"
        }
      ]
    }
  ]
}

获取到任务 ID 后，可根据返回的 endpoint 调用对应的任务结果接口，领取数据。

实用场景 ​

  • 轮询已完成任务：定时获取 Bing 任务的完成状态，及时触发结果领取流程，减少人工检查。
  • 补偿回调失败任务：筛选未成功推送到业务服务器的任务 ID，数据丢失。
  • 构建任务调度队列：将已完成任务消费队列，实现任务提交、结果领取和后续分析的解耦。
  • 监控批量处理进度：统计 tasks_count、tasks_error 和任务状态码，定位批量 SEO 数据采集中的异常。
  • 控制高频任务领取策略：结合每分钟 20 次的调用限制设计轮询间隔，降低接口限流风险。

统一入口：官网 · LLM API · 控制台

© 2026 SeerMarTech · GEO · SEO 营销数据 API