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。