全球IP归属地查询-简版

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

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

接口简介

全球IP归属地查询-简版接口输入一个IPv4或IPv6地址，即刻返回该IP归属的国家、省份、城市与运营商信息，一次调用即可完成IP定位画像。适合登录风控、访客来源分析、日志排查与内容分地域展示等场景。

详细介绍

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

输入任意 IPv4 或 IPv6 地址，即刻获知它所在的国家、省份、城市与运营商。IPv4 由离线IP库本地查询、毫秒级返回，适合登录风控、访客分析与内容分地域等场景。

## 接口概述

IP归属地查询接口面向风控、运营分析与日志排查等业务场景：只需传入一个 IP 地址，即可返回该 IP 归属的国家、省份、城市与运营商信息。IPv4 地址在服务器本地的离线IP库（纯真IP库）中完成匹配，不调用任何外部接口，响应稳定在毫秒级；IPv6 地址由平台自动转交云端查询通道处理，调用方无需切换接口。国家、省、市、运营商以独立字段结构化返回，可直接用于前台展示与落库分析，帮助业务快速判断访问流量的地域来源与网络归属。

## 核心能力

1. **归属地定位**：解析 IP 归属的国家、省份与城市，境外 IP 同样支持。
2. **运营商识别**：同步返回 IP 归属的运营商/机构信息，辅助判断流量来源。
3. **双栈支持**：IPv4 本地离线查询、IPv6 自动转交云端通道，一个接口覆盖两类地址。
4. **结构化返回**：国家/省/市/运营商分字段返回，无需二次切割字符串。
5. **原样回显**：返回查询的 IP 本身，批量调用时便于结果对账。

## 产品优势

- **接入简单**：POST 请求、JSON 返回，仅 `ip` 一个业务参数，几分钟即可完成集成。
- **毫秒级响应**：IPv4 走本地离线库查询，无上游波动与限流影响，支持高并发批量调用。
- **稳定可靠**：离线库随平台维护更新，可用性不受第三方接口状态制约。
- **降本增效**：替代人工逐条查询 IP 归属，风控与运营分析流程自动化。
- **准确规范**：归属地按国家/省/市三级拆解返回，字段口径统一，免去自行解析文本的麻烦。

## 效果展示

一句话理解：它就像给 IP 地址查「户籍」——看一眼就知道这个地址落在哪个地区、用的哪家网络。

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

| 参数 | 本次示例值 | 说明 |
|------|-----------|------|
| ip | 114.114.114.114 | 要查询的 IP 地址，支持 IPv4 与 IPv6，也是本接口唯一的业务参数 |

你会拿到的结果：

| 返回内容 | 本次示例值 | 对应字段 |
|---------|-----------|---------|
| 查询的IP地址 | 114.114.114.114 | `ip`，原样回显便于对账 |
| 归属国家 | 中国 | `nation` |
| 归属省份 | 江苏 | `province` |
| 归属城市 | 南京 | `city` |
| 归属运营商 | 信风公共DNS | `isp` |

API请求示例：

```
POST /api/v1/ipquery
ip=114.114.114.114
```

API响应示例：

```json
{
  "code": 0,
  "desc": "成功",
  "data": {
    "ip": "114.114.114.114",
    "nation": "中国",
    "province": "江苏",
    "city": "南京",
    "isp": "信风公共DNS"
  }
}
```

一次调用即完成「地址 → 国家/省/市 + 运营商」的拆解。内网、本机、保留地址等无归属信息的 IP 会正常返回，但国家/省/市为空串，业务侧可据此过滤。

## 应用场景

- **登录风控**：识别登录 IP 的归属地，异地登录、异常地区登录触发二次校验
- **访客分析**：统计网站与 App 访客的地域分布和运营商构成，辅助投放决策
- **内容分地域**：按访客 IP 所在地区展示地域相关内容或跳转对应站点
- **日志排查**：批量解析服务器日志中的 IP 归属，快速定位异常流量来源
- **反欺诈核查**：标记同一地区集中注册、集中下单等异常特征，辅助人工审核

## 应用案例

- **电商平台风控**：下单时自动解析买家 IP 归属地，与收货地址省市交叉校验，明显不符的订单进入人工复核，欺诈订单在提交环节即被拦截。
- **内容网站运营**：按访客 IP 归属省份展示对应地方频道内容，用户停留时长提升；地域分布报表同时为广告位定价提供依据。
- **企业安全运维**：对外联 IP 日志批量查询归属地与运营商，快速识别可疑境外流量与机房代理流量，安全事件排查时间明显缩短。

常见问题

Q：这个接口能做什么？

A：输入一个 IPv4 或 IPv6 地址，返回其归属国家（nation）、省份（province）、城市（city）与运营商（isp），并回显查询的 ip。IPv4 由本地离线IP库查询，IPv6 自动转交平台云端通道处理。

Q：IPv6 地址支持吗？

A：支持。IPv4 地址在本地离线IP库直接查询；IPv6 地址由平台自动转交云端查询通道处理，调用方无需切换接口或更改参数。

Q：查询不到结果会怎样？

A：IP 格式无效会返回参数错误提示；库中未收录归属信息时返回「未查询到该IP的归属地信息」。内网、本机、保留地址会正常返回，但国家/省/市为空串。

Q：这个接口适合谁用？

A：适合需要在登录风控、访客分析、日志排查、内容分地域等场景中判断 IP 地理归属与网络来源的开发者和企业。

IP归属地 IP查询 IP运营商 IPv4 IPv6 风控识别

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

请求方式： POST

业务请求参数

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

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

响应参数

字段名	类型	说明
`code`	int	状态码，0=成功
`desc`	string	状态描述
`data`−	object	业务数据（成功时返回）
`ip`	string	查询的IP地址
`nation`	string	国家
`province`	string	省份
`city`	string	城市
`isp`	string	运营商
`request_id`	string	请求追踪ID

JSON 示例：

调用成功：

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

调用失败：

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

请先登录后使用在线测试