Developer Documentation

# Get your public IP as JSON
curl https://ippubblico.org/?api=1

{
  "status": "ok",
  "ip":     "93.45.12.88",
  "ipv4":  "93.45.12.88",
  "ipv6":  null,
  "isp":   "Fastweb SPA",
  "asn":   "AS30722",
  "tz":    "Europe/Rome",
  "dt":    "2026-05-26T14:30:00+02:00",
  "city":  "Naples",
  "region":"Campania",
  "country":"Italy",
  "lat":   40.85,
  "lon":   14.26,
  "cached":false
}

93.45.12.88
NONE

# Japanese — city/region/country in Japanese
curl "https://ippubblico.org/?api=1&lang=ja"

# Chinese simplified
curl "https://ippubblico.org/?api=1&lang=zh"

# Russian
curl "https://ippubblico.org/?api=1&lang=ru"

import requests

# Set lang=ja to get geo fields in Japanese
data = requests.get("https://ippubblico.org/?api=1", params={"lang": "ja"}).json()

print(data["geo"]["city"])     # 東京
print(data["geo"]["region"])   # 東京都
print(data["geo"]["country"])  # 日本

// Detect user language and request localized geo fields
const lang = navigator.language.split("-")[0]; // e.g. "ja", "zh", "ru"
const res  = await fetch(`https://ippubblico.org/?api=1&lang=${lang}`);
const data = await res.json();

console.log(data.geo.city);    // localized city name
console.log(data.geo.country); // localized country name

const data = await (await fetch("https://ippubblico.org/?api=1")).json();
document.getElementById("my-ip").textContent = data.ip;

# Full JSON (IPv4 + IPv6 + ISP + ASN + geolocation)
curl https://ippubblico.org/?api=1

# Plain text — IPv4 and IPv6 on two lines
curl https://ippubblico.org/?text=1

# IPv4 address only (or NONE)
curl https://ipv4.ippubblico.org/

# IPv6 address only (or NONE)
curl https://ipv6.ippubblico.org/

# Pretty print JSON with jq
curl -s https://ippubblico.org/?api=1 | jq .

package main

import (
    "encoding/json"
    "fmt"
    "net/http"
)

type IPData struct {
    IP      string  `json:"ip"`
    Country string  `json:"country"`
    ISP     string  `json:"isp"`
    Lat     float64 `json:"lat"`
    Lon     float64 `json:"lon"`
}

func main() {
    resp, _ := http.Get("https://ippubblico.org/?api=1")
    defer resp.Body.Close()
    var d IPData
    json.NewDecoder(resp.Body).Decode(&d)
    fmt.Println(d.IP, d.Country)
}

import requests

# Allowed countries for your service
ALLOWED = {"Italy", "Germany", "France", "Spain"}

def check_access():
    data = requests.get("https://ippubblico.org/?api=1", timeout=5).json()
    country = data.get("country", "")
    if country not in ALLOWED:
        raise PermissionError(f"Access denied from {country}")
    return data

# Fraud detection — IP country vs billing country
def verify_checkout(billing_country: str) -> bool:
    data = requests.get("https://ippubblico.org/?api=1", timeout=5).json()
    ip_country = data.get("country", "")
    is_datacenter = data.get("asn", "").startswith(("AS14618", "AS16509", "AS15169"))
    if is_datacenter:
        return False  # AWS / GCP / Azure — likely VPN/proxy
    return ip_country == billing_country

// Poll every 60 seconds, alert on IP change
let lastIP = null;

setInterval(async () => {
  const data = await (await fetch("https://ippubblico.org/?api=1")).json();
  if (lastIP && data.ip !== lastIP) {
    console.warn(`IP changed: ${lastIP} → ${data.ip}`);
    // trigger alert, update DNS, notify team...
  }
  lastIP = data.ip;
}, 60_000);

import requests, time

def get_ip_data(retries=3, timeout=5):
    for attempt in range(retries):
        try:
            r = requests.get("https://ippubblico.org/?api=1", timeout=timeout)
            r.raise_for_status()
            data = r.json()
            if data.get("status") == "partial":
                # IP ok, location fields may be null
                pass
            return data
        except (requests.RequestException, ValueError):
            if attempt == retries - 1:
                return None  # fail gracefully
            time.sleep(2 ** attempt)  # exponential backoff

# What is my IPv4?
curl https://ipv4.ippubblico.org/

# What is my IPv6?
curl https://ipv6.ippubblico.org/

# Full JSON (uses OS default stack — usually IPv6 preferred)
curl https://ippubblico.org/?api=1