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
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 עברית