# IP反查域名

**请求方式:** GET|POST

**接口地址:** https://api.hk0.cc/api/reverseIp

**接口描述:** IP 反查域名:查询一个 IP 上历史绑定过的域名(含绑定时间区间)、当前解析到该 IP 的域名,以及机房归属。

参数:
- ips:必填,最多 20 个 IPv4 或 IPv6 地址,换行或逗号分隔;也可用 ip 传单个 IP。
- fresh:可选,传 1 跳过缓存强制重新取数。

返回:
- data.items[]:ip(IP 地址)、status(ok / no_data / blocked)、location(机房与地区)、total(历史绑定域名数)、domains(历史绑定域名,含 since / till 绑定时间区间)、current(当前解析到该 IP 的域名)。
- data.summary:成功、无数据、异常的数量。

历史绑定域名来自第三方同 IP 查询站,当前解析域名来自反向解析,两者可能不一致,属正常现象。结果默认缓存,需要最新数据时传 fresh=1。

## 请求参数

| 参数名 | 可传值说明 | 传入位置 | 是否必填 | 示例值 | 默认值 | 参数说明 |
|--------|----------|----------|----------|--------|--------|----------|
| ips | ips | query | 必传 | 103.236.84.161 | — | 必填,最多 20 个 IP,换行或逗号分隔 |
| ip | ip | query | 可选 | 103.236.84.161 | — | 可选,单个 IP,等价于 ips 传一个 |
| fresh | fresh | query | 可选 | 1 | 0 | 可选,传 1 跳过缓存强制重新取数 |

## 返回示例

```json

```