واجهة API للاستعلام عن IPv4
الدولة والمنطقة والمدينة والإحداثيات التقريبية والمنطقة الزمنية، والشبكة والمشغّل الذي يقف خلفها، ومؤشرات مراكز البيانات والوكلاء، وكتلة تهديدات تبيّن هل أُبلغ عن العنوان بسبب إساءة استخدام أو هجمات، ومدى خطورة ذلك. إذا حذفت المعامل ip فستحصل على عنوان المستدعي نفسه، وهي الحالة الشائعة في المواقع الإلكترونية.
مثال
$ curl -H "X-API-Key: YOUR_KEY" "https://api.mygeocode.com/v1/ipv4?ip=8.8.8.8"
# The caller's own address
$ curl -H "X-API-Key: YOUR_KEY" "https://api.mygeocode.com/v1/ipv4"تحديد موقع عنوان IP على مستوى المدينة تقدير، وسيبقى كذلك دائمًا، فالعنوان يعود إلى شبكة لا إلى شخص. الدولة صحيحة لأكثر من 99% من العناوين بفارق كبير. والمدينة أكثر موثوقية لدى مزوّدي الإنترنت المنزليين وأقل موثوقية لدى مشغّلي الهاتف المحمول ومراكز البيانات، ولهذا نضع عليها مؤشرات.
{
"status": "ok",
"ip": "1.0.164.165",
"version": 4,
"found": true,
"prefix": "1.0.164.0/24",
"country": "Thailand",
"country_code": "TH",
"continent": "Asia",
"continent_code": "AS",
"region": "Krung Thep Maha Nakhon",
"region_code": null,
"city": "Bangkok",
"postcode": "10200",
"lat": 13.749976,
"lon": 100.516819,
"timezone": "Asia/Bangkok",
"utc_offset": "+07:00",
"utc_offset_seconds": 25200,
"is_eu": false,
"asn": 23969,
"as_name": "TOT Public Company Limited",
"org": "TOT Public Company Limited",
"usage_type": "Eyeball",
"registry": "apnic",
"allocated": "2008-10-22",
"tags": ["dsl"],
"is_anycast": false,
"is_satellite": false,
"is_datacenter": false,
"is_proxy": false,
"is_vpn_provider": false,
"is_tor": false,
"is_private": false,
"abuse_email": "abuse@totisp.net",
"threat": {
"listed": true,
"score": 90,
"source_count": 2,
"categories": ["abuse", "attacker"],
"is_tor": false,
"is_tor_exit": false,
"is_bogon": false,
"listings": [
{ "category": "abuse", "confidence": 100, "recency_days": 1 },
{ "category": "attacker", "confidence": null, "recency_days": null }
]
},
"updated_at": "2026-09-18 06:53:39"
}ما تحصل عليه
| الحقل | المعنى |
|---|---|
country, country_code | اسم الدولة ورمزها وفق ISO 3166-1 alpha-2. |
region, region_code | الولاية أو المقاطعة أو ما يعادلها، مع رمزها وفق ISO 3166-2 إن وُجد. |
city, postcode | أفضل تقدير للمدينة والرمز البريدي. يغيب عند عدم معرفته. |
lat, lon | إحداثيات المدينة، أو مركز المنطقة أو الدولة إن تعذّر ذلك. |
timezone | اسم IANA، مستنتجًا من الموقع. |
asn, org | رقم النظام المستقل والمؤسسة التي تعلن عن البادئة. |
is_datacenter | العنوان ضمن نطاق استضافة أو حوسبة سحابية. اعتبر المدينة غير موثوقة وضع في الحسبان أن الحركة قد تكون آلية. |
is_proxy, is_tor, is_vpn_provider | دليل خاص بكل عنوان على كونه مرحّل Tor أو مدرجًا في قوائم الوكلاء، وبشكل منفصل، هل يبيع المشغّل خدمات VPN أصلًا. |
usage_type, tags, registry, allocated, abuse_email | نوع المشغّل الذي يدير الشبكة، ووسومه، والسجل الذي خصّصها ومتى، وجهة الاتصال الخاصة بالإبلاغ عن الإساءة. |
threat | كتلة السمعة: مدرج أم لا، ودرجة من 0 إلى 100، وعدد البلاغات المستقلة التي تدرج العنوان وفي أي فئات، ومؤشرات Tor وbogon، وكل إدراج مع درجة الثقة فيه وعمره. تُحدَّث يوميًا. |
أين تُستخدم
تخصيص الزيارة الأولى محليًا
اختر الدولة والعملة واللغة ووحدات القياس الافتراضية قبل أن يكتب الزائر أي شيء. مرّر عنوان الزائر في ip من خادمك.
مؤشرات الاحتيال وإساءة الاستخدام
قارن دولة عنوان IP بدولة الفوترة. تعامل مع is_proxy وis_datacenter على أنهما مؤشران لا حكمان نهائيان.
تحليلات دون ملفات تعريف الارتباط
اجمع الزيارات حسب الدولة والمنطقة على الخادم من سجلات الوصول، دون أي تتبّع من جهة العميل.
السعر والحدود
الاستدعاء الواحد طلب واحد، وكل عنوان في الدفعة يُحتسب طلبًا. لكل مفتاح 2,500 طلب مجاني يوميًا، وبعد ذلك يُخصم 0.0001 € لكل طلب من الرصيد المسبق الدفع، أو لا شيء على مفتاح Unlimited (50 € شهريًا). الأسعار. هل تنتقل من ip-api أو ipinfo أو ipstack؟ تتوفر هذه التنسيقات كمضيفات بديلة متوافقة. لعناوين IPv6 راجع واجهة API للاستعلام عن IPv6.