免费接口(限速每天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: {
        longitude: 116.51124,    // IP定位经度WGS84
        latitude: 39.917572,     // IP定位纬度WGS84
        radius: 50,             // IP覆盖半径
        credibility: 100,      // 可信度 最大值为100(即为百分百可信任)
        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 为了得到最大请求数所等待的秒数

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/reputation
请求: HTTP GET
参数: ip IP地址
授权: token 付费后获取
示例:
curl "http://ipapi.ipip.net/reputation?ip=42.51.12.61" -H "Token: 1234567890"
响应:
{
    code: 0,
    data: {
        ip: "42.51.12.61",
        now: [ // 三个月内的行为标签
            "Robot", // 机器人
            "BruteForce", // 撞库
            "Spider", // 爬虫
            "Abuse", // 刷量
            "Botnet", // 僵尸网络
            "Spam", // 垃圾邮件
            "Fraud", // 欺诈
            "Malware", // 恶意软件
            "Proxy", // 代理
            "P2P", // 僵尸网络P2P节点
            "Hijacked", // 劫持
            "Exploit", // 漏洞利用
            "Attacks", // 网络攻击
            "Compromised", // 失陷主机
            "C2", // 远控
            "BlackDNS", // 黑DNS
            "Phishing", // 钓鱼
        ],
        history: [ // 三到六个月内的行为标签
            "Robot",
            "Botnet"
        ],
        origin_list: [// 来源
            {
                name: "Karma", // 数据来源
                date: 20171222, // 时间
                type: "Robot" // 行为标签
            },
            {
                name: "Karma",
                date: 20171222,
                type: "Botnet"
            }
        ],
        location: [
            "中国",   //国家
            "河南",   //省份
            "洛阳",   //城市
            "htu.cc", //所有者
            "电信/联通/移动", //运营商
            "34.663041" // 纬度(地区中心点)
            "112.434468", //经度(地区中心点)
        ],
        type: ["IDC"] //IP应用类别(UNKNOWN, CELL, IDC, ADSL, Reserved, LAN, Loopback, Backbone)
    }
}
请求响应头描述
Header 含义
X-Ratelimit-Limit 单用户每小时次数
X-RateLimit-Remaining 单用户每小时剩余次数
X-RateLimit-Used 单用户每小时使用次数
X-RateLimit-Reset 为了得到最大请求数所等待的秒数