Ücretsiz IP Sorgulama API'si
Bir IP adresi verin; ülkesini, şehrini, ağ operatörünü ve bir veri merkezine ya da VPN'e ait olup olmadığını alın. API anahtarı yok. Kayıt yok. Ücret yok.
- Anahtar yok — hemen şimdi, her yerden çağırın
- CORS — tarayıcı JavaScript'inden çalışır
- 60/min — istemci başına, satın alınacak kota yok
- JSON — sabit alan kümesi, hiçbir zaman eksik anahtar yok
Deneyin
Bu, siz bu sayfayı açarken API'den canlı olarak alınan kendi IP'niz:
Yükleniyor...
Uç noktalar
GET https://www.unblockmaster.com/api/v1/ip
Çağrıyı yapanın kendi IP adresini sorgular.
curl https://www.unblockmaster.com/api/v1/ip
GET https://www.unblockmaster.com/api/v1/ip/<ip>
Herhangi bir IPv4 veya IPv6 adresini sorgular.
curl https://www.unblockmaster.com/api/v1/ip/8.8.8.8
Yanıt
{
"ip": "8.8.8.8",
"is_vpn": true,
"provider": "Google LLC",
"country": "United States",
"country_code": "US",
"city": "Mountain View",
"lat": 37.4056,
"lon": -122.0775
}
| Alan | Tip | Anlamı |
|---|---|---|
ip | string | Sorgulanan adres. |
is_vpn | bool | null | Adres bilinen bir veri merkezi veya VPN aralığına aitse true. null, sorgunun tamamlanamadığı anlamına gelir — false değil. |
provider | string | Biliniyorsa ağ operatörü. |
country | string | Ülke adı (İngilizce). |
country_code | string | İki harfli ISO 3166-1 kodu. |
city | string | Biliniyorsa şehir adı. |
lat, lon | float | null | Cihazın değil, şehrin yaklaşık koordinatları. |
Her alan her zaman bulunur. Elimizde olmayan bir değer boş dize ya da null olur, asla eksik anahtar olmaz — böylece yanıtı her alanı kontrol etmeden okuyabilirsiniz.
JavaScript ile
const res = await fetch("https://www.unblockmaster.com/api/v1/ip");
const data = await res.json();
if (data.is_vpn === true) {
console.log("Visitor is behind a VPN or proxy");
} else if (data.is_vpn === false) {
console.log("Visitor is on a residential connection");
} else {
console.log("Could not determine"); // upstream was unavailable
}
Python ile
import requests
r = requests.get("https://www.unblockmaster.com/api/v1/ip/1.1.1.1", timeout=5)
print(r.json()["country"]) # Australia
Hız sınırları ve hatalar
Sınır, istemci başına dakikada 60 istektir. Her başarılı yanıt X-RateLimit-Limit ve X-RateLimit-Remaining başlıklarını taşır; böylece sınıra çarptıktan sonra değil, çarpmadan önce yavaşlayabilirsiniz.
| Durum | error | Ne zaman |
|---|---|---|
| 400 | invalid_ip | Yol parçası geçerli bir IPv4 veya IPv6 adresi değil. |
| 405 | method_not_allowed | GET, HEAD veya OPTIONS dışındaki her şey. |
| 429 | rate_limited | Sınır aşıldı. Retry-After başlığına uyun. |
Adil kullanım
- Kişisel ve ticari kullanım için ücretsiz. Atıf zorunlu değil — yine de bir geri bağlantı her zaman memnuniyet verir.
- Mümkün olduğunda sonuçları kendi tarafınızda önbelleğe alın. Coğrafi konum dakika dakika değişmez.
- Her adresi bir saat önbellekte tutarız; böylece aynı IP'nin tekrar sorgulanması ikimiz için de ucuz olur.
- Sorguladığınız adresler hakkında, olağan web sunucusu erişim günlüklerinin ötesinde hiçbir kayıt tutmayız.
- Bu, çalışma süresi garantisi olmayan, elden geldiğince sunulan ücretsiz bir hizmettir. Güvenlik açısından kritik bir şeyi bunun üzerine inşa etmeyin.
VPN denetleyicimizin arkasındaki API'yi görün Ya da aracı doğrudan gömün