API belgeleri

Tek bir IP sorgulama

curl -H "X-API-Key: YOUR_KEY" https://ipinfobox.com/api/v1/8.8.8.8

{
  "ip": "8.8.8.8", "version": 4, "type": "public",
  "country": { "code": "US", "name": "United States", "name_en": "United States" },
  "region": "California", "city": "Mountain View", "continent": "NA",
  "location": { "lat": 37.422, "lon": -122.085 },
  "asn": { "number": 15169, "org": "Google LLC" },
  "privacy": { "vpn": false, "vpn_provider": null, "tor": false,
               "hosting": true, "hosting_provider": "Google", "cloud_region": null }
}

IPv6 da aynı şekilde çalışır. Özel ve özel amaçlı IP'lerde type değeri private veya reserved olur, konum değerleri null döner.

Ziyaretçi kontrolleri (privacy)

Listeler her gün yenilenir. Listede olmayan VPN'ler ve ev internet bağlantısı üzerinden çalışan proxy'ler false olarak döner. Özel ve özel amaçlı IP'lerde privacy null olur. Kontroller nasıl çalışır

Ziyaretçi IP'lerinde kullanım

// Node.js (Express): ask for extra verification when a sign-up comes from a VPN, Tor or a data center
app.post("/signup", async (req, res) => {
  const ip = req.headers["cf-connecting-ip"] ?? req.ip; // behind Cloudflare: CF-Connecting-IP
  const r = await fetch(`https://ipinfobox.com/api/v1/${ip}`, { headers: { "X-API-Key": process.env.IPINFOBOX_KEY } });
  const info = await r.json();
  if (info.privacy && (info.privacy.vpn || info.privacy.tor || info.privacy.hosting)) {
    return res.status(403).json({ error: "extra verification required" });
  }
  // continue sign-up
});

# Python
import requests
info = requests.get(f"https://ipinfobox.com/api/v1/{ip}", headers={"X-API-Key": KEY}, timeout=3).json()
risky = bool(info.get("privacy")) and (info["privacy"]["vpn"] or info["privacy"]["tor"] or info["privacy"]["hosting"])

Kendi IP'nizi sorgulama

GET /api/v1/me        isteği gönderen adresin IP'si ve ayrıntıları

Kalan kullanım

GET /api/v1/usage     {"plan_ends_at":"2026-11-11T...","used_today":12,"daily_limit":5000}  (günlük sınırı olmayan planlarda null)

Hatalar