TCPLab TCPLab

IP 查询 API

最后更新: 2026-10-15

GET /api/v2/ip/{target}

查询 IPv4/IPv6 地址的归属信息;传入域名时会先解析,再查询优先地址。

接口地址、响应格式与限流为各接口通用,见 API 文档。

参数 位置 说明
target 路径 IPv4/IPv6 地址或域名。
lang query en(默认)或 zh,控制国家 / 省 / 市名称的语言。

示例:

curl "https://tcp.lc/api/v2/ip/8.8.8.8?lang=zh"

响应 data 字段:

字段 说明
target 输入的查询目标(域名或 IP)。
ip 实际查询的地址。
version 4 或 6。
addresses 域名解析出的地址列表(直接查询 IP 时为空数组)。
source 数据来源:TCPLab、geocn 或 geolite2。
isDomestic 是否属于中国网络。
country、countryName ISO 3166-1 alpha-2 国家代码与本地化名称。
province、city、district 省 / 市 / 区名称(有数据时)。
isp、type 运营商与网络类型(主要为国内地址)。
adcode 行政区划代码。
longitude、latitude、timezone 经纬度与时区(有数据时)。

常见错误:api.param.ip.invalid、api.param.ip.private、api.param.name.invalid、api.notfound.domain。