IP 归属城市查询 API 使用说明 ← 返回查询页

IP 归属城市查询 API

接口信息

项目	说明
URL	`/api/v1/ip/city/query`
方法	`GET`
权限	公开，无需鉴权
返回格式	JSON

请求说明

自动取客户端 IP（支持 X-Forwarded-For、X-Real-IP 等代理头），无需传入任何参数。

也可通过 ?ip= 参数指定要查询的 IP 地址。

响应示例

成功

{
  "code": 0,
  "success": true,
  "data": {
    "ip": "114.114.114.114",
    "province": "江苏省",
    "city": "南京市"
  }
}

字段说明

字段	类型	说明
`code`	int	`0` 表示成功
`success`	bool	`true` 表示成功
`data.ip`	string	识别到的客户端 IP
`data.province`	string	IP 归属省份；查询失败时为空字符串
`data.city`	string	IP 归属城市；查询失败时为空字符串

请求示例

curl — 查询自身 IP

curl https://cuobiezi.net/api/v1/ip/city/query

curl — 查询指定 IP

curl "https://cuobiezi.net/api/v1/ip/city/query?ip=114.114.114.114"

Python

import requests

resp = requests.get(
    "https://cuobiezi.net/api/v1/ip/city/query",
    params={"ip": "114.114.114.114"},
    timeout=10,
)
data = resp.json()
if data["success"]:
    print(data["data"]["province"], data["data"]["city"])