免费接口(限速每天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"                  // 世界大洲代码        (每日版本提供)
    ]
}
             
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 禁止外泄,后果自负)。
一个token每日总请求数不能超过1000次,请使用全量接口。

国内天气城市列表

接口: http://weatherapi.ipip.net/area/china
请求: HTTP GET
请求头: Token 请联系我们获取
示例: curl http://weatherapi.ipip.net/area/china -H "Token: 1234567890"
响应:
{
    status: "ok", //接口正常响应返回 ok,非ok时候为异常信息
    result: [
        {
            area_code: "101010100",      //地区代码
            name_en: "beijing",          //地区名字拼音
            name: "北京",                 //地区名
            district_en: "beijing",      //城市名拼音
            district: "北京",             //城市名
            province_en: "beijing",      //省份名拼音
            province: "北京",             //身份名
        },
        ...
    ]
}

国内天气实况接口

接口: http://weatherapi.ipip.net/observe
请求: HTTP GET
参数: code 地区代码
示例: curl http://weatherapi.ipip.net/observe -H "Token: 1234567890"
响应:
{
    status: "ok", //接口正常响应返回 ok,非ok时候为异常信息
    result: {
        area_code: 101010100, //地区代码
        text: "雷阵雨",        //天气信息
        code: "04",           //天气代码(通过此代码对应图标)
        temp: "30",           //当前温度
        wd: "西南风",          //风向
        ws: "4-5级",          //风力
        humidity: "54",       //湿度
        last_updated: "2015-07-22 15:20"     //发布时间
    }
}

国内天气实况全量接口

接口: http://weatherapi.ipip.net/observe/all
请求方法: HTTP GET
请 求 头: Token 请联系我们获取
示例: curl http://weatherapi.ipip.net/observe/all -H "Token: 1234567890"
响应:
{
    status: "ok", //接口正常响应返回 ok,非ok时候为异常信息
    result: [
        {
            area_code: 101010100, //地区代码
            text: "雷阵雨",        //天气信息
            code: "04",           //天气代码(通过此代码对应图标)
            temp: "30",           //当前温度
            wd: "西南风",          //风向
            ws: "4-5级",          //风力
            humidity: "54",       //湿度
            last_updated: "2015-07-22 15:20"     //发布时间
        },
        ...
    ]
}

国内天气预报接口

接口: http://weatherapi.ipip.net/forecast3d
请求: HTTP GET
参数: code 地区代码
请 求 头: Token 请联系我们获取
示例: curl http://weatherapi.ipip.net/forecast3d -H "Token: 1234567890"
响应:
{
    status: "ok", //接口正常响应返回 ok,非ok时候为异常信息
    result: {
        area_code: 101010100,     //地区代码
        phone_code: "010",          //电话区号
        post_code: "100000",        //邮政编码
        last_updated: "2015-07-22 11:00",   //更新时间
        forecast: [
            {
                date: "2015-07-22",     //日期
                code1: "04",            //白天天气代码(通过此代码对应图标)
                code2: "04",            //夜晚天气代码(通过此代码对应图标)
                text: "雷阵雨",         //天气信息
                high: "30",             //最高温度
                low: "21",              //最低温度
                wind: "无持续风向微风",    //风力风向信息
                sunrise: "05:03",       //日出时间
                sunset: "19:37"         //日落时间
            },
            {
                date: "2015-07-23",
                code1: "04",
                code2: "04",
                text: "雷阵雨",
                high: "30",
                low: "21",
                wind: "无持续风向微风",
                sunrise: "05:04",
                sunset: "19:37"
            },
            {
                date: "2015-07-24",
                code1: "00",
                code2: "01",
                text: "晴/多云",
                high: "32",
                low: "21",
                wind: "无持续风向微风",
                sunrise: "05:05",
                sunset: "19:36"
            }
        ]
    }
}

国内天气预报全量接口

接口: http://weatherapi.ipip.net/forecast3d/all
请求: HTTP GET
请求头: Token 请联系我们获取
示例: curl http://weatherapi.ipip.net/forecast3d/all -H "Token: 1234567890"
响应:
{
    status: "ok",  //接口正常响应返回 ok,非ok时候为异常信息
    result: [
        {
            area_code: 101010100,     //地区代码
            phone_code: "010",          //电话区号
            post_code: "100000",        //邮政编码
            last_updated: "2015-07-22 11:00",   //更新时间
            forecast: [
                {
                    date: "2015-07-22",     //日期
                    code1: "04",            //白天天气代码(通过此代码对应图标)
                    code2: "04",            //夜晚天气代码(通过此代码对应图标)
                    text: "雷阵雨",         //天气信息
                    high: "30",             //最高温度
                    low: "21",              //最低温度
                    wind: "无持续风向微风",    //风力风向信息
                    sunrise: "05:03",       //日出时间
                    sunset: "19:37"         //日落时间
                },
                {
                    date: "2015-07-23",
                    code1: "04",
                    code2: "04",
                    text: "雷阵雨",
                    high: "30",
                    low: "21",
                    wind: "无持续风向微风",
                    sunrise: "05:04",
                    sunset: "19:37"
                },
                {
                    date: "2015-07-24",
                    code1: "00",
                    code2: "01",
                    text: "晴/多云",
                    high: "32",
                    low: "21",
                    wind: "无持续风向微风",
                    sunrise: "05:05",
                    sunset: "19:36"
                }
            ]
        },
        ...
    ]
}
天气代码 天气描述 天气代码 天气描述
00 01 多云
02 03 阵雨
04 雷阵雨 05 雷阵雨伴有冰雹
06 雨夹雪 07 小雨
08 中雨 09 大雨
10 暴雨 11 大暴雨
12 特大暴雨 13 阵雪
14 小雪 15 中雪
16 大雪 17 暴雪
18 19 冻雨
20 沙尘暴 21 小到中雨
22 中到大雨 23 大到暴雨
24 暴雨到大暴雨 25 大暴雨到特大暴雨
26 小到中雪 27 中到大雪
28 大到暴雪 29 浮沉
30 扬沙 31 强沙尘暴
53 99
32 浓雾 49 强浓雾
54 中度霾 55 重度霾
56 严重霾 57 大雾
58 特强浓雾

国内天气图标下载

接口: http://weatherapi.ipip.net/icon
请求: HTTP GET
请求头: Token 请联系我们获取
示例: curl http://weatherapi.ipip.net/icon -H "Token: 1234567890"
响应:
weather_icon.zip文件下载

国内部分城市空气质量指数(免费为购买天气数据用户提供)

接口: http://weatherapi.ipip.net/pm25all
请求: HTTP GET
请求头: Token 请联系我们获取
示例: curl http://weatherapi.ipip.net/pm25all -H "Token: 1234567890"
响应:
{
    status: "ok",  //接口正常响应返回 ok,非ok时候为异常信息
    result: [
        {
            area_code: 101020100, // 地区代码
            area_name: "上海",     // 地区名称
            aqi: 64,              // 空气质量指数
            pm25: 45,             // pm2.5
            pm10: 68,             // pm10
            so2: 7,               // 二氧化硫1小时平均
            no2: 30,              // 二氧化氮1小时平均
            co: 0.756,            // 一氧化碳1小时平均
            o3: 102,              // 臭氧1小时平均
            quality: "良",        // 空气质量指数类别,有“优、良、轻度污染、中度污染、重度污染、严重污染”6类
            last_updated: "2015-07-23 14:00:00" //更新时间
        },
        ...
    ]
}
国家区域代码 MCC(中国:460,中国香港:454,中国澳门:455,中国台湾:466)

通用基站接口

接口: http://cellapi.ipip.net/cell
请求: HTTP GET
参数: mcc 国家区域代码(说明)
mnc 运营商代码
lac 小区代码
cid 基站号
示例
curl "http://cellapi.ipip.net/cell?mcc=460&mnc=11&lac=28674&cid=117674802" -H "Token: 1234567890"
响应:
{
    ret: 0, //如果大于0,数据存在错误
    msg: '', // ret大于0时存在
    data: {
        province: "江西省",
        city: "抚州市",
        district: "东乡县",
        street: "恒安中路",
        street_number: "69号",
        location: {
            lng: 116.617199,
            lat: 28.2369
        }
    }
}

电信基站接口

接口: http://cellapi.ipip.net/cdma
请求: HTTP GET
参数: mcc 国家区域代码(说明)
mnc 运营商代码(安卓获取API)
lac 小区代码(安卓获取API)
cid 基站号(安卓获取API)
示例
curl "http://cellapi.ipip.net/cdma?mcc=460&mnc=14121&lac=91&cid=37523" -H "Token: 1234567890"
响应:
{
    ret: 0, //如果大于0,数据存在错误
    msg: '', // ret大于0时存在
    data: {
        province: "浙江省",
        city: "杭州市",
        district: "滨江区",
        street: "江陵路",
        street_number: "1865号",
        location: {
            lng: 120.2215193684,
            lat: 30.217117263028
        }
    }
}
错误码列表
ret 错误描述 备注
0 成功
100 Token错误
101 请求量余额不足
404 暂无数据