全球IP归属地查询-高级版

接口标识: ipqueryplus 价格: 0.0005 元/次 VIP免费同步响应

接口介绍
接口文档
在线测试

接口简介

全球IP归属地查询-高级版接口输入一个IPv4或IPv6地址，实时返回其归属的国家、省份、城市、区县、运营商、大区、经纬度以及省市县三级行政区划代码等14个结构化字段，中国区精确到区县级，覆盖全球200多个国家和地区。行政区划代码与经纬度可直接对接地图与区域统计体系。适用于用户地域分析、内容本地化、风控定位与访问日志地理归因。

详细介绍

![全球IP归属地查询-高级版接口封面](https://fujian.phpwc.com/pyapi/uploads/site/20261109/apiops_ipqueryplus__1794169453_88c7099cdd18.png)

一个IP地址，换回国家、省市区县、运营商和经纬度的完整地理画像。访问日志里的IP只知道「从哪来」，本接口把每个IP还原为精确到区县的中国行政区划定位与运营商信息，让地域分析、内容本地化与风控定位有据可依。

## 接口概述

全球IP归属地查询高级版接口面向地域分析、风控识别与日志归因等业务场景：传入一个 IPv4 或 IPv6 地址，同步返回其归属的国家、省份、城市、区县、运营商、所属大区与经纬度，并附带省、市、区县三级国家标准行政区划代码。中国区结果精确到区县级，全球覆盖200多个国家和地区，数据来自商业级IP地理数据库。14个字段全部以结构化字符串返回，可直接入库、参与统计聚合或地图定位，轻松嵌入用户画像、内容分发与反欺诈系统。

## 核心能力

1. **区县级定位**：中国区IP定位精确到区县，并返回区县行政区划代码，满足精细化地域分析。
2. **三级区划代码**：省、市、区县三级国家标准行政区划代码同时返回，可直接与既有地域维表关联。
3. **运营商与大区**：返回IP所属运营商及华中、华东等大区归属，支持网络质量与区域维度统计。
4. **经纬度坐标**：附带纬度与经度，可直接用于地图可视化打点与距离计算。
5. **IPv6支持**：入参同时接受 IPv4 与 IPv6 两种格式，平台侧分别做格式校验后转发查询，适配下一代网络改造后的业务需要。

## 产品优势

- **接入简单**：仅 `ip` 一个业务参数，POST 请求、JSON 返回，几分钟完成集成。
- **覆盖广泛**：全球200多个国家和地区一次覆盖，国内外业务共用一个接口。
- **字段齐全**：一次调用返回14个结构化字段，无需拼接多个数据源。
- **准确规范**：采用商业级IP地理数据库，省/市/区县行政区划代码为国家标准编码，可直接与既有地域维表关联。
- **降本增效**：免去自建IP库的采集、更新与解析维护成本，专注业务逻辑。

## 效果展示

一句话理解：它就像给IP地址查「户籍和门牌」——不但知道它在哪个省哪个市，还精确到哪个区县、哪家运营商，并能在地图上标出大致位置。

以一次真实调用为例，你要传的参数：

| 参数 | 本次示例值 | 说明 |
|------|-----------|------|
| ip | 182.124.96.66 | 要查询的IP地址，支持 IPv4 与 IPv6 |

你会拿到的结果：

| 返回内容 | 本次示例值 | 对应字段 |
|---------|-----------|---------|
| 归属国家 | 中国 | `country`，国家代码 CN 在 `country_id` |
| 归属省份 | 河南 | `region`，省区划代码 410000 在 `region_id` |
| 归属城市 | 安阳 | `city`，市区划代码 410500 在 `city_id` |
| 归属区县 | 林州市 | `district`，区县区划代码 410581 在 `district_id` |
| 运营商 | 中国联通 | `isp`，所属大区「华中」在 `area` |
| 经纬度 | 36.083047 / 113.820130 | `lat` / `lng`，可直接用于地图定位 |

API请求示例：

```
POST /api/v1/ipqueryplus
ip=182.124.96.66
```

API响应示例：

```json
{
  "code": 0,
  "desc": "成功",
  "data": {
    "ip": "182.124.96.66",
    "long_ip": "3061604418",
    "isp": "中国联通",
    "area": "华中",
    "region_id": "410000",
    "region": "河南",
    "city_id": "410500",
    "city": "安阳",
    "district": "林州市",
    "district_id": "410581",
    "country_id": "CN",
    "country": "中国",
    "lat": "36.083047",
    "lng": "113.820130"
  }
}
```

一次调用即把IP拆解为「国家-省-市-区县 + 运营商 + 经纬度」的完整地理画像，`long_ip` 为IP的长整型表示，可用于范围运算。IP格式非法返回参数错误；未收录或上游查询失败返回非 0 错误码与原因描述。

## 应用场景

- **用户地域分析**：统计注册与活跃用户的地域分布，按省市区县三级出报表
- **内容本地化**：按访问者IP属地自动切换本地资讯、语言与区域化内容
- **风控定位**：识别异地登录、IP聚集注册等异常行为，辅助反欺诈决策
- **日志归因**：访问日志批量地理化，定位异常流量的来源区域
- **广告投放**：按地域定向投放广告，提升区域触达的精准度

## 应用案例

- **电商平台**：用户下单后自动解析IP归属地并与收货地址交叉校验，属地明显偏离的订单进入风控复核，欺诈订单明显减少。
- **资讯类APP**：启动时读取访客IP的省市与区县，首页优先推送本地新闻与生活服务信息，用户停留时长显著提升。
- **游戏运营团队**：批量分析登录日志的IP归属区县，发现某区县集中出现异常登录特征，结合账号策略处置，作弊行为明显收敛。

常见问题

Q：支持哪些IP类型？

A：入参同时接受 IPv4 与 IPv6 两种格式。服务端会做格式校验：IPv4 逐段校验 0-255，IPv6 校验是否由十六进制字符与冒号组成，格式非法返回参数错误提示。

Q：返回数据精确到什么级别？

A：中国区精确到区县级，并附带省、市、区县三级国家标准行政区划代码与经纬度；全球覆盖200多个国家和地区。境外地区返回的定位粒度以上游数据库实际结果为准。

Q：一共返回哪些字段？

A：14个结构化字段：查询IP、长整型IP、运营商、所属大区（如华中）、国家名称及代码、省份及区划代码、城市及区划代码、区县及区划代码、纬度、经度，全部为字符串类型。

Q：数据来源可靠吗？

A：采用商业级IP地理数据库，覆盖全球。上游商品页标称数据定期更新、中国区县级定位准确率97%以上（均为上游标称口径，平台未独立实测）；行政区划代码标准可溯，适合直接参与统计口径。

Q：查询失败会怎样？

A：IP格式非法返回参数错误；IP未被数据库收录或上游查询失败时返回非0错误码与原因描述。

IP归属地 IP定位区县定位 IPv6查询 IP经纬度地域分析

接口地址： https://www.phpwc.cn/api/ipqueryplus

请求方式： POST

业务请求参数

参数名	类型	必填	默认值	说明
`ip`	string	必填	-	要查询的IP地址，支持IPv4和IPv6

查看签名算法查看调用示例

响应参数

字段名	类型	说明
`code`	int	状态码，0=成功
`desc`	string	状态描述
`data`−	object	业务数据（成功时返回）
`ip`	string	查询的IP地址
`long_ip`	string	IP地址的长整型表示
`isp`	string	运营商
`area`	string	区域（如华中）
`region_id`	string	省份行政区划代码
`region`	string	省份名称
`city_id`	string	城市行政区划代码
`city`	string	城市名称
`district`	string	区县名称
`district_id`	string	区县行政区划代码
`country_id`	string	国家代码（ISO 3166-1）
`country`	string	国家名称
`lat`	string	纬度
`lng`	string	经度
`request_id`	string	请求追踪ID

JSON 示例：

调用成功：

{
  "code": 0,
  "desc": "success",
  "data": { ... },
  "request_id": "abc123..."
}

调用失败：

{
  "code": 999,
  "desc": "错误描述",
  "request_id": "abc123..."
}

请先登录后使用在线测试