IPinfoBox

API डॉक्स

चालू प्लान वाले अकाउंट की API कुंजी से IP लुकअप करें। कुंजी को X-API-Key हेडर में डालें या एड्रेस में ?key= जोड़ें। 3 महीने के प्लान में प्रति दिन 5,000 तक लुकअप होते हैं; 6 और 12 महीने के प्लान में कोई दैनिक सीमा नहीं है। दैनिक उपयोग हर दिन 00:00 UTC पर रीसेट होता है। हर प्लान में प्रति सेकंड 20 तक लुकअप हो सकते हैं।

बेस URLhttps://ipinfobox.com/api/v1

एक 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 के लिए type, private या reserved होता है और लोकेशन मान null होते हैं।

विज़िटर जांच (privacy)

vpn, vpn_provider

एड्रेस सार्वजनिक VPN सर्वर सूची में है या नहीं, और प्रोवाइडर का नाम (पता न हो तो null)

tor

Tor Project की एग्ज़िट नोड सूची में है या नहीं

hosting, hosting_provider

आधिकारिक क्लाउड IP रेंज या होस्टिंग कंपनी के नेटवर्क में है या नहीं, और कंपनी का नाम

cloud_region

क्लाउड रेंज में होने पर उसका रीजन (जैसे us-east-1)

सूचियां रोज़ अपडेट होती हैं। जो VPN सूची में नहीं हैं और रेज़िडेंशियल प्रॉक्सी, false के रूप में लौटते हैं। प्राइवेट और विशेष 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)

त्रुटियां

400 invalid_ip

मान्य IP एड्रेस नहीं है।

401 invalid_api_key

कुंजी नहीं दी गई या गलत है।

402 no_subscription

आपका प्लान खत्म हो गया है। दोबारा भुगतान करें और तुरंत इस्तेमाल करें।

429 rate_limited / daily_limit

बहुत ज़्यादा रिक्वेस्ट, या आज का उपयोग खत्म हो गया है।