واجهة API للاستعلام عن IPv4

الدولة والمنطقة والمدينة والإحداثيات التقريبية والمنطقة الزمنية، والشبكة والمشغّل الذي يقف خلفها، ومؤشرات مراكز البيانات والوكلاء، وكتلة تهديدات تبيّن هل أُبلغ عن العنوان بسبب إساءة استخدام أو هجمات، ومدى خطورة ذلك. إذا حذفت المعامل ip فستحصل على عنوان المستدعي نفسه، وهي الحالة الشائعة في المواقع الإلكترونية.

GEThttps://api.mygeocode.com/v1/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.