SeerMarTech API 文档

主题

聚合技术分析（实时） ​

POST /v3/domain_analytics/technologies/aggregation_technologies/live

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

/v3/domain_analytics/technologies/aggregation_technologies/live

聚合技术接口用于分析网站技术栈之间的。指定某项技术、技术分类、技术组或域名后，接口会返回与出现的热门技术及统计数据。

每次请求最多提交 1 个任务；平台限流以认证说明中的 30/60/120 次/分钟规则为准。所有 POST 请求体使用 UTF-8 编码的 JSON 数组格式。

计费说明 ​

本接口按请求计费。扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

请求参数 ​

请求体中的每个任务对象支持以下字段：

字段类型说明
groupstring目标技术组 ID。未指定 technology、category 或 keyword 时填。示例："marketing"
categorystring目标技术分类 ID。未指定 group、keyword 或 technology 时填。示例："crm"
technologystring目标技术名称。未指定 group、category 或 keyword 时填。示例："Salesforce"
keywordstring域名中的目标。未指定 group、category 或 technology 时填，使用 UTF-8 编码。示例："seo"
modestring搜索模式，可选值：as_is：精确匹指定的技术组、分类或技术名称；entry：匹指定值的一部分。默认值：as_is
filtersarray结果过滤条件，最多支持 8 个过滤条件。详见技术分析过滤器参考文档。
order_byarray结果排序规则。可排序字段：groups_count、categories_count、technologies_count。排序方向为 asc 或 desc，格式为 "字段,方向"。最多设置 3 条排序规则。
internal_groups_list_limitinteger同一 group 下最多返回的技术组项数量。默认值：5，取值范围：1-10000。
internal_categories_list_limitinteger同一技术组下最多返回的技术分类数量。默认值：5，取值范围：1-10000。
internal_technologies_list_limitinteger同一技术分类下最多返回的技术数量。默认值：10，取值范围：1-10000。
internal_list_limitinteger对相同 category、group 和 technology 组合设置统一的返回数量上限。指定此字段后，将忽略 internal_groups_list_limit、internal_categories_list_limit 和 internal_technologies_list_limit。默认值：10，取值范围：1-10000。
limitinteger最多返回的技术数量。默认值：100，最大值：10000。
offsetinteger结果偏移量。默认值：0，最大值：9999。例如设置为 10，将跳过前 10 条结果。
tagstring用户自定义任务标识，最多 255 个字符。该值会原样返回在响应的 data 对象中。

group、category、technology、keyword 至少指定一个。

技术组、分类和技术 ID ​

完整的技术组、技术分类及技术名称列表，请参考：

/v3/domain_analytics/technologies/technologies

过滤器格式 ​

过滤器由条件数组和逻辑运算符组成，支持以下运算符：

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

like 和 not_like 支持使用 % 匹零个或多个字符。

可用于过滤的字段：

  • domain_rank
  • last_visited
  • country_iso_code
  • language_code
  • content_language_code

示例：

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

请求示例 ​

cURL ​

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

Python ​

python
import requests

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

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

# 每次实时请求只能提交一个任务
payload = [
    {
        "technology": "Nginx",
        "keyword": "WordPress",
        "filters": [
            ["country_iso_code", "=", "US"],
            "and",
            ["domain_rank", ">", 800],
        ],
        "order_by": ["groups_count,desc"],
        "limit": 10,
    }
]

response = requests.post(url, headers=headers, json=payload)
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 payload = [
  {
    technology: "Nginx",
    keyword: "WordPress",
    filters: [
      ["country_iso_code", "=", "US"],
      "and",
      ["domain_rank", ">", 800],
    ],
    order_by: ["groups_count,desc"],
    limit: 10,
  },
];

axios
  .post(
    "https://api.seermartech.cn/v3/domain_analytics/technologies/aggregation_technologies/live",
    payload,
    {
      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请求 URL 路径
dataobject请求中提交的任务参数
resultarray任务结果数组

result 字段 ​

字段类型说明
total_countinteger数据库中与请求条件匹的结果总数
items_countintegeritems 数组中返回的结果数量
itemsarray聚合技术结果列表

items素字段 ​

字段类型说明
typeobject结果类型，值为 aggregation_technologies_item
groupstring技术组 ID
categorystring技术分类 ID
technologystring技术名称
groups_countinteger满足请求条件且使用指定技术组中技术的网站数量
categories_countinteger满足请求条件且使用指定技术分类中技术的网站数量
technologies_countinteger满足请求条件且使用指定技术的网站数量

响应示例 ​

json
{
  "version": "0.1.20220926",
  "status_code": 20000,
  "status_message": "Ok.",
  "time": "0.2280 sec.",
  "cost": 0,
  "tasks_count": 1,
  "tasks_error": 0,
  "tasks": [
    {
      "id": "01234567-89ab-cdef-0123-456789abcdef",
      "status_code": 20000,
      "status_message": "Ok.",
      "time": "0.2100 sec.",
      "cost": 0,
      "result_count": 1,
      "path": [
        "v3",
        "domain_analytics",
        "technologies",
        "aggregation_technologies",
        "live"
      ],
      "data": {
        "api": "domain_analytics",
        "function": "aggregation_technologies",
        "se": "technologies",
        "technology": "Nginx",
        "keyword": "WordPress",
        "filters": [
          ["country_iso_code", "=", "US"],
          "and",
          ["domain_rank", ">", 800]
        ],
        "order_by": [
          "groups_count,desc"
        ],
        "limit": 10
      },
      "result": [
        {
          "total_count": 1,
          "items_count": 1,
          "items": [
            {
              "type": "aggregation_technologies_item",
              "group": "web_servers",
              "category": "web_server",
              "technology": "Apache",
              "groups_count": 1250,
              "categories_count": 980,
              "technologies_count": 760
            }
          ]
        }
      ]
    }
  ]
}

错误处理 ​

建议根据顶层和任务级别的 status_code、status_message 判断请求是否成功，并对网络异常、参数错误、任务执行失败及服务端错误进行重试或记录。

完整状态码列表请参考错误码文档。

实用场景 ​

  • 分析竞品技术栈组合：查询竞品所使用的服务器、营销或 CRM 技术，识别常见技术组合，为技术选型和竞品研究提供依据。
  • 挖掘技术现：围绕 Nginx、WordPress 或 Salesforce 等目标技术，发现网站中高频使用的技术，构建技术生态图谱。
  • 筛选特定市场的网站样本：结合国家、语言和域名排名过滤条件，分析目标市场中的主流技术采用，为区域化 SEO 和市场策略提供数据支持。
  • 评估技术市场渗透率：通过 groups_count、categories_count 和 technologies_count 统计不同技术的覆盖规模，支持 SaaS、营销或建站平台的市场研究。
  • 构建技术潜客名单：根据目标技术和域名排名筛选潜在客户群体，为销售拓客、精准广告和技术迁移服务提供线索。

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

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