IP-API

Authorization

Senden Sie Ihren Schlüssel im Authorization-Header. Geben Sie ihn niemals in einer URL oder im Frontend-Code weiter.

Authorization: Bearer dev_live_YOUR_KEY

https://dev.uk.app/api/v1

IP-API

IPv4- und IPv6-Geolokalisierung, Land, Stadt und ASN. Einzelabfragen und Stapel mit bis zu 50 Adressen.

curl 'https://dev.uk.app/api/v1/ip/lookup?ip=1.1.1.1&lang=uk' \
  -H 'Authorization: Bearer YOUR_API_KEY'

curl 'https://dev.uk.app/api/v1/ip/bulk' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: example-batch-001' \
  --data '{"ips":["1.1.1.1","8.8.8.8"]}'

IP geolocation is approximate. A batch accepts 1–50 public IPv4/IPv6 addresses. Invalid input rejects the whole batch without consuming monthly units. A successful batch of 50 addresses consumes 50 IP units.

Kontingente und Abrechnung

Alle Projekte und Schlüssel teilen sich die Kontingente des Kontos. Jede API hat ein eigenes Limit.

Die Monatskontingente werden am ersten Tag jedes UTC-Kalendermonats zurückgesetzt. Abonnements verlängern sich monatlich ab Kaufdatum. Weitere Anfragen werden mit HTTP 429 blockiert.

X-Quota-Limit: 10000
X-Quota-Remaining: 9999
X-Quota-Reset: 1793491200
X-Request-ID: 00000000-0000-0000-0000-000000000000

400 invalid input · 401 invalid key · 403 API scope denied · 409 idempotency conflict · 429 quota/rate limit · 503 upstream unavailable. Quota failures include Retry-After.

Optional Idempotency-Key protects retries for the same account, API, endpoint and input. Replays are free for ten minutes. The temporarily cached response is encrypted, then deleted. Request history retains only endpoint, status, units and timing for 30 days.

Datenquellen

Weather: Open-Meteo · IP: DB-IP Lite · CC BY 4.0. Retain attribution when displaying or redistributing data. Source information is included in API responses.

Try an API request

Senden Sie Ihren Schlüssel im Authorization-Header. Geben Sie ihn niemals in einer URL oder im Frontend-Code weiter.