开放 API 平台

IP125 开放接口与开发文档

提供轻量、高可用、低延迟的公网 IP 数据查询接口，覆盖公网 IPv4 / IPv6 地理定位、网络运营商溯源及本机出口 IP 自检服务。

服务协议

HTTPS / TLS 1.3

CORS 跨域支持

Origin: *

数据响应格式

JSON (UTF-8)

认证方式

免 Key 直接调用

1. IP 归属地与网络运营商查询

GEThttps://ip125.com/api/geo/{ip}

根据指定的 IPv4 或 IPv6 地址，获取详细的国家、省份、城市、区县、ISP 运营商、自治系统编号（ASN）及经纬度坐标。

参数	位置	类型	必填	默认值	说明
ip	path	string	是	-	待查询的 IPv4 或 IPv6 地址（例：`8.8.8.8` 或 `2001:4860:4860::8888`）
lang	query	string	否	zh-CN	返回语言代码，支持 `zh-CN`（简体中文）或 `en`（英文）

在线接口实时调试

预设体验：

curl -X GET "https://ip125.com/api/geo/8.8.8.8?lang=zh-CN" \
  -H "Accept: application/json"

GEThttps://ip125.com/api/myip

极简、高响应速度的出口 IP 探测接口，直接返回发起 HTTP 请求的客户端公网 IPv4 或 IPv6 地址。常用于服务器初始化脚本、CI/CD 流水线或客户端自身外网地址自检。

获取您的当前出口 IP 测试

# 方式 1: 直接获取 JSON
curl -s https://ip125.com/api/myip

# 方式 2: 使用 jq 提取纯 IP 字符串
curl -s https://ip125.com/api/myip | jq -r .ip

{
  "ip": "203.0.113.195"
}

不需要。所有公开接口均免认证直接开放调用，无需注册、无须传递任何密钥或 Token。

原生支持。/api/geo/{ip} 支持标准 IPv4 与 IPv6（包含压缩格式），/api/myip 会根据客户端当前发起 HTTP 连接的网络栈返回对应的 IPv4 或 IPv6 地址。

完全支持。所有响应头均默认包含 Access-Control-Allow-Origin: *，无论在任何域名下的前端单页面应用均可无障碍跨域调用。

IP 地址对应的地理与网络属性具有较长稳定性，强烈建议在业务服务端引入 Redis 或内存缓存层（例如设置 1 ~ 7 天 TTL），以获得小于 1ms 的极致业务响应速度并降低网络抖动风险。

CORS 跨域支持：所有接口响应头中均已配置 Access-Control-Allow-Origin: *，支持直接在前端单页面应用（Vue / React / 原生 JS）中发起 Fetch / Axios 请求。
缓存优化：IP 归属地在短期内具有极高静态性，强烈建议调用端（如 Redis 或前端 LocalStorage）按 IP 做适度缓存，避免重复网络开销。
合理调用频率：本站 API 对常规开发测试与合理业务查询保持完全免费开放；针对大规模爬取或高并发业务，请合理控制速率并添加必要重试机制。