高精度 IP 地址归属地查询服务，覆盖全球 99.8% 的 IPv4 与 IPv6 地址，可解析到国家、省份、城市、区县及运营商，适用于风控反欺诈、内容合规、广告定向、访客统计等场景。
IP 归属地 API 通过标准 HTTP GET 请求返回结构化 JSON 数据，支持 IPv4 与 IPv6 两种地址格式。返回字段涵盖国家、省份、城市、区县、运营商以及经纬度坐标。IP 库每日更新，国内精度可达区县级，海外精度到城市级。接口全程 HTTPS 加密传输，支持高并发调用，毫秒级响应，可稳定用于线上生产环境。
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| apikey | string | 是 | 用户身份密钥，在控制台「应用管理」中创建应用后获取。 |
| ip | string | 是 | 待查询的 IP 地址，如「114.114.114.114」或 IPv6 格式。 |
| type | string | 否 | 地址类型：ipv4（默认）或 ipv6，系统可自动识别，也可手动指定。 |
| 字段名 | 类型 | 说明 |
|---|---|---|
| code | int | 状态码，200 表示请求成功，其余见错误码对照表。 |
| msg | string | 状态描述信息。 |
| data.ip | string | 查询的 IP 地址。 |
| data.country | string | 所属国家，如中国、美国。 |
| data.province | string | 所属省份，如江苏省。 |
| data.city | string | 所属城市，如南京市。 |
| data.district | string | 所属区县（国内 IP 可精确到此级别）。 |
| data.isp | string | 运营商名称，如中国电信、中国移动。 |
| data.lat | string | 纬度坐标。 |
| data.lng | string | 经度坐标。 |
| data.update_time | string | 数据更新时间，格式 yyyy-MM-dd HH:mm:ss。 |
{
"code": 200,
"msg": "success",
"data": {
"ip": "114.114.114.114",
"country": "中国",
"province": "江苏省",
"city": "南京市",
"district": "玄武区",
"isp": "中国电信",
"lat": "32.0584",
"lng": "118.7965",
"update_time": "2026-07-25 06:00:00"
}
}