SeerMarTech API 文档

主题

技术统计（实时） ​

POST /v3/domain_analytics/technologies/technology_stats/live

本接口使用 POST 方法，路径为：

/v3/domain_analytics/technologies/technology_stats/live

用于查询指定技术在不同国家和语言中的网站域名数量历史数据。历史数据最早可追溯至 2022-10-31。

每次请求只能提交一个任务。平台限流以认证说明中的 30/60/120 次/分钟规则为准。

计费说明 ​

每次请求均会产生费用。扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

请求格式 ​

请求体使用 UTF-8 编码的 JSON 数组：

json
[
  {
    "technology": "jQuery",
    "date_from": "2022-10-31",
    "date_to": "2023-06-01"
  }
]

请求头：

http
Authorization: Bearer smt_live_YOUR_KEY
Content-Type: application/json

请求参数 ​

参数类型填说明
technologystring是目标技术名称。可使用技术列表中的名称，例如 Salesforce、jQuery。
date_fromstring否查询时间范围的起始日期。最早支持 2022-10-31。未指定时默认使用最早可用日期。格式为 yyyy-mm-dd。
date_tostring否查询时间范围的结束日期。未指定时默认使用当天日期。格式为 yyyy-mm-dd。
tagstring否用户自定义的任务标识，用于匹请求与响应结果。最多 255 个字符。指定后，会在响应任务的 data 对象中原样返回。

请求参数示例 ​

json
[
  {
    "technology": "Salesforce",
    "date_from": "2023-06-01",
    "date_to": "2023-06-30",
    "tag": "salesforce-monthly-report"
  }
]

请求示例 ​

cURL ​

bash
curl --location --request POST \
  "https://api.seermartech.cn/v3/domain_analytics/technologies/technology_stats/live" \
  --header "Authorization: Bearer smt_live_YOUR_KEY" \
  --header "Content-Type: application/json" \
  --data-raw '[
    {
      "technology": "jQuery",
      "date_from": "2022-10-31",
      "date_to": "2023-06-01"
    }
  ]'

Python ​

python
import requests

url = "https://api.seermartech.cn/v3/domain_analytics/technologies/technology_stats/live"

headers = {
    "Authorization": "Bearer smt_live_YOUR_KEY",
    "Content-Type": "application/json",
}

payload = [
    {
        "technology": "jQuery",
        "date_from": "2022-10-31",
        "date_to": "2023-06-01",
    }
]

response = requests.post(url, headers=headers, json=payload, timeout=60)
result = response.json()

if result.get("status_code") == 20000:
    print(result)
else:
    print(
        "请求失败，错误码：{}，错误信息：{}".format(
            result.get("status_code"),
            result.get("status_message"),
        )
    )

TypeScript ​

typescript
import axios from "axios";

const response = await axios.post(
  "https://api.seermartech.cn/v3/domain_analytics/technologies/technology_stats/live",
  [
    {
      technology: "jQuery",
      date_from: "2022-10-31",
      date_to: "2023-06-01",
    },
  ],
  {
    headers: {
      Authorization: "Bearer smt_live_YOUR_KEY",
      "Content-Type": "application/json",
    },
  }
);

const result = response.data;

if (result.status_code === 20000) {
  console.log(result);
} else {
  console.error(
    `请求失败，错误码：${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技术统计结果数组。

data 对象 ​

data 对象会本次请求中提交的参数，例如：

json
{
  "api": "domain_analytics",
  "function": "technology_stats",
  "se": "technologies",
  "technology": "jQuery",
  "date_from": "2022-10-31",
  "date_to": "2023-06-01"
}

result 结果字段 ​

字段类型说明
technologystring目标技术名称。
date_fromstring查询时间范围的起始日期。
date_tostring查询时间范围的结束日期。
items_countobject结果项数量信息。
typestring结果项类型，固定为 technology_stats_item。
datestring当前统计数据对应的日期。
domains_countinteger使用指定技术的域名数量。
countriesobject按国家或地区分布的网站数量。对象中的键为国家或地区代码，值为对应网站数量。
languagesobject按语言分布的网站数量。对象中的键为语言代码，值为对应网站数量。
domains_rankobject按反向链接排名区间分布的网站数量。对象中的键为域名排名区间，值为对应网站数量。

结果示例 ​

json
{
  "version": "0.1.20221214",
  "status_code": 20000,
  "status_message": "Ok.",
  "time": "0.1010 sec.",
  "cost": 0.018,
  "tasks_count": 1,
  "tasks_error": 0,
  "tasks": [
    {
      "id": " ಕಾರ್ಯ-task-uuid",
      "status_code": 20000,
      "status_message": "Ok.",
      "time": "0.0950 sec.",
      "cost": 0.018,
      "result_count": 1,
      "path": [
        "v3",
        "domain_analytics",
        "technologies",
        "technology_stats",
        "live"
      ],
      "data": {
        "api": "domain_analytics",
        "function": "technology_stats",
        "se": "technologies",
        "technology": "jQuery",
        "date_from": "2022-10-31",
        "date_to": "2023-06-01"
      },
      "result": [
        {
          "technology": "jQuery",
          "date_from": "2022-10-31",
          "date_to": "2023-06-01",
          "items_count": {
            "countries": 3,
            "languages": 3,
            "domains_rank": 4
          },
          "type": "technology_stats_item",
          "date": "2023-06-01",
          "domains_count": 125000,
          "countries": {
            "US": 42000,
            "GB": 18000,
            "DE": 12000
          },
          "languages": {
            "en": 65000,
            "de": 12000,
            "fr": 9000
          },
          "domains_rank": {
            "0-10": 500,
            "11-30": 3200,
            "31-100": 18500,
            "101-1000": 46000
          }
        }
      ]
    }
  ]
}

> id 示例中的 UUID 用于展示格式，响应会返回真实任务标识。

错误处理 ​

建议同时检查以下状态字段：

  • 顶层 status_code 和 status_message
  • tasks[].status_code 和 tasks[].status_message
  • tasks_error 是否大于 0

当任务级状态码不是 20000 时，应根据返回的状态信息记录日志、重试或修正请求参数。

实用场景 ​

  • 跟踪技术采用趋势：按日期统计某项技术所覆盖的域名数量，评估技术市场渗透率和增长变化。
  • 对比不同国家的技术使用：分析目标技术在各国家或地区的网站分布，为化 SEO 和区域市场策略提供依据。
  • 评估语言市场机会：根据语言维度识别技术覆盖较高或较低的市场，制定多语言 SEO 优级。
  • 结合域名排名筛选高价值网站：通过 domains_rank 观察不同反向链接排名区间中的域名数量，评估技术生态中的高权重网站规模。
  • 生成技术市场监控报表：利用 tag 标识不同监控任务，定期保存并对比技术、国家、语言及排名区间的历史变化。

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

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