تخطي إلى المحتوى
POST AI agent ready /v1/ip/lookup

IP Geolocation API - بحث مجاني عن عنوان IP

إرجاع بيانات الموقع الجغرافي لعنوان IP، بما في ذلك البلد والمدينة والمنطقة والإحداثيات والمنطقة الزمنية ورقم ASN ومركز بيانات Cloudflare. إذا لم يتم توفير IP، فسيتم استخدام IP الخاص بالمتصل.

Parameters

string

IPv4 or IPv6 address to geolocate. Omit to look up the caller's own IP.

Code examples

curl -X POST https://api.botoi.com/v1/ip/lookup \
  -H "Content-Type: application/json" \
  -d '{"ip":"203.0.113.1"}'

When to use this API

تخصيص المحتوى حسب موقع الزائر

اكتشف بلد ومدينة الزائر عند تحميل الصفحة لإظهار خيارات الأسعار أو اللغة أو الشحن المحلية. يمكن لصفحة الخروج SaaS استدعاء نقطة النهاية هذه لملء محدد العملة مسبقًا استنادًا إلى رمز بلد الزائر.

تسجيل الاحتيال في خطوط الدفع

قارن الموقع الجغرافي لـ IP لمعاملة ما بعنوان إرسال الفواتير الموجود في الملف. ضع علامة على الطلبات التي ينتقل فيها عنوان IP إلى بلد مختلف عن جهة إصدار البطاقة، وقم بتوجيه المعاملات التي تم وضع علامة عليها من خلال المراجعة اليدوية.

تسجيل الامتثال لعمليات تدقيق الوصول

سجل البلد والمنطقة التي قام فيها كل مسؤول بتسجيل الدخول إلى لوحة التحكم الداخلية. قم بإنشاء تقرير شهري لأحداث الوصول مجمعة حسب المنطقة الجغرافية لتلبية متطلبات تدقيق SOC 2 أو القانون العام لحماية البيانات.

Frequently asked questions

ما مدى دقة بيانات تحديد الموقع الجغرافي IP؟
الدقة على مستوى الدولة أعلى من 99%. تختلف الدقة على مستوى المدينة حسب المنطقة ولكنها تتراوح عادةً بين 80 و90% لمقدمي خدمات الإنترنت الرئيسيين. قد تنتقل عناوين IP وشبكات VPN الخاصة بشركة الجوال إلى المقر الرئيسي لشركة الاتصالات بدلاً من الموقع الفعلي للمستخدم.
هل تدعم نقطة النهاية هذه عناوين IPv6؟
نعم. قم بتمرير أي عنوان IPv6 صالح في حقل IP. تتضمن الاستجابة نفس حقول تحديد الموقع الجغرافي مثل عمليات بحث IPv4.
ماذا يحدث إذا حذفت معلمة ip؟
تقوم نقطة النهاية بإرجاع بيانات الموقع الجغرافي لعنوان IP الخاص بالمتصل. يعد هذا مفيدًا لاكتشاف موقع زائر موقع الويب دون أي جافا سكريبت من جانب العميل.
ما هو حقل ASN؟
ASN يعني رقم النظام المستقل. فهو يحدد مشغل الشبكة (مثل Comcast أو AWS أو Cloudflare) الذي يمتلك كتلة عنوان IP. يمنحك الحقل as_organization اسمًا يمكن للإنسان قراءته.
هل هناك حد للسعر على نقطة النهاية هذه؟
تقتصر الطلبات المجهولة على 5 طلبات في الدقيقة بناءً على عنوان IP الخاص بك. تحصل الطلبات التي تمت مصادقتها باستخدام مفتاح API على حدود أعلى اعتمادًا على خطتك.

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.