API 文档
接口地址: https://api.gugudata.com/v2/location/ip
返回格式: application/json; charset=utf-8
请求方式: GET
请求协议: HTTPS
请求示例: https://api.gugudata.com/v2/location/ip?appkey=YOUR_APPKEY&ip=2001%3a4878%3ab554%3aaaaa%3aaaaa%3aaaaa%3aaaaa%3aaaaa
数据预览: https://www.gugudata.com/preview/internationaliplocation
接口测试: https://api.gugudata.com/v2/location/ip/demo
OpenAPI: https://www.gugudata.com/openapi/gugudata.openapi.3.1.json
| 参数名 |
参数类型 |
是否必须 |
默认值 |
备注 |
| appkey |
string |
是 |
无 |
开发者凭据;支持现有 Query、Header 和 Bearer,多处值须一致。 |
| ip |
string |
是 |
无 |
IPv4 或 IPv6 字面量;不接受域名、端口或 CIDR。 |
| 参数名 |
参数类型 |
备注 |
| dataStatus.requestParameter |
string |
真实、可读的业务请求参数;无业务参数时为空,不包含凭据。 |
| dataStatus.statusCode |
integer |
接口返回状态码 |
| dataStatus.status |
string |
接口返回状态,例如 SUCCESS 或 ERROR。 |
| dataStatus.statusDescription |
string |
接口返回状态说明 |
| dataStatus.responseDateTime |
string |
接口数据返回时间 |
| dataStatus.dataTotalCount |
integer |
单个定位对象为 1。 |
| data |
object |
定位结果是 IP 所属网络的地域参考,不代表设备实时位置。城市、省份可能为空;经纬度为可用定位记录中的数值,缺失或冲突记录明确失败。数据公布与更新频率以实际来源为准。 |
| data.countryCode |
string |
IP 地址定位国家代码 |
| data.state |
string/null |
IP 地址定位省份/州 |
| data.city |
string/null |
IP 地址定位城市 |
| data.latitude |
number |
IP 地址定位纬度 |
| data.longitude |
number |
IP 地址定位经度 |
{
"dataStatus": {
"requestParameter": "ip=2001:4878:b554:aaaa:aaaa:aaaa:aaaa:aaaa",
"statusCode": 200,
"status": "SUCCESS",
"statusDescription": "successfully / 成功",
"responseDateTime": "2026-10-15 16:07:29",
"dataTotalCount": 1
},
"data": {
"countryCode": "US",
"state": "Massachusetts",
"city": "Cambridge (East Cambridge)",
"latitude": 42.3649,
"longitude": -71.0889
}
}