IP Geolocation API. Kostenlos.

Nimm eine IPv4- oder IPv6-Adresse und bekomm Land, Region, Stadt, Koordinaten, Postleitzahl, Zeitzone und AS-Nummer zurück. Registriere dich, erstelle einen API-Key und los geht's.

Kostenlos registrieren API-Doku ansehen

IPv4 + IPv6

Beide Adressfamilien mit vollständiger Location- und ASN-Information.

8 000 Lookups / Tag kostenlos

Ohne Kreditkarte. Mehr als 4× der Free-Tier von IPinfo oder abstractapi.

Admin & Portal

Eigene Keys verwalten, Nutzung einsehen — alles im Portal.

API-Doku

Alle Endpoints brauchen einen gültigen API-Key im X-API-Key-Header.

GET/v1/lookup/{ip}

curl -H "X-API-Key: $KEY" https://api.geoips.info/v1/lookup/8.8.8.8

Beispiel-Response:

{
  "ip": "8.8.8.8",
  "ip_version": 4,
  "country_code": "US",
  "country_name": "United States of America",
  "region": "California",
  "city": "Mountain View",
  "latitude": 37.40599,
  "longitude": -122.07852,
  "zip": "94043",
  "timezone": "-08:00",
  "asn": 15169,
  "as": "Google LLC",
  "cidr": "8.8.8.0/24"
}

GET/v1/lookup/self

Gibt die Geo-Info zur eigenen Client-IP zurück.

curl -H "X-API-Key: $KEY" https://api.geoips.info/v1/lookup/self

POST/v1/lookup/batch

Bis zu 100 IPs auf einmal. Jede Batch-Anfrage zählt als 1 Request auf dein Rate-Limit.

curl -X POST -H "X-API-Key: $KEY" -H "Content-Type: application/json" \
  -d '{"ips":["1.1.1.1","2606:4700:4700::1111"]}' \
  https://api.geoips.info/v1/lookup/batch

Beispiel-Response:

{ "results": [ { "ip": "1.1.1.1", ... }, { "ip": "...", "ip_version": 6, ... } ] }

GET/v1/health

Ohne API-Key erreichbar. Für Uptime-Monitoring.

curl https://api.geoips.info/v1/health

Fehlercodes

Code	Bedeutung
400	Ungültige IP, private Range oder ungültiger Body.
401	X-API-Key fehlt oder ist ungültig.
429	Rate-Limit erreicht (per Minute oder per Tag). Retry-After-Header beachten.
500	Serverfehler.