واجهة برمجية مجانية للبحث عن عناوين IP
أعطِها عنوان IP لتحصل على دولته ومدينته ومشغّل الشبكة، وما إذا كان تابعًا لمركز بيانات أو VPN. بدون مفتاح. بدون تسجيل. بدون تكلفة.
- بدون مفتاح — استدعِها الآن من أي مكان
- CORS — تعمل من JavaScript في المتصفّح
- 60/min — لكل عميل، ولا حصة تُشترى
- JSON — مجموعة حقول ثابتة، ولا مفتاح ناقص أبدًا
جرّبها
هذا عنوان IP الخاص بك، جُلِب مباشرةً من الواجهة البرمجية عند تحميلك هذه الصفحة:
جارٍ التحميل...
نقاط النهاية
GET https://www.unblockmaster.com/api/v1/ip
تبحث عن عنوان IP الخاص بمن أجرى الطلب.
curl https://www.unblockmaster.com/api/v1/ip
GET https://www.unblockmaster.com/api/v1/ip/<ip>
تبحث عن أي عنوان IPv4 أو IPv6.
curl https://www.unblockmaster.com/api/v1/ip/8.8.8.8
الاستجابة
{
"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
}
| الحقل | يكتب | المعنى |
|---|---|---|
ip | string | العنوان الذي جرى البحث عنه. |
is_vpn | bool | null | تكون true عندما ينتمي العنوان إلى نطاق معروف لمركز بيانات أو VPN. أما null فتعني تعذّر إتمام البحث — وليست false. |
provider | string | مشغّل الشبكة، إن كان معروفًا. |
country | string | اسم الدولة بالإنجليزية. |
country_code | string | رمز ISO 3166-1 من حرفين. |
city | string | اسم المدينة، إن كان معروفًا. |
lat, lon | float | null | إحداثيات تقريبية للمدينة، لا للجهاز. |
كل حقل موجود دائمًا. والقيمة التي لا نملكها تكون سلسلة فارغة أو null، لا مفتاحًا ناقصًا — فيمكنك قراءة الاستجابة دون التحقّق من كل حقل.
من JavaScript
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
import requests
r = requests.get("https://www.unblockmaster.com/api/v1/ip/1.1.1.1", timeout=5)
print(r.json()["country"]) # Australia
حدود المعدّل والأخطاء
الحدّ هو 60 طلبًا في الدقيقة لكل عميل. وتحمل كل استجابة ناجحة الترويستين X-RateLimit-Limit وX-RateLimit-Remaining، فيمكنك التمهّل قبل بلوغ الحدّ لا بعده.
| حالة | error | متى |
|---|---|---|
| 400 | invalid_ip | جزء المسار ليس عنوان IPv4 أو IPv6 صالحًا. |
| 405 | method_not_allowed | أي طريقة غير GET أو HEAD أو OPTIONS. |
| 429 | rate_limited | تجاوزت الحدّ. التزم بترويسة Retry-After. |
الاستخدام العادل
- مجاني للاستخدام الشخصي والتجاري. لا يلزم الإسناد — وإن كان رابط العودة موضع ترحيب دائمًا.
- خزّن النتائج مؤقتًا لديك حيثما أمكن. فالموقع الجغرافي لا يتغيّر من دقيقة لأخرى.
- نحتفظ بكل عنوان في الذاكرة المؤقتة لمدة ساعة، فتصبح عمليات البحث المتكرّرة عن العنوان نفسه رخيصة لكلينا.
- لا نسجّل أي شيء عن العناوين التي تبحث عنها بخلاف سجلّات الوصول المعتادة لخادم الويب.
- هذه خدمة مجانية تُقدَّم ببذل أفضل جهد دون ضمان لاستمرارية التشغيل. لا تبنِ عليها شيئًا حسّاسًا للسلامة.
اطّلع على الواجهة البرمجية التي يعمل بها فاحص VPN لدينا أو ضمّن الأداة بدلًا من ذلك