SeerMarTech API 文档

主题

Domain Analytics 任务 ID 列表 ​

POST /v3/domain_analytics/id_list

接口说明 ​

/v3/domain_analytics/id_list 用于获取指定时间范围创建的 Domain Analytics 任务 ID 及数据，返回结果同时成功完成和未完成的任务。

注意事项：

  • 时间筛选范围最多可追溯到调用时间之前 6 个月
  • 当任务创建时间在最近 1 个月时，才可返回 metadata
  • 单次请求最多返回 1000 个任务 ID
  • 调用频率上限为 10 次/分钟

计费说明 ​

本接口不收费。 扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

请求方式 ​

POST https://api.seermartech.cn/v3/domain_analytics/id_list

请求体为 UTF-8 编码的 JSON，且 POST 数据格式为数组：

json
[
 {
 "datetime_from": "2023-01-31 00:00:00 +02:00",
 "datetime_to": "2023-02-01 00:00:00 +02:00",
 "limit": 100,
 "offset": 0,
 "sort": "desc",
 "include_metadata": true
 }
]

请求参数 ​

字段名类型说明
datetime_fromstring结果筛选的开始时间。填。当 include_metadata=true 时，最早只能查询当前时间前 1 个月；当 include_metadata=false 时，最早可查询当前时间前 6 个月。使用 UTC 时间格式：yyyy-mm-dd hh-mm-ss +00:00。示例：2023-01-15 12:57:46 +00:00
datetime_tostring结果筛选的结束时间。填。最大值为当前时间。使用 UTC 时间格式：yyyy-mm-dd hh-mm-ss +00:00。示例：2023-01-31 13:57:46 +00:00
limitinteger返回任务 ID 的最大数量。可选，默认 1000，最大 1000
offsetinteger返回结果中的偏移量。可选，默认 0。例如设置为 10 时，将跳过前 10 条任务记录
sortstring按任务执行时间排序。可选。取值："asc"、"desc"，默认 "asc"
include_metadataboolean是否在响应中附带任务数据。可选，默认 false

响应结构 ​

接口返回 JSON 编码数据，核心位于 tasks 数组中。

顶层字段 ​

字段名类型说明
versionstring当前 API 版本
status_codeinteger通用状态码，完整列表参考 /v3/appendix/errors
status_messagestring通用状态信息，完整列表参考 /v3/appendix/errors
timestring总执行时间，单位秒
costfloat本次请求总费用，单位 USD
tasks_countintegertasks 数组中的任务数量
tasks_errorintegertasks 数组中返回错误的任务数量
tasksarray任务数组

tasks[] 字段 ​

字段名类型说明
idstring任务唯一标识，UUID 格式
status_codeinteger任务状态码，范围通常为 10000-60000，完整列表参考 /v3/appendix-errors/
status_messagestring任务状态说明，完整列表参考 /v3/appendix-errors/
timestring任务执行时间，单位秒
costfloat该任务费用，单位 USD
result_countintegerresult 数组中的数量
patharray请求 URL 路径
dataobject与请求中提交参数一致的数据对象
resultarray结果列表

tasks[].result[] 字段 ​

字段名类型说明
idstring任务 ID
urlstring任务对应的请求 URL
datetime_postedstring任务创建时间，UTC 格式：yyyy-mm-dd hh-mm-ss +00:00
datetime_donestring任务完成时间，UTC 格式：yyyy-mm-dd hh-mm-ss +00:00
statusstring任务状态信息，完整列表参考 /v3/appendix-errors/
costfloat该任务费用，单位 USD
metadataobject任务创建时提交的参数；在满足时间范围且 include_metadata=true 时返回

请求示例 ​

cURL ​

bash
curl --location --request POST "https://api.seermartech.cn/v3/domain_analytics/id_list" \
 --header "Authorization: Bearer smt_live_YOUR_KEY" \
 --header "Content-Type: application/json" \
 --data-raw '[
 {
 "datetime_from": "2023-01-31 00:00:00 +02:00",
 "datetime_to": "2023-02-01 00:00:00 +02:00",
 "limit": 100,
 "offset": 0,
 "sort": "desc",
 "include_metadata": true
 }
 ]'

Python ​

python
import requests

url = "https://api.seermartech.cn/v3/domain_analytics/id_list"
headers = {
 "Authorization": "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json"
}

payload = [
 {
 "datetime_from": "2023-01-31 00:00:00 +02:00",
 "datetime_to": "2023-02-01 00:00:00 +02:00",
 "limit": 100,
 "offset": 0,
 "sort": "desc",
 "include_metadata": True
 }
]

response = requests.post(url, headers=headers, json=payload)
print(response.json)

TypeScript ​

typescript
import axios from "axios";

const payload = [
 {
 datetime_from: "2023-01-31 00:00:00 +02:00",
 datetime_to: "2023-02-01 00:00:00 +02:00",
 limit: 100,
 offset: 0,
 sort: "desc",
 include_metadata: true
 }
];

axios({
 method: "post",
 url: "https://api.seermartech.cn/v3/domain_analytics/id_list",
 headers: {
 Authorization: "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json"
 },
 data: payload
})
 .then((response) => {
 // 输出接口返回结果
 console.log(response.data);
 })
 .catch((error) => {
 console.error(error);
 });

响应示例 ​

json
{
 "version": "0.1.20221214",
 "status_code": 20000,
 "status_message": "Ok.",
 "time": "0.3204 sec.",
 "cost": 0,
 "tasks_count": 1,
 "tasks_error": 0,
 "tasks": [
 {
 "data": {
 "api": "domain_analytics",
 "function": "id_list",
 "datetime_from": "2023-01-11 00:00:00 +02:00",
 "datetime_to": "2023-02-10 18:23:00 +02:00",
 "limit": 100,
 "sort": "desc",
 "include_metadata": true
 },
 "result": [
 {
 "id": "01241736-1535-0481-0000-bd2af6b0b070",
 "url": "v3/domain_analytics/whois/overview/live",
 "datetime_posted": "2023-01-24 15:36:43 +00:00",
 "datetime_done": "2023-01-24 15:36:43 +00:00",
 "status": "20000",
 "cost": 0.11,
 "metadata": {
 "api": "domain_analytics",
 "function": "overview",
 "se": "whois",
 "limit": 10,
 "filters": []
 }
 },
 {
 "id": "01201144-1535-0511-0000-87ccd68ca432",
 "url": "v3/domain_analytics/technologies/domains_by_html_terms/live",
 "datetime_posted": "2023-01-20 09:44:47 +00:00",
 "datetime_done": "2023-01-20 09:44:47 +00:00",
 "status": "20000",
 "cost": 0.11,
 "metadata": {
 "api": "domain_analytics",
 "function": "domains_by_html_terms",
 "se": "technologies",
 "search_terms": [],
 "keywords": [],
 "mode": "strict_entry",
 "order_by": [],
 "offset": 0,
 "limit": 100
 }
 },
 {
 "id": "01201141-1535-0511-0000-017f87115e45",
 "url": "v3/domain_analytics/technologies/domains_by_html_terms/live",
 "datetime_posted": "2023-01-20 09:41:11 +00:00",
 "datetime_done": "2023-01-20 09:41:11 +00:00",
 "status": "20000",
 "cost": 0.015,
 "metadata": {
 "api": "domain_analytics",
 "function": "domains_by_html_terms",
 "se": "technologies",
 "search_terms": [],
 "keywords": [],
 "mode": "entry",
 "offset": 0,
 "limit": 100
 }
 }
 ]
 }
 ]
}

状态码说明 ​

  • 顶层 status_code=20000 表示请求成功
  • 单个任务下的 status_code 用于表示该任务执行状态
  • 详细错误码与状态说明请参考 /v3/appendix/errors 与 /v3/appendix-errors/

使用建议 ​

  • 若只需要任务 ID 列表，建议将 include_metadata 设为 false，可查询最近 6 个月的数据
  • 若需要查看任务创建时的原始参数，设置 include_metadata=true，但查询时间范围需限制在最近 1 个月
  • 当返回数量可能 1000 条时，请结合 limit 与 offset 分页获取
  • 建议按 datetime_posted 或任务完成时间维度分批拉取，便于做任务审计与结果回溯

实用场景 ​

  • 回溯任务执行记录：按时间段批量拉取 Domain Analytics 任务 ID，便于排查历史跑数和结果缺失问题
  • 审计接口调用行为：结合 metadata 查看历史任务的提交参数，快速确认是谁、在何时、以什么条件发起了查询
  • 补拉失败或未完成任务：筛选未完成或异常状态任务，支持后续重试、补偿和自动化修复流程
  • 统计任务消耗成本：汇总返回结果中的 cost 字段，评估不同分析类型的使用量和预算分布
  • 构建任务索引：将任务 ID、URL、提交时间和数据同步到数据库，用于报表、对账和运营查询

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

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