微步在线云API
我的API

子域名查询

域名高级查询，获取域名子域名信息。

调用脚本
Run In Postman
请求方法
请求地址： https://api.threatbook.cn/v3/domain/sub_domains

请求方式：POSTGET

使用说明

适用场景： 该接口适用于主域名下的子域名发现，可用于资产梳理、攻击面排查、可疑子域拓线和域名侧 IOC 扩展。

使用建议： 建议在需要围绕某个主域名进行资产发现或安全排查时调用。返回结果可作为后续域名分析、资产核对、暴露面扫描或访问控制策略的输入；对于子域名数量较大的主域，建议按业务重要性和风险线索分批分析。

响应字段解读建议： 建议先查看 sub_domains.total 判断子域名规模，再使用 sub_domains.data 中的具体子域名开展进一步分析。由于单次最多返回部分列表，结果应作为发现线索使用，不宜默认视为完整资产清单。

请求参数说明
序号参数名称必选类型描述
1apikey是stringAPI请求的身份识别标识。
2resource是string域名，目前支持单个查询。
3lang可选string返回结果语言。不输入该参数时，默认返回英文。
取值二者选其一：
  • zh：所有返回结果内容中文显示。
  • en：所有返回结果内容英文显示。
响应参数说明
序号参数名称类型描述使用说明
1response_codeint响应正常会返回"0"。
其他Response code及对应msg描述参见"响应Code和Msg对照表"		用于判断本次请求是否成功。业务系统应先判断该字段，再解析 data 内的业务结果；非 0 时建议按异常请求处理。
2verbose_msgstring响应正常会返回"Ok"。
其他Response code及对应msg描述参见"响应Code和Msg对照表"		用于展示或记录接口返回说明，适合写入调用日志和错误排查信息；自动化流程建议以 response_code 为主要判断依据。
3domainstring查询的域名。用于确认当前子域名列表对应的主域名。
4sub_domainsobject该域名相对应的二级域名下的子域名，是一个JSON对象，字段说明如下：
  • total: 字符串类型，表示有多少子域名，如果数量超过1000，则显示为"1000+"，否则为实际数量。
  • data: 类型为数组，是当前返回的部分或全部子域名列表，每个item是一个子域名，最多返回500个。
用于查看子域名数量和列表，可作为资产发现、域名分析和攻击面排查的输入。
5permalinkstring域名对应的情报查询结果页链接用于跳转到 X 情报中心的情报详情页，适合人工复核、报告留存和协同分析，不建议作为自动化风险判断依据。
请求示例

微步在线云API支持cURL、Python、PHP、Java、Go语言的请求，以Python为例：

Python
import requests

url = "https://api.threatbook.cn/v3/domain/sub_domains"

query = {
  "apikey":"请替换apikey",
  "resource":"000000.life"
}

response = requests.request("GET", url, params=query)

print(response.json())
响应示例（JSON）
{
    "data": {
        "domain": "000000.life",
        "sub_domains": {
            "total": "12",
            "data": [
                "0.000000.life",
                "autodiscover.000000.life",
                "cpanel.0.000000.life",
                "cpanel.000000.life",
                "mail.0.000000.life",
                "mail.000000.life",
                "webdisk.0.000000.life",
                "webdisk.000000.life",
                "webmail.0.000000.life",
                "webmail.000000.life",
                "www.0.000000.life",
                "www.000000.life"
            ]
        },
        "permalink": "https://x.threatbook.com/v5/domain/000000.life"
    },
    "response_code": 0,
    "verbose_msg": "OK"
}
云API是北京微步在线科技有限公司旗下产品了解微步在线《用户服务条款》《数据保护政策》联系我们：api@threatbook.cn
Copyright © ThreatBook.CN All Rights Reserved. 京ICP备15044984号-4 北京微步在线科技有限公司 京公网安备11010802025715号