Dokumentacja API geolokalizacji IP

Darmowe API JSON do geolokalizacji IP, danych ASN i ryzyka. IPv4 i IPv6, HTTPS, włączony CORS.

Uzyskaj darmowy klucz API Specyfikacja OpenAPI

Szybki start

Do testów nie potrzebujesz rejestracji. Wywołaj poniższy endpoint bez klucza, aby otrzymać dane swojego IP (limit 100 zapytań dziennie).

curl https://iplookinfo.com/json

Uwierzytelnianie

Utwórz darmowy klucz API w panelu i wysyłaj go w nagłówku Authorization. Parametr zapytania token też działa przy szybkich testach, ale unikaj go na produkcji, bo adresy URL trafiają do logów.

Authorization: Bearer ipl_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Endpointy

GET/api/v1/{ip}: Sprawdź dowolny adres IPv4 lub IPv6.
GET/api/v1/me: Sprawdź własny IP wywołującego. Dostępne także pod /json.
POST/api/v1/batch: Sprawdź do 10 000 IP w jednym zapytaniu (plany płatne). Każdy IP liczy się jako jedno zapytanie.

Parametry zapytania

lang — Język nazw miejsc: en, zh, es, pt, ru, ja. Domyślnie en.

Odpowiedź

Obiekt risk jest dołączany tylko w planach Pro i Business.

{
  "ip": "8.8.8.8",
  "version": "IPv4",
  "type": "unicast",
  "bogon": false,
  "network": "8.8.8.0/24",
  "continent": { "code": "NA", "name": "North America" },
  "country": { "code": "US", "name": "United States", "is_eu": false },
  "region": null,
  "city": null,
  "postal": null,
  "location": { "latitude": 37.751, "longitude": -97.822, "accuracy_radius_km": 1000, "time_zone": "America/Chicago" },
  "asn": { "asn": 15169, "name": "Google LLC", "domain": "google.com", "route": "8.8.8.0/24" },
  "isp": { "name": "Google", "organization": "Google", "is_mobile": false, "mobile_country_code": null, "mobile_network_code": null },
  "risk": { "score": 60, "is_tor": false, "is_vpn": false, "is_datacenter": true, "provider": "Google Cloud" }
}

Limity i błędy

Każda odpowiedź zawiera nagłówki X-RateLimit-Limit, X-RateLimit-Remaining i X-RateLimit-Reset. Limity resetują się o 00:00 UTC.

Błędy mają jednolity format JSON z kodem statusu HTTP:

HTTP/1.1 429 Too Many Requests

{ "error": { "code": "quota_exceeded", "message": "..." } }

400 invalid_ip / bad_request
401 invalid_key
403 plan_required
413 too_many
429 rate_limited / quota_exceeded

Nadwyżki

W planach płatnych możesz włączyć nadwyżki w panelu. Zapytania ponad dzienny limit są wtedy obsługiwane i rozliczane za każde 1000, do wybranego przez Ciebie miesięcznego limitu wydatków. Takie odpowiedzi zawierają nagłówek X-Overage-Units.

Przykłady kodu

cURL

curl -H "Authorization: Bearer $IPLOOKINFO_KEY" https://iplookinfo.com/api/v1/8.8.8.8

# Batch (paid plans)
curl -X POST -H "Authorization: Bearer $IPLOOKINFO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"ips":["8.8.8.8","1.1.1.1"]}' https://iplookinfo.com/api/v1/batch

JavaScript

const res = await fetch("https://iplookinfo.com/api/v1/8.8.8.8", {
  headers: { Authorization: `Bearer ${process.env.IPLOOKINFO_KEY}` },
});
if (!res.ok) throw new Error((await res.json()).error.message);
const data = await res.json();
console.log(data.country?.code, data.city);

Python

import os, requests

r = requests.get(
    "https://iplookinfo.com/api/v1/8.8.8.8",
    headers={"Authorization": f"Bearer {os.environ['IPLOOKINFO_KEY']}"},
    timeout=5,
)
r.raise_for_status()
data = r.json()
print(data["country"]["code"], data["asn"]["name"])

PHP

$ctx = stream_context_create(["http" => [
    "header" => "Authorization: Bearer " . getenv("IPLOOKINFO_KEY"),
]]);
$data = json_decode(file_get_contents("https://iplookinfo.com/api/v1/8.8.8.8", false, $ctx), true);
echo $data["country"]["code"];

Go

req, _ := http.NewRequest("GET", "https://iplookinfo.com/api/v1/8.8.8.8", nil)
req.Header.Set("Authorization", "Bearer "+os.Getenv("IPLOOKINFO_KEY"))
resp, err := http.DefaultClient.Do(req)
if err != nil { log.Fatal(err) }
defer resp.Body.Close()
var data map[string]any
json.NewDecoder(resp.Body).Decode(&data)