国际 IP 地址定位 API 数据接口
兼容 IPv4 与 IPv6 兼容，IPv4/IPv6，全球 IP 地址定位。
1. 产品功能
- 支持全球 IP 地址定位查询；
- 每周定时更新最新定位基础数据库；
- 提供精准、高效的 IPv4/IPv6 地址定位查询；
- 一个接口同时兼容 IPv4 或 IPv6 地址的查询定位；
- 返回的 IP 定位地址包含详细的位置信息；
- 数据持续更新与维护；
- 全接口支持 HTTPS（TLS v1.0 / v1.1 / v1.2 / v1.3）；
- 全面兼容 Apple ATS；
- 全国多节点 CDN 部署；
- 接口极速响应，多台服务器构建 API 接口负载均衡；
- 接口调用状态与状态监控
2. API 文档
接口详情: https://www.gugudata.com/api/details/internationaliplocation
接口地址: 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=YOUR_VALUE
数据预览: https://www.gugudata.com/preview/internationaliplocation
接口测试: https://api.gugudata.com/v2/location/ip/demo
3. 请求参数
| 参数名 | 参数类型 | 是否必须 | 默认值 | 备注 |
|---|---|---|---|---|
| appkey | string | 是 | YOUR_APPKEY | 付费后获取的 APPKEY |
| ip | string | 是 | YOUR_VALUE | IP 地址，可以传递 IPv4 或 IPv6 地址 |
4. 返回参数
| 参数名 | 参数类型 | 备注 |
|---|---|---|
| dataStatus.statusCode | int | 接口返回状态码 |
| dataStatus.statusDescription | string | 接口返回状态说明 |
| dataStatus.responseDateTime | string | 接口数据返回时间 |
| dataStatus.dataTotalCount | int | 此条件下的总数据量，一般用于分页计算 |
| data.countryCode | string | IP 地址定位国家代码 |
| data.state | string | IP 地址定位省份/州 |
| data.city | string | IP 地址定位城市 |
| data.latitude | number | IP 地址定位纬度 |
| data.longitude | number | IP 地址定位经度 |