查询 IP
172.16.13.156
支持 IP 地址 / 域名 / 十进制整数 / 长网址查询 · 精确到区县级 · 免费开放 API
点击「打开」可直接查看接口返回内容;切换标签查看不同格式的调用地址。
| 接口 | 用途 | 主要参数 | 返回格式 |
|---|---|---|---|
| api/api.php | IP 归属地(通用) | ip, datatype, token | txt / json / json1 / json2 / print / xml / ini |
| api/api_json.php | IP 归属地(JSON 增强:dec / begin / end / 经纬度) | ip, datatype, token | json / jsonp |
| api/myip.php | 访问者 IP + 归属地 + 运营商(双栈探测) | datatype, token | json / jsonp |
| api/mobile.php | 手机号归属地 | mobile, datatype, token | json / jsonp |
| api/guojiadaima.php | 国家代码 / 国旗 / 区号 | cc, type, token | json |
| api/dns.php | 远程 DNS 解析 | domain, type, only, token | text |
| api/index.php | 获取访问者 IP(纯文本,自定义域名直出) | — | text |
IP 地址查询系统 · 接口说明
========================================================================
站点基址 https://ip.mir6.com
接口目录 https://ip.mir6.com/api/
请求方式 GET(下列接口全部使用 GET)
返回编码 UTF-8
关于密钥(token)
本站数据接口均需携带有效密钥,公开示例密钥为:mir6.com
三种提交方式任选其一,效果完全相同:
1) URL 参数 ?token=mir6.com
2) 请求头 Token: mir6.com
3) 请求头 Authorization: APPCODE mir6.com
正式使用请在后台「API 密钥」中为每个客户端单独分配密钥,可分别设置
调用频率(QPS)、每日上限、有效期与 IP 白名单。
========================================================================
一、IP 归属地查询 · 通用接口 api/api.php
========================================================================
调用地址
https://ip.mir6.com/api/api.php?ip=58.58.58.58&datatype=json&token=mir6.com
参数说明
ip 要查询的内容,支持以下五种形式:
IPv4 地址 58.58.58.58
IPv6 地址 240e:398:30b8::1
域名 www.qq.com (先解析为 IP 再查询)
十进制整数 976894522 (IPv4 / IPv6 均可)
长网址 https://www.example.com/a/b
留空或填 myip,表示查询访问者(发起请求的一方)的 IP
datatype 返回格式:txt | json | json1 | json2 | print | xml | ini
省略时使用后台设置的默认格式(默认 xml)
token 授权密钥
七种返回格式,把 datatype 换成对应值即可
TXT https://ip.mir6.com/api/api.php?ip=58.58.58.58&datatype=txt&token=mir6.com
JSON https://ip.mir6.com/api/api.php?ip=58.58.58.58&datatype=json&token=mir6.com
JSON1 https://ip.mir6.com/api/api.php?ip=58.58.58.58&datatype=json1&token=mir6.com
JSON2 https://ip.mir6.com/api/api.php?ip=58.58.58.58&datatype=json2&token=mir6.com
PRINT https://ip.mir6.com/api/api.php?ip=58.58.58.58&datatype=print&token=mir6.com
XML https://ip.mir6.com/api/api.php?ip=58.58.58.58&datatype=xml&token=mir6.com
INI https://ip.mir6.com/api/api.php?ip=58.58.58.58&datatype=ini&token=mir6.com
【TXT】字段以竖线 | 分隔,固定 14 段,顺序不可变
访问者IP | 查询IP | 国家 | 国家代码 | 省份 | 城市 | 区县 | 单位 | 运营商 | 网络类型 | 邮编 | 区号 | IP协议 | 服务器时间
示例:
240e:398:30b8:f090:e734:fc03:a2c9:58df|58.58.58.58|中国|CN|山东省|济宁市|任城区|未知|中国电信|专线用户|272000|0537|IPv4|2026-11-15 18:16:43
注意:第 1 段是访问者 IP,第 2 段才是查询的 IP,与旧版顺序不同,请按上表取值。
【JSON】扁平结构,字段直接位于顶层
{"ret":"ok","code":200,"message":"操作成功",
"location":"中国[CN] 山东省 济宁市 任城区",
"myip":"240e:398:30b8:f090:e734:fc03:a2c9:58df",
"ip":"58.58.58.58","city":"中国 山东省 济宁市 任城区",
"idc":"未知","isp":"中国电信","net":"专线用户",
"zipcode":"272000","areacode":"0537","protocol":"IPv4",
"time":"2026-11-15 18:16:43"}
ret 取值 ok / errors;city 为拼接后的完整地址。
【JSON1】兼容纯真 IP 库调用习惯,data.province 为「地址 + 制表符 + 运营商 + 空格 + 网络类型」
{"code":200,"message":"操作成功","location":"中国[CN] 山东省 济宁市 任城区",
"data":{"province":"中国 山东省 济宁市 任城区\t中国电信 专线用户",
"city":"中国 山东省 济宁市 任城区","idc":"未知","isp":"中国电信",
"net":"专线用户","zipcode":"272000","areacode":"0537",
"protocol":"IPv4","time":"2026-11-15 18:16:43"},
"errors":null}
【JSON2】带结构化的省 / 市 / 区县字段
{"code":200,"success":true,"message":"操作成功",
"location":"中国[CN] 山东省 济宁市 任城区",
"data":{"ip":"58.58.58.58","country":"中国","countryCode":"CN",
"province":"山东省","city":"济宁市","districts":"任城区",
"idc":"未知","isp":"中国电信","net":"专线用户",
"zipcode":"272000","areacode":"0537","protocol":"IPv4"},
"myip":"240e:398:30b8:f090:e734:fc03:a2c9:58df",
"time":"2026-11-15 18:16:43"}
【PRINT】PHP print_r 数组,便于调试
【XML】根节点 locationInfo,data 下为 ip / country / countryCode / province /
city / districts / idc / isp / net / zipcode / areacode / protocol / time
【INI】配置项写入 [ipdata] 段,可直接用「读配置项」类函数按名取值
[ipdata]
code=200
message=操作成功
location=中国[CN] 山东省 济宁市 任城区
myip=240e:398:30b8:f090:e734:fc03:a2c9:58df
ip=58.58.58.58
country=中国
countryCode=CN
province=山东省
city=济宁市
districts=任城区
idc=未知
isp=中国电信
net=专线用户
zipcode=272000
areacode=0537
protocol=IPv4
time=2026-11-15 18:16:43
========================================================================
二、IP 归属地查询 · JSON 专用接口 api/api_json.php
========================================================================
推荐作为 JSON 场景的唯一入口:字段更全(含十进制整数、经纬度、IP 段起止)。
调用地址
https://ip.mir6.com/api/api_json.php?ip=58.58.58.58&token=mir6.com
参数说明
ip 同 api.php;本接口填 myip 同样表示查询访问者 IP
datatype json(默认) | jsonp
callback datatype=jsonp 时必填,只允许字母、数字、下划线、$ 与点,且不能以数字开头
token 授权密钥
调用示例
https://ip.mir6.com/api/api_json.php?ip=58.58.58.58&token=mir6.com
https://ip.mir6.com/api/api_json.php?ip=240e:398:30b8::1&token=mir6.com
https://ip.mir6.com/api/api_json.php?ip=58.58.58.58&datatype=jsonp&callback=cb&token=mir6.com
返回示例
{"code":200,"success":true,"message":"操作成功",
"data":{"ip":"58.58.58.58","dec":"976894522","country":"中国","countryCode":"CN",
"province":"山东省","city":"济宁市","districts":"任城区","idc":"",
"isp":"中国电信","net":"专线用户","zipcode":"272000","areacode":"0537",
"lng":"116.595261","lat":"35.414828","protocol":"IPv4",
"begin":"IP段起数据仅提供给数据贡献者使用",
"end":"IP段止数据仅提供给数据贡献者使用"},
"location":"中国[CN] 山东省 济宁市 任城区",
"myip":"240e:398:30b8:f090:e734:fc03:a2c9:58df",
"time":"2026-11-15 18:16:44"}
字段说明
data.dec IP 对应的十进制整数(IPv4 / IPv6 均支持)
data.lng data.lat 经纬度(部分 IP 无此数据,返回空串)
data.begin data.end IP 段起止,默认仅对数据贡献者开放
========================================================================
三、获取访问者自身 IP api/myip.php
========================================================================
给前台页面与双栈探测使用:返回结构化 JSON,强制校验密钥,带 CORS,
可被 ipv4.* / ipv6.* 等独立域名跨域读取。
调用地址
https://ip.mir6.com/api/myip.php?token=mir6.com&datatype=json
参数说明
datatype json(默认) | jsonp
token 授权密钥
返回示例
{"code":200,"success":true,"message":"操作成功",
"data":{"ip":"240e:398:30b8:f090:e734:fc03:a2c9:58df","protocol":"IPv6",
"dec":"47924972909264830997707975589194455263","country":"中国",
"countryCode":"CN","province":"四川省","city":"绵阳市","districts":"安州区",
"isp":"中国电信","idc":"","net":"普通宽带","zipcode":"622600",
"areacode":"0816","lng":"104.560341","lat":"31.53894",
"location":"中国[CN] 四川省 绵阳市 安州区",
"city_raw":"中国 四川省 绵阳市 安州区",
"from":"中国[CN] 四川省 绵阳市 安州区 · 中国电信"},
"location":"中国[CN] 四川省 绵阳市 安州区",
"myip":"240e:398:30b8:f090:e734:fc03:a2c9:58df",
"time":"2026-11-15 18:16:45"}
data.from 为「地址 · 运营商」拼接串,可直接展示。
========================================================================
四、远程 DNS 解析 api/dns.php
========================================================================
调用地址
https://ip.mir6.com/api/dns.php?domain=www.baidu.com&token=mir6.com
https://ip.mir6.com/api/dns.php?domain=www.qq.com&type=AAAA&token=mir6.com
https://ip.mir6.com/api/dns.php?domain=www.qq.com&type=AAAA&only=true&token=mir6.com
参数说明
domain 要解析的域名(也可传 IP,用于 PTR)
type 记录类型:A | AAAA | CNAME | MX | TXT | PTR | NS
省略时按 A 记录(IPv4)解析
only true 只返回第一条记录结果;false(默认)返回全部记录
token 授权密钥
返回值:纯文本(text/plain)
only=true 直接返回单条结果,例如:183.2.172.177
only=false 每条记录一行「字段:值」,记录之间空一行,例如:
host:ins-ysshqadg.ias.tencent-cloud.net
class:IN
ttl:107
type:A
ip:183.60.118.213
用途:判断「远程解析到的 IP」与「本机解析到的 IP」是否一致,
可快速发现 HOSTS 被篡改、DNS 被劫持或 CDN 地域解析差异。
========================================================================
五、手机号码归属地 api/mobile.php
========================================================================
调用地址
https://ip.mir6.com/api/mobile.php?mobile=18855558888&token=mir6.com
参数说明
mobile 11 位中国大陆手机号(可带 +86、空格或连字符)
datatype json(默认) | jsonp
token 授权密钥
返回示例
{"code":200,"success":true,"message":"操作成功",
"data":{"mobile":"18855558888","province":"安徽省","city":"马鞍山市",
"local":"安徽省马鞍山市","isp":"中国移动",
"type":"TD-SCDMA卡 (3G)","norm":"TD-SCDMA (时分同步码分多址)",
"zone":"0555","zipcode":"243000","zoningcode":"340500"},
"myip":"240e:398:30b8:f090:e734:fc03:a2c9:58df",
"time":"2026-11-15 18:16:45"}
字段说明
province 省份 / 自治区 / 直辖市 city 所在地级市
local 归属地合并显示串 isp 运营商
type 手机卡类型(部分号段暂无数据) norm 制式标准(部分号段暂无数据)
zone 长途区号 zipcode 邮政编码
zoningcode 行政区划代码
========================================================================
六、国家代码查询 api/guojiadaima.php
========================================================================
调用地址
https://ip.mir6.com/api/guojiadaima.php?cc=cn&type=iso2&token=mir6.com
参数说明
cc 要查询的国家,可用任意一种代码,接口会自动识别
type 指定按哪种代码查询:url | cn_abbreviation | en_abbreviation | iso2 |
iso3 | numcode | areacode | domainsuffix | remarks
datatype json(默认)
token 授权密钥
返回示例
{"code":200,"success":true,"message":"操作成功",
"codedata":{"URL":"//ip.mir6.com/guojiadaima/images/cn.png",
"CN_Abbreviation":"中国","EN_Abbreviation":"China",
"ISO2":"CN","ISO3":"CHN","NumCode":"156","AreaCode":"86",
"Domainsuffix":".cn","Remarks":"the People's Republic of China"},
"myip":"240e:398:30b8:f090:e734:fc03:a2c9:58df",
"time":"2026-11-15 18:16:45"}
type 取值说明
URL 国旗图片地址 CN_Abbreviation 中文简称
EN_Abbreviation 英文简称 ISO2 / ISO3 二位 / 三位国家代码
NumCode 数字国家代码 AreaCode 国际电话区号(不含 +)
Domainsuffix 域名后缀 Remarks 备注信息
完整国家代码表:https://ip.mir6.com/guojiadaima/
========================================================================
七、纯文本获取访问者 IP api/index.php
========================================================================
curl https://ip.mir6.com/api/index.php
返回:240e:398:30b8:f090:e734:fc03:a2c9:58df
无需密钥,仅返回纯文本 IP,适合命令行与服务端日志使用。
========================================================================
八、错误码
========================================================================
格式类错误:正文与 HTTP 头同时给出 code / message / location
4001 未提交有效的授权密钥 请提交 token 后重试
4002 授权密钥无效或已停用 检查密钥是否正确、是否被停用
4003 授权密钥已过期 重新获取有效密钥
4004 请求来源 IP 未被授权 联系管理员把该 IP 加入白名单
4005 请求频率超出限制 降低频率或稍后重试
参数类错误
5100 请求参数校验异常 5101 缺少必填参数
5102 IP 地址格式错误 5103 十进制整数格式错误
5104 域名格式错误 5105 网址格式错误
5106 手机号码格式错误 5107 国家代码参数格式错误
5108 DNS 解析参数错误 5109 请求参数包含非法字符
5110 参数长度超限 5111 返回格式参数错误
5112 JSONP 回调参数错误 5201 域名解析失败
调用建议
1) 生产环境请使用自己的密钥,不要长期使用示例密钥 mir6.com;
2) txt / xml / ini 等非 JSON 格式的正文结构保持不变,错误信息同时写入
X-Api-Code / X-Api-Message / X-Api-Location 响应头;
3) IPv6 地址在 URL 中无需转义,直接拼接即可。
------------------------------------------------------------------------
注意:查询结果仅供参考,不得用于商业用途。
客服 QQ:82000401