API

Dieselben Antworten als JSON, ohne Schlüssel.

Aus einem Terminal

Ein curl auf die Startseite liefert Ihre Adresse als reinen Text und sonst nichts, sodass sie sich in einem Shell-Skript weiterverwenden lässt.

$ curl ipaddress.gg
203.0.113.42

Endpunkt

GET/api/plain

Your address as plain text, with a trailing newline. Nothing else.

curl ipaddress.gg

GET/api/ip

Your address with its routing origin and registry delegation, as JSON.

curl -s https://ipaddress.gg/api/ip

GET/api/ip/{address}

The same record for any IPv4 or IPv6 address.

curl -s https://ipaddress.gg/api/ip/8.8.8.8

GET/api/asn/{asn}

Holder, registry allocation and announced prefixes for an AS number.

curl -s https://ipaddress.gg/api/asn/15169

GET/api/dns?host={hostname}&type={type}

DNS records, resolved live. Omit type for every supported type.

curl -s 'https://ipaddress.gg/api/dns?host=example.com&type=MX'

GET/api/reverse-dns?ip={address}

PTR names for an address, with forward confirmation.

curl -s 'https://ipaddress.gg/api/reverse-dns?ip=8.8.8.8'

GET/api/whois?q={query}

RDAP record and raw WHOIS text for a domain, address or AS number.

curl -s 'https://ipaddress.gg/api/whois?q=example.com'

GET/api/blacklist?ip={address}

DNSBL status per list, with each list's own return code. Omit ip for your own.

curl -s 'https://ipaddress.gg/api/blacklist?ip=8.8.8.8'

POST/api/ports

Open ports on your own address. There is no way to name another target.

curl -sX POST https://ipaddress.gg/api/ports

GET/api/mac?q={address}

The vendor registered for a MAC address or OUI prefix, from the IEEE registry.

curl -s 'https://ipaddress.gg/api/mac?q=00:1A:2B:3C:4D:5E'

GET/api/ssl?host={hostname}

The TLS certificate a host serves, its chain, expiry and trust verdict.

curl -s 'https://ipaddress.gg/api/ssl?host=example.com'

GET/api/geo/cities?bbox={w,s,e,n}

Place names inside a map window, largest first. This is what the map labels itself from.

curl -s 'https://ipaddress.gg/api/geo/cities?bbox=28,40,30,41&limit=10'

GET/api/status

Dataset freshness and record counts. Used by the container healthcheck.

curl -s https://ipaddress.gg/api/status

Faire NutzungEs gibt keinen Schlüssel und kein Kontingent. Bitte cachen Sie, was Sie abrufen, und halten Sie Massenabfragen auf einem Tempo, das ein kleiner Server bedienen kann.