API 文档
接口地址: https://api.gugudata.com/websitetools/iplocation
返回格式: application/json; charset=utf-8
请求方式: GET
请求协议: HTTPS
请求示例: https://api.gugudata.com/websitetools/iplocation?appkey=YOUR_APPKEY&ip=110.96.0.0
数据预览: https://www.gugudata.com/preview/iplocation
接口测试: https://api.gugudata.com/websitetools/iplocation/demo
OpenAPI: https://www.gugudata.com/openapi/gugudata.openapi.3.1.json
| 参数名 |
参数类型 |
是否必须 |
默认值 |
备注 |
| appkey |
string |
是 |
无 |
已开通本商品的 APPKEY;也可使用既有 Header 或 Bearer 鉴权,不同时要求多个载体。 |
| ip |
string |
是 |
无 |
要查询的 IPv4 或 IPv6 字面量;不是域名、URL、端口或 CIDR。 |
| 参数名 |
参数类型 |
备注 |
| DataStatus.RequestParameter |
string |
本次真实、可读的业务请求参数,不含凭据;Demo 与实际示例输入对应。 |
| DataStatus.StatusCode |
integer |
100 成功;501 参数错误对应 HTTP 400;901 处理或依赖失败对应 HTTP 503,公共鉴权和限流规则保持。 |
| DataStatus.StatusDescription |
string |
业务处理结果说明。 |
| DataStatus.ResponseDateTime |
string |
响应生成时间,不代表资料公布、行情交易或净值日期。 |
| DataStatus.DataTotalCount |
integer |
本次实际返回记录数量;技术资讯为本页文章数,未命中归属资料时为 0。 |
| Data |
object |
定位结果对象;未命中时保留对象并返回 DataTotalCount=0。 |
| Data.Country |
string |
历史地域描述字段;不改为国家代码,未命中可为 null。 |
| Data.Address |
string |
IP 地址具体定位地址 |
| Data.LocationCode |
string |
可关联的六位行政区划码;无法关联时为空字符串,未命中可为 null。 |
{
"DataStatus": {
"RequestParameter": "ip=110.96.0.0",
"StatusCode": 100,
"StatusDescription": "请求成功。",
"ResponseDateTime": "2026-10-31 14:58:47.283",
"DataTotalCount": 1
},
"Data": {
"Address": "中移铁通",
"Country": "北京市",
"LocationCode": "110000"
}
}