API डॉक्स
चालू प्लान वाले अकाउंट की API कुंजी से IP लुकअप करें। कुंजी को X-API-Key हेडर में डालें या एड्रेस में ?key= जोड़ें। 3 महीने के प्लान में प्रति दिन 5,000 तक लुकअप होते हैं; 6 और 12 महीने के प्लान में कोई दैनिक सीमा नहीं है। दैनिक उपयोग हर दिन 00:00 UTC पर रीसेट होता है। हर प्लान में प्रति सेकंड 20 तक लुकअप हो सकते हैं।
https://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)
torTor 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बहुत ज़्यादा रिक्वेस्ट, या आज का उपयोग खत्म हो गया है।