| 免费接口支持IPv4地址（限速每天50次，仅供测试） | ||
|---|---|---|
| 接口地址 | 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" // 世界大洲代码 , 可能不存在
]
}
|
|
| 新版地级市接口 | ||
|---|---|---|
| 接口地址 | http://ipapi.ipip.net/query/118.28.8.8 | |
| 请求方式 | HTTP GET | |
| Header | Token | cc87f3c77747bccbaaee35006da1ebb65e0bad57 |
| 示例 |
curl "https://ipapi.ipip.net/query/118.28.8.8" -H "Token: cc87f3c77747bccbaaee35006da1ebb65e0bad57" curl "https://ipapi.ipip.net/query/current" -H "Token: cc87f3c77747bccbaaee35006da1ebb65e0bad57" |
|
| 响应 |
{
ret : "ok", // ret 值为 ok 时 返回 data 数据 为err时返回msg数据
data: {
ip: "118.28.8.8",
location: {
country_name: "中国",
region_name: "天津",
city_name: "天津",
owner_domain: "",
isp_domain: "鹏博士",
latitude: "39.125032",
longitude: "117.295532",
timezone: "Asia/Shanghai",
utc_offset: "UTC+8",
china_admin_code: "120000",
idd_code: "86",
country_code: "CN",
continent_code: "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小时内调用次数
}
}
|
|
| 接口： | 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 | 为了得到最大请求数所等待的秒数 |
| 接口： | 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 | 为了得到最大请求数所等待的秒数 |
| 接口： | 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 | 为了得到最大请求数所等待的秒数 |
| 接口： | 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"
}]
}
}
|
|
| 接口： | 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" // 世界大洲代码 （每日版本提供）
]
}
|
|
© 2013 - 2025 北京天特信科技有限公司 所有权利保留
本网站 SSL 证书由 TRUSTASIA 提供
本网站安全防护服务由 上海云盾 提供
