توثيق API

البحث عن IP واحد

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 بالطريقة نفسها. بالنسبة إلى عناوين IP الخاصة وعناوين IP المخصصة لأغراض خاصة، تكون قيمة type هي private أو reserved وتكون قيم الموقع null.

فحص الزوار (privacy)

تُحدَّث القوائم يوميًا. شبكات VPN غير المدرجة والبروكسي السكني تُرجع false. بالنسبة إلى عناوين IP الخاصة وعناوين IP المخصصة لأغراض خاصة، تكون قيمة privacy هي null. كيف تعمل الفحوصات

استخدامه مع عناوين IP الزوار

// 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"])

البحث عن IP الخاص بك

GET /api/v1/me        عنوان IP وتفاصيل العنوان الذي أرسل الطلب

الاستخدام المتبقي

GET /api/v1/usage     {"plan_ends_at":"2026-11-11T...","used_today":12,"daily_limit":5000}  (null في الخطط التي بلا حد يومي)

الأخطاء