IP 归属地 JSON API
免费 · 无需密钥 · 毫秒级响应，返回国家、省市、运营商与城市区号，支持 IPv4 / IPv6
接口列表
| 接口 | 返回格式 | 说明 |
|---|---|---|
| GET /json?ip=8.8.8.8 | JSON | 查询任意 IPv4 / IPv6 归属地 |
| GET /json | JSON | 省略 ip 参数时返回调用方（本机）公网 IP 归属 |
| GET /myip | 纯文本 | 仅返回调用方公网 IP 地址一行文本，适合脚本探测出口 IP |
调用示例
curl 'https://ip.jinricha.com/json?ip=114.114.114.114'
curl 'https://ip.jinricha.com/json' # 查询你自己 curl 'https://ip.jinricha.com/myip' # 仅取本机 IP 纯文本 curl 'https://ip.jinricha.com/json?ip=2606:4700:4700::1111'
响应示例
{
"ip": "114.114.114.114",
"version": "IPv4",
"country": "中国",
"province": "江苏",
"city": "南京",
"isp": "",
"country_code": "CN",
"flag": "🇨🇳",
"area_code": "025"
}
返回字段说明
| 字段 | 类型 | 说明 |
|---|---|---|
| ip | string | 查询的 IP 地址（省略参数时为调用方 IP） |
| version | string | IPv4 或 IPv6 |
| country | string | 国家 / 地区名称 |
| province | string | 省、州或大区 |
| city | string | 城市（可能为空） |
| isp | string | 运营商 / 机构（可能为空） |
| country_code | string | ISO 3166-1 两位国家码，如 CN |
| flag | string | 国家旗帜 Emoji |
| area_code | string | 中国大陆城市电话区号（条件返回，如南京 025） |
无效请求
curl 'https://ip.jinricha.com/json?ip=999.1.1.1'
{"error":"invalid ip"}
常见问题
接口收费吗？需要密钥吗？
完全免费，无需注册、无需申请密钥、无调用次数硬限制；请以正常业务频率调用（建议不超过每分钟 60 次），共同维护服务质量。
返回的 area_code 字段是什么？
当查询 IP 归属中国且城市可识别时，额外返回该城市电话区号（如南京 025），可用于与电话区号数据联动；其他情况该字段不出现。
数据覆盖范围与更新频率？
基于 ip2region 全球离线库，覆盖 IPv4 与 IPv6 双栈的国家 / 省州 / 城市 / 运营商五元组，随上游数据更新。