免费接口(限速每天1000次,仅供测试)
接口地址 http://freeapi.ipip.net/118.28.8.8
请求方式 HTTP GET
响应
    [
        "中国",
        "天津",
        "天津",
        ""
    ]
IP查询接口(付费用户专享 | 示例代码
接口地址 http://ipapi.ipip.net/find
请求方式 HTTP GET
参数 addr 118.28.8.8
Header Token cc87f3c77747bccbaaee35006da1ebb65e0bad57
示例 curl "http://ipapi.ipip.net/find?addr=118.28.8.8" -H "Token: cc87f3c77747bccbaaee35006da1ebb65e0bad57"
JSONP JS: http://ipapi.ipip.net/find?addr=118.28.8.8&callback=find&sid={sid}&uid={uid}&sig=签名算法 sid 与 uid 的值参见后台已购买服务列表
响应
{
    "ret": "ok",              // ret 值为 ok 时 返回 data 数据 为err时返回msg数据
    "data": [
        "中国",                // 国家
        "天津",                // 省会或直辖市
        "天津",                // 地区或城市 , 可能不存在
        "",                   // 学校或单位  , 可能不存在
        "鹏博士",              // 运营商字段  , 可能不存在
        "39.128399",          // 纬度 , 可能不存在
        "117.185112",         // 经度 , 可能不存在
        "Asia/Shanghai",      // 时区一, 可能不存在
        "UTC+8",              // 时区二, 可能不存在
        "120000",             // 中国行政区划代码  (仅中国)
        "86",                 // 国际电话代码  , 可能不存在
        "CN",                 // 国家二位代码  , 可能不存在
        "AP"                  // 世界大洲代码  , 可能不存在
    ]
}
             
查我的IP(付费用户专享)
接口地址 http://ipapi.ipip.net/find_myip
请求方式 HTTP GET
Header Token cc87f3c77747bccbaaee35006da1ebb65e0bad57
示例 curl "http://ipapi.ipip.net/find_myip" -H "Token: cc87f3c77747bccbaaee35006da1ebb65e0bad57"
响应
{
    ret : "ok", // ret 值为 ok 时 返回 data 数据 为err时返回msg数据
    data : {
        client_ip: "8.8.8.8" // 发起请求的客户端IP地址
    }
}
                    
API访问频率限制情况(付费用户专享)
接口地址 http://ipapi.ipip.net/find_status
请求方式 HTTP GET
Header Token cc87f3c77747bccbaaee35006da1ebb65e0bad57
示例 curl "http://ipapi.ipip.net/find_status" -H "Token: cc87f3c77747bccbaaee35006da1ebb65e0bad57"
响应
{
    ret : "ok", // ret 值为 ok 时 返回 data 数据 为err时返回msg数据
    data : {
        limit: false, // 是否已受访问限制
        hour: 99680,  // 一个小时内调用次数
        day: 999680,  // 24小时内调用次数
    }
}
                    
签名算法:md5("addr=" + ip + "&token=" + api_token)
此文档中的 Token(已作废) 为演示使用,购买服务后,我们会分配专属 Token(此 Token 禁止外泄,后果自负)。

IP高精度定位接口

接口: http[s]://ipapi.ipip.net/location/geo
请求: HTTP GET
参数: ip IP地址(不传值则为发起请求IP地址)
授权: token 付费后获取
示例:
curl "http://ipapi.ipip.net/location/geo?ip=123.121.9.220" -H "Token: 1234567890"
响应:
{
    code: 0,
    data: {
        ip:"123.121.9.220",
        longitude: 116.51124,    // IP定位经度WGS84
        latitude: 39.917572,     // IP定位纬度WGS84
        radius: 50,             // IP覆盖半径
        credibility: 100,      // 可信度 最大值为100(即为百分百可信任)
        gps_district: { // 高精度数据到区县等
            country_code: "CN",
            country: "中国",
            province: "北京",
            city: "北京",
            district: "朝阳区",
            china_code: "110105"
        },
        gps_aoi: [ // 高精度数据到商圈小区学校等
            {
                country_code: "CN",
                country: "中国",
                province: "北京",
                city: "北京",
                district: "朝阳区",
                china_code: "110105",
                aoi_type: "住宅小区",
                aoi_name: "朝阳园"
            },
            {
                country_code: "CN",
                country: "中国",
                province: "北京",
                city: "北京",
                district: "朝阳区",
                china_code: "110105",
                aoi_type: "商圈",
                aoi_name: "青年路商圈"
            }
        ]
        location:{ // 没有高精度数据时候的返回结果
            country: "中国",
            province: "北京",
            city: "北京"
        }
    }
}
请求响应头描述
Header 含义
X-Ratelimit-Limit 单用户每小时次数
X-RateLimit-Remaining 单用户每小时剩余次数
X-RateLimit-Used 单用户每小时使用次数
X-RateLimit-Reset 为了得到最大请求数所等待的秒数

WIFI接口

接口: http://ipapi.ipip.net/location/wifi
请求: HTTP GET
参数: bid mac地址 BSSID
ssid SSID
授权: token 付费后获取
示例:
curl "http://ipapi.ipip.net/location/wifi?mac=286c070a2669&ssid=fangzheng"  -H "Token: 1234567890"
响应:
{
    code: 0, // code 等于0说明请求成功
    error: "...." // code 不等于0时候的提示信息
    data: {
        longitude: 116.48943,   // WIFI定位经度WGS84
        latitude: 39.910435,    // WIFI定位经度WGS84
        gps_district: {
            country_code: "CN",    // 购买gps定位(区县包)后显示
            country: "中国",      // 购买gps定位(区县包)后显示
            province: "北京",   // 购买gps定位(区县包)后显示
            city: "北京",      // 购买gps定位(区县包)后显示
            district: "朝阳区",   // 购买gps定位(区县包)后显示
            china_code: "110105"    // 购买gps定位(区县包)后显示
        }
    }
}
请求响应头描述
Header 含义
X-Ratelimit-Limit 单用户每小时次数
X-RateLimit-Remaining 单用户每小时剩余次数
X-RateLimit-Used 单用户每小时使用次数
X-RateLimit-Reset 为了得到最大请求数所等待的秒数

通用基站接口

接口: http://ipapi.ipip.net/location/cell
请求: HTTP GET
参数: mcc 国家区域代码(默认:460;目前只支持中国)
mnc 运营商代码
lac 小区代码
cid 基站号
授权: token 付费后获取
示例
curl "http://ipapi.ipip.net/location/cell?lac=32888&cid=100543749&mnc=0&mcc=460"  -H "Token: 1234567890"
响应:
{
    code: 0,
    data: {
        longitude: 104.67404, // 基站定位经度WGS84
        latitude: 31.048662, // 基站定位纬度WGS84
        radius: 200,   // 基站覆盖半径
        gps_district: {
            country_code: "CN",   // 购买gps定位(区县包)后显示
            country: "中国",    // 购买gps定位(区县包)后显示
            province: "四川",   // 购买gps定位(区县包)后显示
            city: "德阳",      // 购买gps定位(区县包)后显示
            district: "中江县",   // 购买gps定位(区县包)后显示
            china_code: "510623"  // 购买gps定位(区县包)后显示
        }
    }
}
请求响应头描述
Header 含义
X-Ratelimit-Limit 单用户每小时次数
X-RateLimit-Remaining 单用户每小时剩余次数
X-RateLimit-Used 单用户每小时使用次数
X-RateLimit-Reset 为了得到最大请求数所等待的秒数

GPS经纬度定位接口

接口: http://ipapi.ipip.net/location/gps
请求: HTTP GET
参数: lat 纬度
lng 经度
授权: token 付费后获取
示例:
curl "http://ipapi.ipip.net/location/gps?lat=39.121121&lng=117.12121" -H "Token: 1234567890"
响应:
{
    code: 0,
    data: {
        longitude: 116.32599,
        latitude: 40.0023,
        gps_district: { // 如果已购AOI,此处不显示
            country_code: "CN",    // 购买gps定位(区县包)后显示
            country: "中国",      // 购买gps定位(区县包)后显示
            province: "北京",   // 购买gps定位(区县包)后显示
            city: "北京",      // 购买gps定位(区县包)后显示
            district: "朝阳区",   // 购买gps定位(区县包)后显示
            china_code: "110105"    // 购买gps定位(区县包)后显示
        }
        gps_aoi: [ // 数组,可多条
            {
                country_code: "CN",  // 购买gps定位(AOI)后显示
                country: "中国",  // 购买gps定位(AOI)后显示
                province: "北京",  // 购买gps定位(AOI)后显示
                city: "北京",  // 购买gps定位(AOI)后显示
                district: "海淀区",  // 购买gps定位(AOI)后显示
                china_code: "110108", // 购买gps定位(AOI)后显示
                aoi_type: "高校学院",  // 购买gps定位(AOI)后显示
                aoi_name: "清华大学"   // 购买gps定位(AOI)后显示
            }
        ]
    }
}
请求响应头描述
Header 含义
X-Ratelimit-Limit 单用户每小时次数
X-RateLimit-Remaining 单用户每小时剩余次数
X-RateLimit-Used 单用户每小时使用次数
X-RateLimit-Reset 为了得到最大请求数所等待的秒数

IP开放端口

接口: http://ipapi.ipip.net/v1/port
请求: HTTP GET
参数: ip IP地址
授权: token 付费后获取
示例:
curl "http://ipapi.ipip.net/v1/port?ip=8.8.8.8" -H "Token: 1234567890"
响应:
{
	"code": 0,
	"data": {
		"ip": "8.8.8.8",
		"is_proxy_maybe": false,
		"ports": [{
			"port": 53,
			"date": 20190608,
			"protocol": "dns"
		}]
	}
}

IP开放端口

接口: http://ipapi.ipip.net/v1/port
请求: HTTP GET
参数: ip IP地址
授权: token 付费后获取
示例:
curl "http://ipapi.ipip.net/v1/port?ip=8.8.8.8" -H "Token: 1234567890"
响应:
{
	"code": 0,
	"data": {
		"ip": "8.8.8.8",
		"is_proxy_maybe": false,
		"ports": [{
			"port": 53,
			"date": 20190608,
			"protocol": "dns"
		}]
	}
}
IP查询接口(付费用户专享 | 示例代码
接口地址 http://[example.com]/find
请求方式 HTTP GET
参数 addr 118.28.8.8
sign 0123456789012345678901234567890123456789 签名算法:请联系我们技术人员索取
示例 curl "http://[example.com]/find?addr=118.28.8.8&sign=0123456789012345678901234567890123456789"
响应
{
    "ret": "ok",              // ret 值为 ok 时 返回 data 数据 为err时返回msg数据
    "data": [
        "中国",                // 国家
        "天津",                // 省会或直辖市(国内)
        "天津",                // 地区或城市 (国内)
        "",                   // 学校或单位 (国内)
        "鹏博士",              // 运营商字段(只有购买了带有运营商版本的数据库才会有)
        "39.128399",          // 纬度     (每日版本提供)
        "117.185112",         // 经度     (每日版本提供)
        "Asia/Shanghai",      // 时区一, 可能不存在  (每日版本提供)
        "UTC+8",              // 时区二, 可能不存在  (每日版本提供)
        "120000",             // 中国行政区划代码    (每日版本提供)
        "86",                 // 国际电话代码        (每日版本提供)
        "CN",                 // 国家二位代码        (每日版本提供)
        "AP"                  // 世界大洲代码        (每日版本提供)
    ]
}
             
签名算法:请联系我们技术人员索取
行业报告
云计算服务商2017-1H
云计算服务商2017-2H
云计算服务商2018-1H
云计算服务商2018-2H
云计算服务商2019-1H
产品服务
IP 数据定位
IP 高精度定位
综合定位服务
网络安全基础数据
其他服务
BestTrace
Windows
Mac OS
iOS
Android
Linux
网络工具
Whois 查询
Country ASNs
Internet eXchange
Best NetTools
关于IPIP
公司简介
工作机会
联系我们
隐私声明
实验室
微信公共号

© 2013 - 2019 北京天特信科技有限公司 所有权利保留

京ICP备13047193号-1  京公网安备 11010802020247号

本网站安全防护服务由知道创宇云安全提供
本网站 SSL 证书由 TRUSTASIA 提供
本公司为 烽火台安全威胁情报联盟 成员