تحديد الموقع الجغرافي لعناوين IP
الدولة والمنطقة والمدينة والإحداثيات والمنطقة الزمنية لأي عنوان IPv4 أو IPv6 عام. مدعوم بـ MaxMind GeoLite2 — حساب محلي بالكامل، دون حدود معدّل مشتركة.
لا تملك مفتاح API؟
سجّل الدخول إلى حسابك لإنشاء وإدارة مفاتيح API.
دليل التكامل
انسخ المقتطف، استبدل مفتاح API الخاص بك، ثم شغّله. يعمل مع أي عميل HTTP — أمثلة أدناه بـ cURL وJavaScript وPython.
/api/ip-geolocationhttps://www.apipick.comGet geolocation data for any public IP address
ipstringاختياريPublic IPv4 or IPv6 address. Omit to look up caller's own IP. 8.8.8.8
curl -X GET "https://www.apipick.com/api/ip-geolocation" \
-H "x-api-key: YOUR_API_KEY"{
"success": true,
"code": 200,
"message": "ok",
"data": {
"ip": "8.8.8.8",
"country_code": "US",
"country_name": "United States",
"continent": "North America",
"continent_code": "NA",
"city": "Mountain View",
"latitude": 37.4056,
"longitude": -122.0775,
"timezone": "America/Los_Angeles",
"currency": "USD",
"isp": "Google LLC",
"asn": 15169
},
"credits_used": 1,
"remaining_credits": 99
}مبني لحالات استخدام واقعية
كشف الاحتيال
ضع علامة على عمليات التسجيل أو المعاملات الواردة من مناطق عالية المخاطر. تحقّق مما إذا كان عنوان IP الخاص بالمستخدم يطابق موقعه المُعلَن أو بلد الفوترة.
ترجمة المحتوى وتوطينه
اختر اللغة والعملة والتسعير الإقليمي تلقائيًا بناءً على موقع الزائر. اعرض لافتات ملفات تعريف الارتباط المتوافقة مع الاتحاد الأوروبي على زوّاره فقط.
تحديد المعدل
طبّق حدود معدّل أو ضوابط وصول لكل دولة. احجب حركة المرور من مناطق معيّنة أو قيّدها دون شراء أدوات أمان باهظة الثمن.
إثراء بيانات وكلاء الذكاء الاصطناعي
دع وكلاء الذكاء الاصطناعي يثرون سجلّات المستخدمين، أو يصنّفون العملاء المحتملين جغرافيًا، أو يوطّنون المحتوى المُولَّد بناءً على بيانات IP في الزمن الفعلي.
بديل ipinfo.io وipapi.co
فوترة أرصدة لكل حساب — دون تجمّع حدود معدّل مشترك، ودون مستويات خطط، ودون سقوف شهرية تُعاد ضبطها في أول يوم من الشهر.
ipinfo.io | ipapi.co | API Pick ✓ | |
|---|---|---|---|
| المستوى المجاني | 50k req/month | 1,000 req/day | 100 رصيد عند التسجيل |
| نموذج تحديد المعدل | خطر تجمّع IP مشترك | خطر تجمّع IP مشترك | أرصدة لكل حساب |
| هل تنتهي صلاحية الأرصدة / الحصة؟ | إعادة ضبط شهرية | إعادة ضبط يومية | لا تنتهي أبدًا |
| الدولة + المنطقة + المدينة | ✓ | ✓ | ✓ |
| المنطقة الزمنية | خطة مدفوعة | ✓ | ✓ |
| دعم IPv6 | ✓ | ✓ | ✓ |
| علامة عضوية الاتحاد الأوروبي | خطة مدفوعة | ✓ | ✓ |
| لا حاجة إلى بطاقة ائتمان للبدء | ✓ | ✓ | ✓ |
| جاهز لوكلاء الذكاء الاصطناعي / نماذج اللغة | جزئي | جزئي | ✓ JSON أصلي |
مشكلة تجمّع حدود المعدّل المشترك
في المستويات المجانية لـ ipinfo.io وipapi.co، تُفرَض حدود المعدّل لكل عنوان IP للعميل. وهذا يعني أن جميع الطلبات من منطقة Vercel أو AWS أو GCP نفسها تتشارك تجمّع حصة واحدًا. فإذا كان مستأجر آخر على عقدة الحافة نفسها قد استهلك الحد اليومي البالغ 1,000 طلب، تبدأ استدعاءات API الخاصة بك بالفشل — حتى لو لم تُرسِل طلبًا واحدًا بعد.
الفوترة بالأرصدة: قابلة للتنبؤ عند أي حجم
تحاسب API Pick لكل حساب، لا لكل عنوان IP. يخصم كل استدعاء رصيدًا واحدًا بالضبط من رصيدك — فقط عند استجابة ناجحة. لا تنتهي صلاحية الأرصدة أبدًا. سواء أجريت 10 عمليات بحث أو 10,000 في يوم واحد، فإنك تدفع فقط مقابل ما تستخدمه دون أي خطر للفشل المفاجئ من حصة مشتركة.
حقول الاستجابة
| الحقل | النوع | الوصف |
|---|---|---|
| data.ip | string | عنوان IP المُستعلَم عنه |
| data.country_code | string | رمز الدولة ISO 3166-1 alpha-2 (مثل US أو DE أو JP) |
| data.country_name | string | اسم الدولة الكامل بالإنجليزية |
| data.continent | string | اسم القارّة (مثل North America أو Europe) |
| data.continent_code | string | رمز القارّة المكوّن من حرفين (مثل NA أو EU) |
| data.city | string | اسم المدينة (سلسلة فارغة إن لم يكن متاحًا) |
| data.latitude | number | null | خط العرض التقريبي لموقع عنوان IP |
| data.longitude | number | null | خط الطول التقريبي لموقع عنوان IP |
| data.timezone | string | معرّف المنطقة الزمنية IANA (مثل America/Los_Angeles) |
| data.currency | string | رمز العملة ISO 4217 للدولة (مثل USD أو EUR) |
| data.isp | string | اسم مزوّد خدمة الإنترنت / المؤسسة من قاعدة بيانات ASN |
| data.asn | integer | null | رقم النظام المستقل (مثل 15169 لـ Google) |
| credits_used | integer | الأرصدة المخصومة عن هذا الطلب |
| remaining_credits | integer | الأرصدة المتبقية في حسابك |
حدود المعدل
يُطبَّق التقييد لكل مفتاح API، بنافذة منزلقة مدتها 60 ثانية. عند بلوغ الحد تحصل على رمز 429 نظيف مع ترويسة Retry-After.
120req/min
لكل مفتاح API ولكل نقطة نهاية. نافذة منزلقة مدتها 60 ثانية.
3concurrent
الحد الأقصى للطلبات الجارية المتزامنة لكل مفتاح API.
X-RateLimit-Limitالحد الأقصى للطلبات المسموح بها في الدقيقةX-RateLimit-Remainingالطلبات المتبقية في النافذة الحاليةX-RateLimit-Resetعدد الثواني حتى إعادة ضبط النافذة الحاليةRetry-Afterعدد الثواني التي يجب انتظارها قبل إعادة المحاولة (عند 429 فقط)HTTP/1.1 429 Too Many Requests
Retry-After: 12
X-RateLimit-Limit: 120
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 12
{
"error": "rate_limit_exceeded",
"message": "Rate limit exceeded: 120 requests/minute per API key. Retry after 12s.",
"retry_after": 12
}الأسئلة الشائعة
س: ماذا يحدث إن لم أمرّر عنوان IP؟
ج: تكتشف نقطة النهاية تلقائيًا عنوان IP الخاص بالمُستدعِي من ترويسات الطلب (X-Forwarded-For). وهذا مفيد لعمليات البحث من جهة الخادم حين تريد تحديد موقع المستخدم النهائي دون تمرير عنوان IP صراحةً.
س: هل عناوين IP الخاصة مدعومة؟
ج: لا. تُعيد عناوين IP الخاصة (نطاقات RFC 1918 مثل 192.168.x.x و10.x.x.x)، وعناوين الاسترجاع (127.0.0.1)، والنطاقات المحجوزة الأخرى خطأ 400. لا تُدعَم سوى عناوين IPv4 وIPv6 القابلة للتوجيه العام.
س: ما مدى دقة تحديد الموقع الجغرافي؟
ج: مدعوم بـ MaxMind GeoLite2-City. تبلغ الدقة على مستوى الدولة عادةً 95–99%. أما الدقة على مستوى المدينة فتتفاوت حسب المنطقة — موثوقة عمومًا في أمريكا الشمالية وأوروبا، وأقل دقة في أجزاء من آسيا وأفريقيا. تمثّل الإحداثيات المنطقة العامة، لا موقعًا فيزيائيًا دقيقًا.
س: هل يمكن لوكلاء الذكاء الاصطناعي استخدامها كأداة؟
ج: نعم. تقبل نقطة النهاية معامل استعلام ip واحدًا اختياريًا وتُعيد كائن JSON مسطّحًا — يسهُل عرضه كأداة دالة لـ OpenAI أو Claude أو LangChain أو أي إطار عمل وكلاء. مفيد للوكلاء الذين يحتاجون إلى الاستدلال على موقع المستخدم، أو فرض قواعد قائمة على الجغرافيا، أو إثراء بيانات العملاء المحتملين بسياق إقليمي.
استخدِم تحديد موقع IP في Claude Code ووكلاء الذكاء الاصطناعي
ثبّت مهارة Claude Code الرسمية لتحديد موقع أي عنوان IP مباشرةً داخل وكيل البرمجة بالذكاء الاصطناعي — الدولة والمدينة ومزوّد الخدمة والمنطقة الزمنية والمزيد عبر اللغة الطبيعية.
اسأل وكيل الذكاء الاصطناعي بأسلوب طبيعي
المنصّات المتوافقة
مهارة Claude Code لواجهة تحديد موقع IP من APIpick
تُعيد الدولة والقارّة والمدينة وخط العرض/الطول والمنطقة الزمنية IANA ورمز العملة ISO واسم مزوّد الخدمة وASN لأي عنوان IP.