واجهة برمجية مجانية للبحث عن عناوين IP

أعطِها عنوان IP لتحصل على دولته ومدينته ومشغّل الشبكة، وما إذا كان تابعًا لمركز بيانات أو VPN. بدون مفتاح. بدون تسجيل. بدون تكلفة.

جرّبها

هذا عنوان 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
}
الحقليكتبالمعنى
ipstringالعنوان الذي جرى البحث عنه.
is_vpnbool | nullتكون true عندما ينتمي العنوان إلى نطاق معروف لمركز بيانات أو VPN. أما null فتعني تعذّر إتمام البحث — وليست false.
providerstringمشغّل الشبكة، إن كان معروفًا.
countrystringاسم الدولة بالإنجليزية.
country_codestringرمز ISO 3166-1 من حرفين.
citystringاسم المدينة، إن كان معروفًا.
lat, lonfloat | 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متى
400invalid_ipجزء المسار ليس عنوان IPv4 أو IPv6 صالحًا.
405method_not_allowedأي طريقة غير GET أو HEAD أو OPTIONS.
429rate_limitedتجاوزت الحدّ. التزم بترويسة Retry-After.

الاستخدام العادل

اطّلع على الواجهة البرمجية التي يعمل بها فاحص VPN لدينا أو ضمّن الأداة بدلًا من ذلك