SeerMarTech API 文档

主题

按技术查询域名（Live） ​

POST /v3/domain_analytics/technologies/domains_by_technology/live

接口说明 ​

该接口用于根据网站所使用的技术栈反查域名列表。除了返回匹的域名外，还会提供对应站点的技术画像、所属国家、语言，以及数据。

  • 请求方式：POST
  • 接口路径：/v3/domain_analytics/technologies/domains_by_technology/live
  • 完整地址：https://api.seermartech.cn/v3/domain_analytics/technologies/domains_by_technology/live

该接口为实时查询接口，每次请求都会产生计费。 扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

请求限制 ​

  • 所有 POST 数据均需使用 JSON（UTF-8 编码）
  • 请求体格式为 JSON 数组：[{ ... }]
  • 每分钟最多可发送 2000 次 API 请求
  • 支持指定返回数量、筛选条件和排序规则

请求参数 ​

至少需要设置以下字段中的一个：

  • technology_paths
  • groups
  • categories
  • technologies
  • keywords

参数说明 ​

字段名类型说明
technology_pathsarray目标技术路径。若未传 groups、technologies、keywords 或 categories，则为填。数组中的每个都是一个对象， path 和 name：path 格式为 $group_id.$category_id，name 为目标技术名称。最多可传 10 个技术路径。技术分组、分类和技术名称单可参考 /v3/domain_analytics/technologies/technologies
groupsarray目标技术分组 ID。若未传 technologies、technology_paths、keywords 或 categories，则为填。最多可传 10 个分组 ID。完整分组 ID单可参考 /v3/domain_analytics/technologies/technologies
categoriesarray目标技术分类 ID。若未传 groups、technology_paths、keywords 或 technologies，则为填。最多可传 10 个分类 ID。完整分类 ID单可参考 /v3/domain_analytics/technologies/technologies
technologiesarray目标技术名称。若未传 groups、technology_paths、keywords 或 categories，则为填。最多可传 10 个技术名称。可用技术列表可参考 /v3/domain_analytics/technologies/technologies
keywordsarray在域名标题、描述或 meta keywords 中匹的目标。若未传 groups、technology_paths、technologies 或 categories，则为填。最多可传 10 个，使用 UTF-8 编码
modestring搜索模式。可选值：as_is（精确匹指定的分组 ID、分类 ID 或技术名称）、entry（匹指定分组 ID、分类 ID 或技术名称的一部分）。默认值：as_is
filtersarray结果过滤条件。可选。最多支持 8 个过滤条件，可通过逻辑运算符 and、or 组合
order_byarray排序规则。可选。最多支持 3 条排序规则
limitinteger返回域名数量上限。默认值：100；最大值：10000
offsetinteger结果偏移量。默认值：0。若设置为 10，则会跳过前 10 个结果。最大值：9999，且 limit + offset 不能 10000。如需获取更多结果，建议使用 offset_token
offset_tokenstring用于后续翻页请求的令牌。响应中会返回该字段。适用于拉取大量结果时时。如果请求中传 offset_token，参数与上一次请求一致

filters 过滤规则 ​

filters 支持以下运算符：

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

说明：

  • 可使用 and、or 连接多个条件
  • like 和 not_like 支持 % 通符，表示匹任意长度字符串
  • 最多可同时传 8 个过滤条件
  • 过滤字段规则可参考 /v3/domain_analytics/technologies/filters

filters 示例 ​

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

order_by 排序规则 ​

可排序字段：

  • domain_rank
  • domain
  • last_visited
  • country_iso_code
  • language_code
  • content_language_code

排序方式：

  • asc：升序
  • desc：降序

格式示例：

json
["last_visited,desc"]

多字段排序示例：

json
["country_iso_code,asc", "domain_rank,desc"]

说明：

  • 单次请求最多设置 3 条排序规则
  • 多个排序规则使用数组传递

请求示例 ​

cURL ​

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

Python ​

python
import requests

url = "https://api.seermartech.cn/v3/domain_analytics/technologies/domains_by_technology/live"
headers = {
 "Authorization": "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json"
}
data = [
 {
 "technologies": ["Nginx"],
 "filters": [
 ["country_iso_code", "=", "US"],
 "and",
 ["domain_rank", ">", 800]
 ],
 "order_by": ["last_visited,desc"],
 "limit": 10
 }
]

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

TypeScript ​

typescript
import axios from "axios";

const postData = [
 {
 technologies: ["Nginx"],
 filters: [
 ["country_iso_code", "=", "US"],
 "and",
 ["domain_rank", ">", 800]
 ],
 order_by: ["last_visited,desc"],
 limit: 10
 }
];

axios({
 method: "post",
 url: "https://api.seermartech.cn/v3/domain_analytics/technologies/domains_by_technology/live",
 headers: {
 Authorization: "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json"
 },
 data: postData
})
 .then((response) => {
 console.log(response.data);
 })
 .catch((error) => {
 console.error(error);
 });

响应结构 ​

接口返回 JSON 编码结果，顶层 tasks 数组。

顶层字段 ​

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

tasks 数组字段 ​

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

result 数组字段 ​

字段名类型说明
total_countinteger数据库中符合条件的总结果数
items_countinteger当前返回的结果条数
offsetinteger当前请求使用的偏移值
offset_tokenstring后续翻页请求令牌
itemsarray结果列表

items 数组字段 ​

字段名类型说明
typestring结果类型，固定为 domain_technology_item
domainstring域名
titlestring域名页面的 meta title
descriptionstring域名页面的 meta description
meta_keywordsarray域名页面的 meta keywords
domain_rankstring目标域名的外链权重排名指标
last_visitedstring爬虫最近访问该域名的时间，UTC 格式：yyyy-mm-dd hh-mm-ss +00:00
country_iso_codestring域名所属国家 ISO 代码
language_codestring域名语言代码
content_language_codestring网站所使用的语言代码
phone_numbersarray目标网站披露的联系电话
emailsarray目标网站披露的邮箱地址
social_graph_urlsarray网站社交图谱中识别到的社交媒体链接或账号
technologiesobject目标域名使用的技术栈对象。技术结构明细可参考 /v3/domain_analytics/technologies/technologies

响应示例 ​

json
{
 "version": "0.1.20220819",
 "status_code": 20000,
 "status_message": "Ok.",
 "time": "1.3918 sec.",
 "cost": 0.018,
 "tasks_count": 1,
 "tasks_error": 0,
 "tasks": [
 {
 "id": "示例任务ID",
 "status_code": 20000,
 "status_message": "Ok.",
 "time": "1.1200 sec.",
 "cost": 0.018,
 "result_count": 1,
 "path": [
 "v3",
 "domain_analytics",
 "technologies",
 "domains_by_technology",
 "live"
 ],
 "data": {
 "api": "domain_analytics",
 "function": "domains_by_technology",
 "se": "technologies",
 "technologies": ["WordPress"],
 "filters": [
 ["country_iso_code", "=", "US"],
 "and",
 ["domain_rank", ">", 800]
 ],
 "order_by": ["last_visited,desc"],
 "limit": 10
 },
 "result": [
 {
 "total_count": 8,
 "items_count": 8,
 "offset": 0,
 "offset_token": "下一页令牌示例",
 "items": [
 {
 "type": "domain_technology_item",
 "domain": "bbpress.org",
 "title": "bbPress.org",
 "description": "Forums, made the WordPress way",
 "meta_keywords": [],
 "domain_rank": 878,
 "last_visited": "2022-09-21 20:13:43 +00:00",
 "country_iso_code": "US",
 "language_code": "en",
 "content_language_code": "en",
 "phone_numbers": null,
 "emails": null,
 "social_graph_urls": null,
 "technologies": {
 "web_development": {
 "javascript_libraries": [],
 "programming_languages": []
 },
 "servers": {
 "web_servers": [],
 "reverse_proxies": [],
 "databases": []
 },
 "content": {
 "cms": [],
 "blogs": []
 }
 }
 },
 {
 "type": "domain_technology_item",
 "domain": "github.blog",
 "title": "The GitHub Blog | Updates, ideas, and inspiration from GitHub to help developers build and design software.",
 "description": "Updates, ideas, and inspiration from GitHub to help developers build and design software.",
 "meta_keywords": null,
 "domain_rank": 931,
 "last_visited": "2022-09-20 18:52:08 +00:00",
 "country_iso_code": "US",
 "language_code": "en",
 "content_language_code": "en",
 "phone_numbers": null,
 "emails": null,
 "social_graph_urls": [],
 "technologies": {
 "content": {
 "cms": [],
 "blogs": []
 },
 "servers": {
 "web_servers": [],
 "reverse_proxies": [],
 "databases": []
 },
 "web_development": {
 "programming_languages": []
 }
 }
 }
 ]
 }
 ]
 }
 ]
}

状态码与错误处理 ​

建议对接口响应中的 status_code 和任务级 tasks[].status_code 进行统一处理，是批量调用或自动化任务中。

可参考错误码文档路径：

  • /v3/appendix/errors

常见处理建议：

  • 顶层 status_code != 20000：表示请求整体失败
  • tasks_error > 0：表示部分任务失败
  • 单个任务 status_code != 20000：表示该任务执行失败
  • 翻页时如果使用 offset_token，务保证余参数与前次请求一致

计费说明 ​

该接口按请求计费。原文未提供固定单价，因此无法给出精确人民币参考价。 扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

如需自行换算，可按以下估算：

  • 人民币参考价以响应头为准

例如：

  • 若响应 cost = 0.018，则参考价约为 ¥0.2880 / 次

使用建议 ​

  1. 优使用 technologies 或 technology_paths 精准定位技术栈，结果过宽
  2. 结合 filters 限定国家、语言或权重，更适合线索挖掘和细分市场分析
  3. 结果量较大时使用 offset_token 翻页，比单纯增大 offset 更稳妥
  4. 排序建议优使用 last_visited,desc，有助于优获取最近被抓取的站点数据

实用场景 ​

  • 挖掘使用特定技术的网站名单：例如筛选使用 WordPress、Nginx、WooCommerce 的站点，用于销售线索挖掘与建站生态研究。
  • 锁定指定国家的技术用户群体：结合 country_iso_code 过滤不同市场中的技术采用，海外 SEO 和区域化拓客。
  • 筛选高权重潜在合作站点：通过 domain_rank 过滤高质量域名，快速建立外链合作、合作或行业资源池。
  • 分析竞品技术覆盖面：基于某类技术或分类批量反查站点，了解行业常用技术方案和竞品建站趋势。
  • 构建垂直 CMS / 电商站点数据库：按 CMS、博客系统、电商插件等技术组合筛选网站，为营销、渠道投放和行业研究提供样本。

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

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