Python哪些免费API接口可以用于查询IP地址所属地区？

在Python开发中，查询IP地址所属地区是常见需求，比如统计用户分布、做地域化内容推荐等。下面先给大家展示一张相关示意图，帮助理解IP查询的基本逻辑。

一、常用的免费IP查询API接口

1. ip-api接口

这是目前使用比较广泛的免费接口，支持批量查询，免费版每分钟限制45次请求，返回的数据包含国家、地区、城市、经纬度等信息，稳定性较好。

2. ipinfo接口

免费版每月有5万次请求额度，返回信息包含IP所属的国家、地区、城市、ISP等，还支持返回IP的隐私类型，比如是否为代理IP。

3. 纯真IP库离线接口

如果不想依赖网络请求，也可以使用纯真IP库的离线数据，通过Python的第三方库调用本地数据库查询，没有请求次数限制，适合对查询频率要求高的场景。

二、Python调用示例

1. 调用ip-api接口示例

使用requests库发送HTTP请求，解析返回的JSON数据即可，代码如下：

import requests

def query_ip_region(ip):
    # ip-api的免费查询接口，参数lang=zh返回中文结果
    url = f"http://ip-api.com/json/{ip}?lang=zh"
    try:
        response = requests.get(url, timeout=5)
        if response.status_code == 200:
            data = response.json()
            # 判断查询是否成功
            if data.get("status") == "success":
                return {
                    "国家": data.get("country"),
                    "地区": data.get("regionName"),
                    "城市": data.get("city"),
                    "ISP": data.get("isp")
                }
            else:
                return "查询失败，请检查IP地址是否正确"
        else:
            return f"请求失败，状态码：{response.status_code}"
    except Exception as e:
        return f"请求异常：{str(e)}"

# 测试查询百度公共DNS的IP
result = query_ip_region("180.76.76.76")
print(result)

2. 调用ipinfo接口示例

ipinfo的免费接口需要注册获取token，调用时带上token参数即可，代码如下：

import requests

def query_ip_region_ipinfo(ip, token):
    # 替换为你自己的ipinfo免费token
    url = f"https://ipinfo.io/{ip}?token={token}"
    try:
        response = requests.get(url, timeout=5)
        if response.status_code == 200:
            data = response.json()
            return {
                "国家": data.get("country"),
                "地区": data.get("region"),
                "城市": data.get("city"),
                "ISP": data.get("org")
            }
        else:
            return f"请求失败，状态码：{response.status_code}"
    except Exception as e:
        return f"请求异常：{str(e)}"

# 填入你的token后测试
# result = query_ip_region_ipinfo("180.76.76.76", "你的token")
# print(result)

三、使用注意事项

• 免费接口都有调用频率限制，不要短时间内大量请求，否则会被封禁IP，高频率需求建议使用离线数据库。
• 部分接口返回的字段名称有差异，对接时需要根据接口文档调整字段映射。
• 如果查询的是内网IP（如192.168.0.1、127.0.0.1），大部分公网接口无法返回有效地区信息，需要提前做IP类型判断。
• 调用第三方接口时建议加上超时设置，避免因为接口不可用导致程序阻塞。

四、接口对比

下面是几个接口的对比情况，方便你选择：

你可以根据自己的实际需求选择合适的接口，小批量查询优先选ip-api，高频查询选纯真离线库，需要更多ISP信息可以选ipinfo。

PythonIP地址查询免费API地区归属requests修改时间：2026-05-31 23:34:13