微步在线云API
我的API

IP高级查询

IP高级查询，获取IP当前域名，历史域名信息。

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

请求方式：POSTGET

请求参数说明
序号参数名称必选类型描述
1apikey是stringAPI请求的身份识别标识。
2resource是stringIP地址，目前支持单个查询。
3exclude可选string可根据实际使用场景排除以下参数，返回结果信息，多个参数请以逗号分隔（注意不要有空格）。
  • asn：asn信息。
  • cur_domains：当前指向该IP的域名。
  • history_domains:IP逆向的历史域名。
4lang可选string返回结果语言。不输入该参数时，默认返回英文。
取值二者选其一：
  • zh：所有返回结果内容中文显示。
  • en：所有返回结果内容英文显示。
响应参数说明
序号参数名称类型描述
1response_codeint响应正常会返回"0"。
其他Response code及对应msg描述参见"响应Code和Msg对照表"
2verbose_msgstring响应正常会返回"Ok"。
其他Response code及对应msg描述参见"响应Code和Msg对照表"
3ipstring查询的IP地址。
4basicobjectbasic返回是一个JSON对象，字段说明如下：
  • carrier: 运营商/服务商
  • location: ip对应的位置信息，JSON对象，说明如下：
    • country: 国家
    • country_code：国家代码
    • province: 省
    • city: 城市
    • lng: 经度
    • lat: 纬度
5asnobjectasn信息。一个JSON对象，包含：
  • number: ASN号码
  • info: AS名称
  • rank: 风险值（0~4，越大代表风险越高）
6cur_domainsarray当前指向该IP的域名，是一个数组。
7history_domainsmapIP逆向的历史域名，是一个JSON Map，key是日期，value是JSON数组，每个item是一个域名。
8permalinkstringIP对应的情报查询结果页链接
请求示例

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

Python
import requests

url = "https://api.threatbook.cn/v3/ip/adv_query"

query = {
  "apikey":"请替换apikey",
  "resource":"159.203.93.255"
}

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

print(response.json())
响应示例（JSON）
{
    "data": {
        "ip": "159.203.93.255",
        "basic": {},
        "asn": {
            "rank": 2,
            "info": "DIGITALOCEAN-ASN",
            "number": 14061
        },
        "cur_domains": [],
        "history_domains": {
            "2017-02-22": [
                "www.muusick.net",
                "muusick.net"
            ],
            "2017-01-29": [
                "www.muusick.net",
                "www.muusick.tv",
                "muusick.net"
            ],
            "2016-12-21": [
                "www.muusick.net",
                "muusick.tv",
                "www.muusick.tv",
                "muusick.net"
            ],
            "2016-09-11": [
                "www.muusick.net",
                "muusick.net"
            ],
            "2015-12-17": [
                "daysntowers.com"
            ]
        },
        "permalink": "https://x.threatbook.com/v5/ip/159.203.93.255"
    },
    "response_code": 0,
    "verbose_msg": "OK"
}
云API是北京微步在线科技有限公司旗下产品了解微步在线《用户服务条款》《数据保护政策》联系我们：api@threatbook.cn
Copyright © ThreatBook.CN All Rights Reserved. 京ICP备15044984号-4 北京微步在线科技有限公司 京公网安备11010802025715号