IPv4 归属地查询接口

2026-08-18 技术分享大米酱

引言：为什么需要 IP 归属地查询？

在互联网应用开发中，「知道用户从哪里来」往往是很多功能的基础：

你想统计用户地域分布，为运营决策提供数据支撑；

你想在用户异地登录时给出风险提示，保障账号安全；

你想根据访客所在地区展示对应的语言、货币或本地化内容；

你想限制某些地区的访问，或者为不同地区分配不同的 CDN 节点……

这一切，都离不开 IP 归属地查询。

传统做法是接入第三方付费 IP 库或在线 API，但普遍存在两个痛点：贵（按次计费）和慢（外网请求有延迟、有被限流的风险）。

为此，大米API 新增了 IPv4 归属地查询接口（dm-ipquery），它使用本地离线数据库，毫秒级响应，免费开放给平台用户，帮助开发者用最少的成本完成地域相关的业务逻辑。

请求示例

https://www.qqsuu.cn/api/dm-ipquery?ip=123.55.6.12&key=你的API密钥

⚠️ 注意：平台所有接口请求必须携带密钥 key（在平台「获取 APIKEY」页面申请），否则请求将会失败。ip 参数可以不传，不传时接口会自动查询当前访客（本机）的 IP。

代码调用示例

curl（命令行）

# 指定 IP 查询
curl -X GET "https://www.qqsuu.cn/api/dm-ipquery?ip=123.55.6.12&key=你的API密钥"
# 查询本机 IP
curl -X GET "https://www.qqsuu.cn/api/dm-ipquery?key=你的API密钥"

Python（requests）

import requests

API_URL = "https://www.qqsuu.cn/api/dm-ipquery"
KEY = "你的API密钥"          # 替换为你的密钥

def query_ip(ip: str = "") -> dict:
    """查询 IP 归属地；ip 传空串则查询本机"""
    params = {"key": KEY}
    if ip:
        params["ip"] = ip
    resp = requests.get(API_URL, params=params, timeout=10)
    resp.raise_for_status()
    return resp.json()

if __name__ == "__main__":
    # 指定 IP
    result = query_ip("123.55.6.12")
    print(result)

    if result.get("code") == 0:
        data = result["data"]
        print(f"{data['ip']} -> {data['country']} {data['province']} {data['city']} {data['district']} {data['isp']}")

    # 本机 IP
    me = query_ip()
    if me.get("code") == 0:
        d = me["data"]
        print("我的 IP 归属地:", d["country"], d["province"], d["city"], d["district"], d["isp"])

PHP（file_get_contents）

<?php
$key = '你的API密钥';
$ip  = '123.55.6.12';

$url = "https://www.qqsuu.cn/api/dm-ipquery?ip=" . urlencode($ip) . "&key=" . $key;
$json = file_get_contents($url);
$data = json_decode($json, true);

if ($data['code'] === 0) {
    $d = $data['data'];
    echo $d['ip'] . ' 归属：' . $d['country'] . $d['province'] . $d['city'] . ' ' . $d['isp'] . PHP_EOL;
} else {
    echo '查询失败：' . $data['msg'] . PHP_EOL;
}