API تحديد الموقع الجغرافي بواسطة IP. مجاناً.

أدخل عنوان IPv4 أو IPv6 واحصل على البلد والمنطقة والمدينة والإحداثيات والمنطقة الزمنية و ASN بالإضافة إلى بيانات Whois/RDAP (netname، المنظمة، abuse contact). جرّبه فورًا بدون تسجيل، أو احصل على API-Key.

سجّل — إنها مجانية جرّب البحث عن IP اطلع على توثيق API

IPv4 + IPv6

كلتا عائلتَي العناوين مع معلومات موقع و ASN كاملة.

8,000 استعلام / يوم مجاناً

بدون بطاقة ائتمان. بيانات جغرافية كاملة و ASN. مثالي للمشاريع الترفيهية والأعمال الجانبية.

120 طلب/دقيقة · 8,000 طلب/يوم

Whois / RDAP مُضمَّن

اسم المنظمة، netname، abuse contact — حول العالم من جميع الـ 5 RIRs (RIPE/ARIN/APNIC/LACNIC/AFRINIC)، مخزَّن في الـ cache من أجل السرعة.

الإدارة والبوابة

أدر مفاتيحك الخاصة وتفقّد الاستخدام — كل ذلك في البوابة.

جارٍ تحميل معلومات IP الخاصة بك…

ما هي استخدامات API؟

حالات الاستخدام الشائعة لعملائنا

منع الاحتيال وتقييم المخاطر

اكتشف عمليات تسجيل الدخول المشبوهة من بلدان غير معتادة، وقم بحظر حركة البوتات من شبكات الاستضافة عبر ASN، وتحقق من الطلبات مقابل عنوان الشحن.

الامتثال والحظر الجغرافي

قَيِّد المحتوى للبلدان المسموح بها (GDPR، مناطق الترخيص، عقوبات مثل OFAC). مع اكتشاف دقيق للبلد/المنطقة — دون حظر مفرط.

تحليلات الويب والتخصيص

اعرض للزوار الأسعار بعملتهم المحلية، ووجّههم إلى متغير اللغة الصحيح، وقسّم التقارير حسب الأصل الجغرافي.

إدارة إساءة الاستخدام و DevOps

مع بيانات Whois/RDAP تجد جهة الاتصال للإبلاغ عن إساءة الاستخدام لأي IP — مثالي لتقارير البريد المزعج، تخفيف هجمات DDoS، والاستجابة للحوادث.

كيف يعمل

من التسجيل إلى أول بحث في 4 خطوات

1
أنشئ حسابًا
سجّل مجانًا بالبريد الإلكتروني. بدون بطاقة ائتمان. رابط التحقق في صندوق الوارد.
2
احصل على مفتاح API
أنشئ مفتاحًا بنقرة واحدة في البوابة. ضعه في رأس X-API-Key لطلباتك.
3
نفّذ بحثًا
GET /v1/lookup/{ip} يُرجع JSON يحتوي على الدولة، المدينة، الإحداثيات، ASN، المزود. استجابة أقل من 50 مللي ثانية من مراكز بيانات الاتحاد الأوروبي.
4
توسّع
لحجم أكبر: نقطة نهاية batch (تصل إلى 100 IP/طلب) أو ترقية الخطة. بيانات Whois/RDAP مضمنة في جميع الخطط.

كيف نتميز

ما يميزنا عن المزودين الآخرين

	GeoIPs	منافس نموذجي
خطة مجانية	8,000 استعلام / يوم	1,000 / يوم أو أقل
Whois / RDAP مضمن	نعم، في جميع الخطط	إضافة منفصلة
استعلامات batch	حتى 100 IP / طلب	غالبًا استدعاءات فردية فقط
متوافق مع GDPR	استضافة في الاتحاد الأوروبي (DE/AT)	غالبًا استضافة في الولايات المتحدة
نموذج التسعير	سعر شهري ثابت	الدفع لكل استدعاء قد يصبح مكلفًا

أعلام الدول والرموز التعبيرية

تتضمن كل استجابة API الرمز التعبيري للعلم بالإضافة إلى رابط SVG مباشر — جاهز للتضمين.

أمثلة

de

us

jp

br

in

ch

fr

za

رمز تعبيري في JSON

يحمل حقل `flag` رمز العلم التعبيري بترميز Unicode. يُعرض بشكل أصلي في المتصفحات الحديثة وiOS وAndroid — لا حاجة لأصول صور إضافية.

رابط SVG مُضمَّن

يشير حقل `flag_url` إلى SVG مُستضاف. يتم تكبيره دون فقدان الجودة، مثالي لملفات PDF والبريد الإلكتروني والمتصفحات القديمة بدون خط رموز تعبيرية.

271 دولة

جميع رموز الدول ISO 3166-1 alpha-2 متاحة. نمط الرابط: /flags/<code>.svg (أحرف صغيرة).

مُضمَّن في جميع الخطط

Free وStarter وBusiness وEnterprise — يحصل الجميع على نفس بيانات الأعلام دون تكلفة إضافية.

تضمين مباشر

<img src="https://geoips.info/flags/de.svg" alt="DE" width="32" height="24">

نمط الرابط: https://geoips.info/flags/<code>.svg

توثيق API

تتطلب جميع نقاط النهاية API-Key صالح في الترويسة X-API-Key.

GET/v1/lookup/{ip}

user@geoips:~$cat example.sh

curl -H "X-API-Key: $KEY" https://api.geoips.info/v1/lookup/8.8.8.8

مثال على الاستجابة:

user@geoips:~$cat response.json

{
  "ip": "8.8.8.8",
  "ip_version": 4,
  "country_code": "US",
  "country_name": "United States of America",
  "flag": "🇺🇸",
  "flag_url": "https://geoips.info/flags/us.svg",
  "region": "California",
  "city": "Mountain View",
  "latitude": 37.40599,
  "longitude": -122.07852,
  "zip": "94043",
  "timezone": "-08:00",
  "asn": 15169,
  "as": "Google LLC",
  "cidr": "8.8.8.0/24"
}

GET/v1/lookup/self

يُرجع المعلومات الجغرافية لعنوان IP الخاص بالعميل لديك.

user@geoips:~$cat example.sh

curl -H "X-API-Key: $KEY" https://api.geoips.info/v1/lookup/self

POST/v1/lookup/batch

حتى 100 عنوان IP لكل استدعاء (قد يكون حد باقتك أقل — انظر الأسعار). الـ body بحد أقصى 64 KB. يُحتسب كل IP كـ lookup واحد ضمن حدك اليومي المشترك (single + batch يتشاركان نفس الحصة).

user@geoips:~$cat example.sh

curl -X POST -H "X-API-Key: $KEY" -H "Content-Type: application/json" \
  -d '{"ips":["1.1.1.1","2606:4700:4700::1111"]}' \
  https://api.geoips.info/v1/lookup/batch

مثال على الاستجابة:

user@geoips:~$cat response.json

{ "results": [ { "ip": "1.1.1.1", ... }, { "ip": "...", "ip_version": 6, ... } ] }

GET/v1/lookup/:ip/whois

بيانات Whois/RDAP لعنوان IP (netname، المنظمة، abuse contact، البلد، ASN). تُقدَّم من cache يتم ملؤه عبر جميع الـ 5 RIRs (RIPE/ARIN/APNIC/LACNIC/AFRINIC). أول استدعاء لـ IP غير معروف يُرجع 202 Accepted + pending=true؛ يعمل الـ fetch في الخلفية وتكون البيانات متاحة عند الطلب التالي.

user@geoips:~$cat example.sh

curl -H "X-API-Key: $KEY" https://api.geoips.info/v1/lookup/8.8.8.8/whois

مثال على الاستجابة:

user@geoips:~$cat response.json

{
  "ip": "8.8.8.8",
  "cached": true,
  "whois": {
    "cidr": "8.8.8.0/24",
    "netname": "GOOGLE",
    "country": "US",
    "flag": "🇺🇸",
    "flag_url": "https://geoips.info/flags/us.svg",
    "org_name": "Google LLC",
    "abuse_email": "network-abuse@google.com",
    "source": "arin",
    "fetched_at": "2026-05-27T10:00:00Z"
  }
}

GET/v1/health

متاح بدون API-Key. لمراقبة مدى التوفر.

user@geoips:~$cat example.sh

curl https://api.geoips.info/v1/health

رموز الأخطاء

يحتوي كل رد خطأ على status (رمز HTTP)، وغالبًا error_code (رمز ثابت قابل للقراءة آليًا) وerror (وصف موجز). بالنسبة لـ rate limits يتم أيضًا تعيين الترويسة Retry-After.

HTTP	error_code	المعنى
400	`invalid_ip`	عنوان IP غير صالح في المسار (مثل /v1/lookup/not-an-ip).
400	`private_ip`	نطاق IP خاص/محجوز (10.x, 192.168.x, 127.x, ::1).
400	`invalid_body`	خطأ في تحليل الـ body على /v1/lookup/batch (مثل قائمة IP فارغة، أكثر من 100 IP في الـ body، ليس JSON).
400	`batch_too_large`	يحتوي الـ batch على عناوين IP أكثر مما تسمح به باقتك لكل استدعاء (max_ips_per_batch). قلّص الـ batch أو قم بترقية الباقة.
401	`missing_api_key`	ترويسة X-API-Key مفقودة.
401	`invalid_api_key`	الـ API-Key غير موجود أو تم إلغاؤه أو أن المستخدم معطّل.
413	`body_too_large`	حجم body الـ batch أكبر من 64 KB. قسّمه إلى عدة batches.
429	`rate_limit_per_minute`	تم الوصول إلى rate-limit للدقيقة (مشترك لـ single + batch). تخبرك ترويسة Retry-After بمدة الانتظار.
429	`rate_limit_per_day`	تم استنفاد الحد اليومي (max IPs/يوم). single + batch يُحتسبان معًا في نفس الحصة. يتم إعادة التعيين في ساعة UTC المُعدّة لباقتك.
429	`whois_quota_exhausted`	تم استنفاد حصة whois اليومية (حد منفصل لكل باقة). يتم إعادة التعيين في ساعة UTC المُعدّة لباقتك.
403	`whois_plan_required`	Whois ميزة premium وغير مفعّلة في باقتك الحالية — قم بالترقية إلى باقة مدفوعة.
202	`pending`	ليس خطأ بل حالة وسيطة: بيانات Whois لهذا الـ IP ليست بعد في الـ cache، وعملية RDAP fetch تعمل في الخلفية. يتضمن الرد pending=true و retry_after (ثوانٍ) — انتظر الوقت المحدد ثم أعد المحاولة، حينها سيُرجع الـ endpoint 200 مع البيانات الكاملة.
503	`maintenance_mode`	المنصة في وضع الصيانة. يتضمن الرد maintenance_message + retry_after_seconds — انتظر المدة المحددة وأعد المحاولة.
503	`whois_disabled`	تم تعطيل وظيفة whois من قبل المسؤول.
500	`internal_error`	خطأ في الخادم.

الأسئلة المتكررة

هل API مجاني فعلًا؟▾

نعم. الخطة المجانية تمنحك 8,000 استعلام يوميًا و 120 في الدقيقة، مجانًا بشكل دائم. لا حاجة لبطاقة ائتمان. لا تدفع إلا عندما تحتاج إلى حجم أكبر — تبدأ الخطط المدفوعة من 9 € / شهريًا.

ما مدى دقة تحديد الموقع الجغرافي؟▾

الدولة: دقة ~99.8%. المدينة: ~75% ضمن نصف قطر 50 كم — معيار الصناعة. تأتي البيانات من MaxMind GeoLite2، ويتم تحديثها أسبوعيًا. عناوين IP لمشغلي الهاتف المحمول (مثل T-Mobile) لها عدم دقة متأصل — في هذه الحالة نُرجع المنطقة بدلًا من المدينة.

ما هي البيانات التي أحصل عليها لكل IP؟▾

يُعامل IPv4 و IPv6 بالتساوي. لكل استعلام: الدولة (رمز ISO + الاسم)، المنطقة، المدينة، الرمز البريدي، الإحداثيات، المنطقة الزمنية، ASN، اسم AS. مع نقطة نهاية Whois/RDAP بالإضافة: كتلة CIDR، netname، المؤسسة، وجهة اتصال إساءة الاستخدام مباشرة من الـ RIRs.

هل Whois/RDAP مضمن في جميع الخطط؟▾

نعم، Whois مضمن في كل خطة بدءًا من Free فما فوق. تأتي البيانات مباشرة من السجلات الإقليمية الخمسة للإنترنت (RIPE, ARIN, APNIC, LACNIC, AFRINIC) ويتم تخزينها مؤقتًا لمدة 30 يومًا — استجابة أقل من مللي ثانية في الجلب الثاني.

ماذا عن GDPR والخصوصية؟▾

الخوادم في الاتحاد الأوروبي (ألمانيا والنمسا). نسجل عناوين IP لفترة قصيرة فقط لمكافحة إساءة الاستخدام (90 يومًا، ثم تُحذف تلقائيًا). DPA متاحة عند الطلب. لا تتبع، لا مشاركة بيانات مع أطراف ثالثة.

ماذا يحدث عند الوصول إلى الحد اليومي؟▾

تحصل على HTTP 429 مع رأس Retry-After. يُعاد ضبط الحد في ساعة UTC قابلة للتكوين (الافتراضي 00:00 UTC). يتم عرض الحدود الفرعية (لكل دقيقة، لكل يوم) عبر رأس الاستجابة X-RateLimit-Remaining.

هل يمكنني استخدام نقطة نهاية batch؟▾

نعم. تقبل POST /v1/lookup/batch ما يصل إلى 100 IP لكل طلب، بحد أقصى 64 KB للجسم. يُحتسب كل IP كاستعلام واحد مقابل حدك اليومي. الخطة المجانية لديها حد 10 IP/batch، الخطط المدفوعة 50–100 — راجع التسعير.

ما مدى سرعة الاستجابة؟▾

استعلام فردي عادةً أقل من 30 مللي ثانية (P50) من الاتحاد الأوروبي. Batch بـ 100 IP أقل من 100 مللي ثانية. نستخدم cache in-memory + فهارس نطاقات IP الثنائية بدلًا من استعلامات DB التقليدية — لا توجد ارتفاعات cold-start.

API تحديد الموقع الجغرافي بواسطة IP. مجاناً.

IPv4 + IPv6

8,000 استعلام / يوم مجاناً

Whois / RDAP مُضمَّن

الإدارة والبوابة

ما هي استخدامات API؟

منع الاحتيال وتقييم المخاطر

الامتثال والحظر الجغرافي

تحليلات الويب والتخصيص

إدارة إساءة الاستخدام و DevOps

كيف يعمل

أنشئ حسابًا

احصل على مفتاح API

نفّذ بحثًا

توسّع

كيف نتميز

أعلام الدول والرموز التعبيرية

رمز تعبيري في JSON

رابط SVG مُضمَّن

271 دولة

مُضمَّن في جميع الخطط

توثيق API

رموز الأخطاء

الأسئلة المتكررة