SeerMarTech API 文档

主题

域名分析技术栈汇总（实时） ​

接口说明 ​

/v3/domain_analytics/technologies/technologies_summary/live 用于统计使用指定技术、技术分组、技术分类，或命中指定的网站分布。

返回结果会按以下维度汇总网站数量：

  • 国家分布 countries
  • 网站语言分布 languages -语言分布 content_languages
  • 分布 keywords

该接口适合用于技术市场覆盖分析、区域技术渗透评估、按语言划分的建站技术研究等场景。

请求方式：

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

计费说明：

每次请求都会计费。参考价请以游返回为准，扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

请求格式：

  • 请求体为 UTF-8 编码的 JSON
  • POST 请求体为 JSON 数组：[{ ... }]
  • 每分钟最多可发送 2000 次请求

请求参数 ​

顶层请求体示例 ​

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 个。技术组 ID、分类 ID 和技术名称列表可参考 /v3/domain_analytics/technologies/technologies
groupsarray目标技术组 ID。若未传 technologies、technology_paths、categories、keywords，则该字段填。最多可传 10 个。技术组 ID 列表可参考 /v3/domain_analytics/technologies/technologies
categoriesarray目标技术分类 ID。若未传 groups、technology_paths、technologies、keywords，则该字段填。最多可传 10 个。技术分类 ID 列表可参考 /v3/domain_analytics/technologies/technologies
technologiesarray目标技术名称。若未传 groups、technology_paths、categories、keywords，则该字段填。最多可传 10 个。可用技术名称列表可参考 /v3/domain_analytics/technologies/technologies
keywordsarray在域名标题、描述或 meta keywords 中匹的。若未传 groups、technology_paths、categories、technologies，则该字段填。最多可传 10 个；使用 UTF-8 编码
modestring搜索模式，可选。支持：as_is（精确匹指定技术组 ID、分类 ID 或技术名称）、entry（按部分匹检索）。默认值：as_is
filtersarray结果过滤条件，可选。最多支持 8 个过滤条件，并可使用 and / or 连接
internal_list_limitinteger限制数组返回的最大数。适用于 countries、languages、content_languages、keywords。默认 10，最小 1，最大 10000
tagstring自定义任务标识，可选，最大长度 255。便于请求与结果对应，返回时会出现在响应 data 对象中

technology_paths 说明 ​

technology_paths 中每个都应为一个独立对象，例如：

json
[
 {
 "technology_paths": [
 {
 "path": "1.3",
 "name": "Nginx"
 }
 ]
 }
]

说明：

  • path：技术路径，格式为 $group_id.$category_id
  • name：技术名称
  • 最多支持 10 个技术路径对象

filters 过滤规则 ​

filters 支持同时添加多个条件，最多 8 个，条件之间使用逻辑运算符连接。

支持的运算符 ​

  • <
  • <=
  • >
  • >=
  • =
  • <>
  • in
  • not_in
  • like
  • not_like

like / not_like 通规则 ​

可合 % 使用，表示匹任意长度字符串（空字符串）。

可过滤字段 ​

  • domain_rank
  • last_visited
  • country_iso_code
  • language_code
  • content_language_code

过滤示例 ​

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

更多过滤语法可参考 /v3/domain_analytics/technologies/filters。

响应结构 ​

接口返回 JSON 数据，顶层 tasks 数组。

顶层响应字段 ​

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

tasks[] 字段 ​

字段名类型说明
idstring任务唯一标识，UUID 格式
status_codeinteger任务状态码，范围通常为 10000-60000，完整列表参考 /v3/appendix/errors
status_messagestring任务状态信息
timestring任务耗时，单位秒
costfloat该任务费用
result_countintegerresult 数组中的结果数
patharray请求路径
dataobject回显请求参数
resultarray结果数组

result[] 字段 ​

字段名类型说明
countriesobject按国家统计的网站分布，键为国家代码，值为网站数量
languagesobject按网站语言统计的网站分布，键为语言代码，值为网站数量
content_languagesobject按语言统计的网站分布，键为语言代码，值为网站数量
keywordsobject网站标题、描述或 meta keywords 中命中的分布，键为，值为网站数量

请求示例 ​

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"
}
payload = [
 {
 "technologies": ["Nginx"],
 "keywords": ["WordPress"],
 "filters": [
 ["country_iso_code", "=", "US"],
 "and",
 ["domain_rank", ">", 800]
 ]
 }
]

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

TypeScript ​

typescript
import axios from "axios";

const payload = [
 {
 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",
 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
{
 "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": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
 "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": 1234,
 "CA": 210
 },
 "languages": {
 "en": 1300
 },
 "content_languages": {
 "en": 1288
 },
 "keywords": {
 "WordPress": 980
 }
 }
 ]
 }
 ]
}

状态码与错误处理 ​

建议对接口状态码和任务状态码分别做处理。

需要重点的字段 ​

  • 顶层 status_code：表示整个请求是否成功
  • tasks[].status_code：表示单个任务是否成功
  • tasks_error：表示失败任务数

错误处理建议 ​

  • 若顶层 status_code 非 20000，优按请求级错误处理
  • 若顶层成功但 tasks[].status_code 非成功状态，应按任务级失败处理
  • 建议接 /v3/appendix/errors 中的错误码映射表，统一记录和告警

使用建议 ​

  1. 当你明确知道技术名称时，优使用 technologies
  2. 当你需要按技术组或分类做更粗粒度统计时，使用 groups 或 categories
  3. 当你希望结合站点标题、描述、meta keywords 做补筛选时，使用 keywords
  4. 若需要压缩返回体积，可通过 internal_list_limit 限制统计项数量
  5. 若目标是模糊匹技术名称或分类，可将 mode 设置为 entry

实用场景 ​

  • 评估技术渗透率：按国家和语言统计某项技术的站点覆盖规模，帮助判断技术生态成熟度与区域市场机会
  • 筛选目标市场：结合 country_iso_code、language_code 等过滤条件，定位特定国家或语种中使用某类技术的网站群体
  • 分析竞品技术版图：围绕 CMS、Web 服务器、分析等技术名称做汇总，识别竞品集中采用的技术组合
  • 挖掘型客户线索：结合 keywords 检索网站标题、描述和 meta keywords，找到同时备特定主题和技术特征的潜在客户
  • 制定本地化 SEO 策略：根据 content_languages 和 languages 分布，识别某项技术在不同语言市场中的采用，与投放规划

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

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