IPPubblico 公共API

免费公共IP API,无需身份验证。四个端点返回IPv4、IPv6、ISP、ASN、地理位置和时区——JSON或文本格式。

✓ 永久免费 ✓ 无需API密钥 ✓ 无速率限制 JSON & Plain text CORS enabled

基础URL endpoints

endpoints
# Full data (JSON)
https://ippubblico.org/?api=1

# IPv4 + IPv6 (plain text, 2 lines)
https://ippubblico.org/?text=1

# IPv4 only
https://ipv4.ippubblico.org/

# IPv6 only
https://ipv6.ippubblico.org/

端点 reference

GET https://ippubblico.org/?api=1 完整JSON响应

返回包含调用者IP地址所有可用数据的完整JSON对象。

curl
curl https://ippubblico.org/?api=1
Response — application/json
{
  "status":   "ok",
  "ip":       "93.45.12.88",
  "ipv4":     "93.45.12.88",
  "ipv6":     null,
  "isp":      "Telecom Italia S.p.A.",
  "asn":      "AS3269",
  "timezone": "Europe/Rome",
  "datetime": "2026-05-05T12:00:00+02:00",
  "geo": {
    "city":    "Rome",
    "region":  "Lazio",
    "country": "Italy",
    "lat":     41.9028,
    "lon":     12.4964
  },
  "headers":  { /* HTTP request headers */ },
  "cached":   false,
  "lang":     "en"
}
字段类型描述
statusstring"ok"或"partial"(地理位置失败时)
ipstring检测到的IP(可能是IPv4或IPv6)
ipv4string | nullIPv4地址(如可用)
ipv6string | nullIPv6地址(如可用)
ispstring | null互联网服务提供商名称
asnstring | null自治系统编号(如"AS3269")
timezonestring | nullIANA时区(如"Europe/Rome")
datetimestring调用者时区的ISO 8601日期/时间
geo.citystring | null近似城市名称
geo.regionstring | null地区/省份
geo.countrystring | null国家名称
geo.lat / geo.lonfloat | null近似坐标
cachedboolean如果结果来自1小时缓存则为true
本地化参数 添加?lang=xx以所需语言接收city、country和region。支持:de es fr ja pt ru zh。
curl — lang=ja
curl "https://ippubblico.org/?api=1&lang=ja"
// "city": "ナポリ", "country": "イタリア共和国"
GET https://ippubblico.org/?text=1 纯文本 — IPv4 + IPv6

在两行中分别返回IPv4和IPv6。如果协议不可用则返回NONE。

curl
curl https://ippubblico.org/?text=1
Response — text/plain
IPv4: 93.45.12.88
IPv6: NONE
GET https://ipv4.ippubblico.org/ 仅IPv4

以纯文本形式仅返回IPv4地址,如不可用则返回NONE。

curl
curl https://ipv4.ippubblico.org/
Response — text/plain
93.45.12.88
GET https://ipv6.ippubblico.org/ 仅IPv6

以纯文本形式仅返回IPv6地址,如不可用则返回NONE。

curl
curl https://ipv6.ippubblico.org/
Response — text/plain
2001:db8::1

代码示例 samples

bash / curl
# 获取完整JSON
curl https://ippubblico.org/?api=1

# 仅获取IPv4
MY_IP=$(curl -s https://ipv4.ippubblico.org/)
echo "My IPv4: $MY_IP"

# 仅获取IPv6
MY_IPV6=$(curl -s https://ipv6.ippubblico.org/)
echo "My IPv6: $MY_IPV6"
JavaScript (fetch)
// Full JSON
const res = await fetch('https://ippubblico.org/?api=1');
const data = await res.json();
console.log(data.ipv4, data.ipv6, data.geo.country);

// IPv4 only
const ipv4 = await fetch('https://ipv4.ippubblico.org/').then(r => r.text());
console.log('IPv4:', ipv4);
Python
import requests

# Full JSON
data = requests.get('https://ippubblico.org/?api=1').json()
print(data['ipv4'], data['geo']['country'])

# IPv4 only
ipv4 = requests.get('https://ipv4.ippubblico.org/').text.strip()
print(f'IPv4: {ipv4}')
PHP
// Full JSON
$data = json_decode(file_get_contents('https://ippubblico.org/?api=1'), true);
echo $data['ipv4'];

// IPv4 only
$ipv4 = trim(file_get_contents('https://ipv4.ippubblico.org/'));
Go
resp, _ := http.Get("https://ipv4.ippubblico.org/")
body, _ := io.ReadAll(resp.Body)
fmt.Println("IPv4:", strings.TrimSpace(string(body)))
PowerShell
$ip = (Invoke-WebRequest 'https://ipv4.ippubblico.org/').Content.Trim()
Write-Host "IPv4: $ip"
Ruby
require 'open-uri'
ipv4 = URI.open('https://ipv4.ippubblico.org/').read.strip
puts "IPv4: #{ipv4}"
C# / .NET
var client = new HttpClient();
var ipv4 = (await client.GetStringAsync("https://ipv4.ippubblico.org/")).Trim();
Console.WriteLine($"IPv4: {ipv4}");

注意事项 info

  • ✓ 无需身份验证 — 不需要API密钥或令牌
  • ✓ 已启用CORS — 可在任何域的浏览器JavaScript中使用
  • ✓ 1小时缓存 — 地理位置数据每个IP缓存1小时
  • ✓ IPv4子域 — ipv4.ippubblico.org通过DNS A记录强制IPv4连接
  • ✓ IPv6子域 — ipv6.ippubblico.org通过DNS AAAA记录强制IPv6连接
  • ⚠ 地理位置精度 — 近似城市/地区级别(约50公里)。不适用于法律或监视目的。
  • ⚠ 数据保留 — IP和元数据最多存储90天。不与第三方共享。

可用语言 43

完整网站提供43种语言版本。API本身与语言无关。

🇮🇹 IT Italiano ↗
🇬🇧 EN English ↗
🇩🇪 DE Deutsch ↗
🇫🇷 FR Français ↗
🇪🇸 ES Español ↗
🇧🇷 PT Português ↗
🇳🇱 NL Nederlands ↗
🇵🇱 PL Polski ↗
🇷🇴 RO Română ↗
🇨🇿 CS Čeština ↗
🇸🇪 SV Svenska ↗
🇩🇰 DA Dansk ↗
🇫🇮 FI Suomi ↗
🇭🇺 HU Magyar ↗
🇸🇰 SK Slovenčina ↗
🇧🇬 BG Български ↗
🇭🇷 HR Hrvatski ↗
🇸🇮 SL Slovenščina ↗
🇪🇪 ET Eesti ↗
🇱🇻 LV Latviešu ↗
🇱🇹 LT Lietuvių ↗
🇬🇷 EL Ελληνικά ↗
🇲🇹 MT Malti ↗
🇮🇪 GA Gaeilge ↗
🇷🇺 RU Русский ↗
🇺🇦 UK Українська ↗
🇯🇵 JA 日本語 ↗
🇨🇳 ZH 中文 ↗
🇮🇳 HI हिन्दी ↗
🇸🇦 AR العربية ↗
🇰🇷 KO 한국어 ↗
🇹🇷 TR Türkçe ↗
🇮🇩 ID Bahasa Indonesia ↗
🇻🇳 VI Tiếng Việt ↗
🇹🇭 TH ภาษาไทย ↗
🇲🇾 MS Bahasa Melayu ↗
🇳🇴 NB Norsk Bokmål ↗
🇵🇰 UR اردو ↗
🇹🇿 SW Kiswahili ↗
🇮🇷 FA فارسی ↗
🇧🇩 BN বাংলা ↗
🇵🇭 TL Filipino ↗
🇮🇱 HE עברית ↗