请求方式:
HTTP HTTPS POST GET
返回格式:
JSON XML JSONP
请求接口:
计费说明:

正常请求免费不限制,使用密钥首次查询消耗1积分,1小时内同IP重复查询不计费。

如果查询量较大或需要稳定使用,请使用应用密钥appKey请求接口。

  • 请求参数
  • 返回参数
参数名 类型 必传 说明
ip string 要查询的IP,不传默认取当前请求者IP
appKey string 接口查询应用密钥,查询量较大或者超过频率限制需要传,登录后获取。
format string GET请求,返回格式,默认json,其他可选:xml、ip、jsonp
传ip时其他参数失效,只返回请求者IP,常用于软件开发获取用户外网IP。
callback string GET请求,返回节点,默认callback,当format=xml或jsonp时有效。
字段名 类型 必返 说明
code int code=1查询成功,code=0查询失败,msg返回失败原因
ip string 查询的IP
address_net string 解析地址A,优于address地址
address string 解析地址B,建议address_net没结果才取这个地址
prov string 省份
city string *城市
district string *区域
town string *镇街道
*注意:‌移动数据流量IP范围复杂,会出现跨城市、区、镇街道,接口只返回对应IP最近出现次数最多的区域,可能会和期望的有误差。
  • 成功示例
  • 失败示例
{
    "code": 1,
    "ip": "8.8.8.8",
    "detail": "电信",
    "address_net": "广东省深圳市龙岗区南湾街道 电信",
    "continent": "亚洲",
    "country": "中国",
    "isp": "电信",
    "prov": "广东省",
    "city": "深圳市",
    "district": "龙岗区",
    "town": "南湾街道",
    "owner": "电信",
    "address": "广东省深圳市",
    "msg": ""
}
{
    "code": 0,
    "ip": "8.8.8.8",
    "detail": "",
    "address_net": "超过频率限制",
    "continent": "",
    "country": "",
    "isp": "",
    "prov": "",
    "city": "",
    "district": "",
    "town": "",
    "owner": "",
    "address": "超过频率限制",
    "msg": "超过频率限制"
}