SeerMarTech API 文档

主题

技术摘要（实时） ​

POST /v3/domain_analytics/technologies/technologies_summary/live

接口说明 ​

POST https://api.seermartech.cn/v3/domain_analytics/technologies/technologies_summary/live

技术摘要接口用于统计使用指定技术、技术组或技术分类的网站数量，并按国家、网站语言和语言进行分布。

本接口为实时接口，每次请求只能提交 1 个任务。所有请求体使用 UTF-8 编码的 JSON 格式，并以 JSON 数组传递任务参数。平台限流以认证说明中的 30/60/120 次/分钟规则为准。

计费说明 ​

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

请求参数 ​

请求体格式：

json
[
  {
    "technologies": ["Nginx"],
    "keywords": ["WordPress"],
    "filters": [
      ["country_iso_code", "=", "US"],
      "and",
      ["domain_rank", ">", 800]
    ]
  }
]

任务参数 ​

参数类型说明
technology_pathsarray目标技术路径。当未指定 groups、technologies 和 categories 时填。每个技术路径需使用对象表示， path 和 name：path 格式为 $group_id.$category_id，name 为目标技术名称。最多指定 10 个技术路径。
groupsarray目标技术组 ID。当未指定 technologies、technology_paths、categories 或 keywords 时填。最多指定 10 个技术组。
categoriesarray目标技术分类 ID。当未指定 groups、technology_paths、technologies 或 keywords 时填。最多指定 10 个技术分类。
technologiesarray目标技术名称。当未指定 groups、technology_paths、categories 或 keywords 时填。最多指定 10 个技术名称。
keywordsarray用于匹网站标题、描述或 meta keywords 的目标。当未指定 groups、technology_paths、categories 或 technologies 时填。最多指定 10 个，使用 UTF-8 编码。
modestring搜索模式，可选值：as_is：精确匹指定的技术组 ID、分类 ID 或技术名称；entry：匹指定 ID 或名称的一部分。默认值为 as_is。
filtersarray结果过滤条件，可选。最多设置 8 个过滤条件。多个条件之间使用逻辑运算符 and 或 or 连接。
internal_list_limitinteger限制数组的最大数量，可作用于 countries、languages、content_languages 和 keywords。默认值为 10，最小值为 1，最大值为 10000。
tagstring用户自定义任务标识，最长 255 个字符。可用于标记任务并在响应结果中匹任务。提交的值会原样返回在响应的 data 对象中。

技术组、技术分类及技术名称列表请参考技术目录接口：/v3/domain_analytics/technologies/technologies

technology_paths 参数示例 ​

json
[
  {
    "path": "1.2",
    "name": "Nginx"
  }
]

过滤条件 ​

支持以下字段：

  • domain_rank
  • last_visited
  • country_iso_code
  • language_code
  • content_language_code

支持以下运算符：

<、<=、>、>=、=、<>、in、not_in、like、not_like

使用 like 或 not_like 时，可以使用 % 匹任意长度的字符串空字符串。

示例：

json
"filters": [
  ["country_iso_code", "=", "US"],
  "and",
  ["domain_rank", ">", 800]
]

请求示例 ​

curl ​

bash
curl --location --request POST \
  "https://api.seermartech.cn/v3/domain_analytics/technologies/technologies_summary/live" \
  --header "Authorization: Bearer smt_live_YOUR_KEY" \
  --header "Content-Type: application/json" \
  --data-raw '[
    {
      "technologies": ["Nginx"],
      "keywords": ["WordPress"],
      "filters": [
        ["country_iso_code", "=", "US"],
        "and",
        ["domain_rank", ">", 800]
      ]
    }
  ]'

Python ​

python
import requests

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

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

post_data = [
    {
        "technologies": ["Nginx"],
        "keywords": ["WordPress"],
        "filters": [
            ["country_iso_code", "=", "US"],
            "and",
            ["domain_rank", ">", 800],
        ],
    }
]

response = requests.post(url, headers=headers, json=post_data)
result = response.json()

if result.get("status_code") == 20000:
    print(result)
else:
    print(
        "请求失败。状态码：%s，消息：%s"
        % (result.get("status_code"), result.get("status_message"))
    )

TypeScript ​

typescript
import axios from "axios";

const postData = [
  {
    technologies: ["Nginx"],
    keywords: ["WordPress"],
    filters: [
      ["country_iso_code", "=", "US"],
      "and",
      ["domain_rank", ">", 800],
    ],
  },
];

axios
  .post(
    "https://api.seermartech.cn/v3/domain_analytics/technologies/technologies_summary/live",
    postData,
    {
      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);
  });

响应结构 ​

接口返回 JSON 数据 tasks 数组。

顶层字段 ​

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

任务字段 ​

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

result 字段 ​

字段类型说明
countriesobject按国家统计的网站分布。对象的键为国家代码，值为对应的网站数量。
languagesobject按网站语言统计的分布。对象的键为语言代码，值为对应的网站数量。
content_languagesobject按网页语言统计的分布。对象的键为语言代码，值为对应的网站数量。
keywordsobject按统计的网站分布。来自网站标题、描述或 meta keywords，对象的值为使用该的网站数量。

响应示例 ​

json
{
  "version": "0.1.20220819",
  "status_code": 20000,
  "status_message": "Ok.",
  "time": "1.3292 sec.",
  "cost": 0.01,
  "tasks_count": 1,
  "tasks_error": 0,
  "tasks": [
    {
      "id": "01234567-89ab-cdef-0123-456789abcdef",
      "status_code": 20000,
      "status_message": "Ok.",
      "time": "1.1023 sec.",
      "cost": 0.01,
      "result_count": 1,
      "path": [
        "v3",
        "domain_analytics",
        "technologies",
        "technologies_summary",
        "live"
      ],
      "data": {
        "api": "domain_analytics",
        "function": "technologies_summary",
        "se": "technologies",
        "mode": "entry",
        "technologies": ["Nginx"],
        "keywords": ["WordPress"],
        "filters": [
          ["country_iso_code", "=", "US"],
          "and",
          ["domain_rank", ">", 800]
        ]
      },
      "result": [
        {
          "countries": {
            "US": 12500,
            "GB": 3200
          },
          "languages": {
            "en": 14800,
            "es": 2100
          },
          "content_languages": {
            "en": 13900,
            "es": 1900
          },
          "keywords": {
            "wordpress": 8600,
            "blog": 4200
          }
        }
      ]
    }
  ]
}

状态码与错误处理 ​

请根据响应中的 status_code 和 status_message 判断请求及任务是否成功。建议客户端针对网络异常、请求参数错误、任务执行错误和响应为空等实现对应的重试、告警或降级逻辑。

实用场景 ​

  • 统计使用指定技术栈的网站数量及国家分布，评估不同市场中的技术采用，为 SEO 市场研究和销售区域规划提供依据。
  • 筛选高排名且使用特定技术的网站，构建竞品、潜在客户或外链合作目标名单，提升线索挖掘效率。
  • 对比不同技术组或技术分类的网站语言分布，制定多语言 SEO和本地化运营策略。
  • 分析使用目标技术的网站标题、描述及，识别行业常见主题和搜索意图，研究。
  • 监测特定技术在国家、语言和语言维度上的网站规模变化，为技术趋势分析和竞品监控提供数据支持。

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

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