الأسئلة الشائعة

واجهة برمجية مجانية لذكاء بيانات IP. ابحث عن أي عنوان IPv4 أو IPv6 واحصل على الدولة وASN ومزود الخدمة واكتشاف الاستضافة واكتشاف VPN وتحديد عقد خروج Tor وتقييم الشبكات المسيئة. استجابة JSON واحدة. دون تسجيل.

لا. الباقة المجانية لا تتطلب مفتاحاً ولا تسجيلاً — يكفي استدعاء نقطة النهاية مباشرة (تُحتسب الحدود لكل عنوان IP). وللحصول على حدود Pro أو Enterprise أرسل مفتاحك في الترويسة X-API-Key أو عبر ?api_key=. ويمكنك إصدار مفتاح مجاني فوراً عبر POST /v1/keys.

https://ipto.to. جميع نقاط النهاية تقع تحت /v1/. CORS مفعّل على جميع نقاط النهاية.

GET https://ipto.to/v1/ip — دون الحاجة لأي معامل. يُرجع عنوان IP الخاص بك مع المدينة والولاية/المنطقة والمنطقة الزمنية وخط العرض/الطول. أو نفّذ curl ipto.to في الطرفية.

نعم. يكتشف curl ipto.to تلقائياً User-Agent الخاص بـ curl ويُرجع JSON مختصراً لعنوان IP الخاص بك، بحقول تشمل الدولة والمدينة وASN وحالة الطقس الحية. ويفعل curl ipto.to/8.8.8.8 الأمر ذاته لأي عنوان IP (دون الطقس). يعمل Wget وHTTPie أيضاً.

يربط تحديد الموقع عبر IP نطاقات IP بالموقع الفعلي للبنية التحتية للشبكة، وليس المستخدم النهائي. يوجّه مزودو الخدمة حركة المرور عبر نقاط تبادل إقليمية قد تبعد مئات الأميال. دقة الدولة عالية. أما دقة المدينة فتنخفض بالنسبة لعناوين IP المنزلية والمحمولة.

عند الاتصال بشبكة VPN، تخرج حركة مرورك من عنوان IP الخاص بخادم VPN. يُبلغ ipto عن موقع خادم الخروج هذا، وليس موقعك الفعلي. ستكون علامة is_vpn صحيحة (true) في هذه الحالة.

تعتمد جودة البيانات على مدى دقة تسجيل مزودي الخدمة والمؤسسات لنطاقات IP الخاصة بهم في سجلات WHOIS وسجلات التوجيه. تمتلك كبرى شركات السحابة ومزودو الخدمة سجلات عالية الدقة. أما التخصيصات الأصغر أو الأقدم فقد تكون غير دقيقة.

نعم. تعيد عناوين IPv6 بيانات ASN والمؤسسة ونطاقات IP، إضافةً إلى الموقع على مستوى المدينة (المدينة والمنطقة والرمز البريدي وخط العرض/الطول) من مجموعة بيانات MaxMind عندما يكون النطاق مشمولاً، كما تُحدَّد النطاقات الوهمية (bogon) والخاصة. الفجوة الوحيدة: مؤشرات VPN وTor وإساءة الاستخدام تقتصر حالياً على IPv4 لأن هذه المصادر تُنشر كنطاقات IPv4 — وفي عنوان IPv6 تعود false بدلاً من التخمين.

عنوان Bogon (الزائف) هو أي عنوان لا ينبغي أن يظهر كمصدر على الإنترنت العام: عنوان الاسترجاع الذاتي (127.x.x.x)، ونطاقات RFC 1918 الخاصة (10.x، 172.16–31.x، 192.168.x)، والعناوين المحلية الرابطة (169.254.x)، وعناوين البث المتعدد (224–239.x)، والنطاقات المحجوزة لدى IANA. يكتشف ipto هذه العناوين قبل أي بحث في قاعدة البيانات ويُرجع bogon: true مع سبب bogon_type. تحقق من أي عنوان على أداة فحص عناوين Bogon.

يحتفظ ipto بقاعدة بيانات لنطاقات IP الخاصة بخوادم VPN المعروفة، مبنية من تحليل توجيه BGP والفهرسة الفعّالة. يتم فحص كل عنوان IP مقابل هذه القاعدة عند البحث. تُستمد نسبة المزوّد من ملكية ASN: عندما يكون رقم ASN مسجلاً حصرياً لمشغّل VPN، يتم التعرف على المزوّد. اختبر أي عنوان IP على أداة فحص VPN والبروكسي.

تُستمد قائمة عقد خروج Tor من القائمة الجماعية الرسمية لعقد الخروج التابعة لمشروع Tor على check.torproject.org. وهي القائمة الرسمية لعناوين IP القادرة حالياً على توليد حركة مرور خروج Tor. يتم تحديثها كل 6 ساعات.

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

يعني is_datacenter أن عنوان IP ينتمي إلى مزود استضافة أو منصة سحابية أو شبكة توصيل محتوى (CDN). ويعني is_residential أن عنوان IP مصنّف كاتصال إنترنت منزلي للمستهلكين. معظم عناوين IP لا تندرج تحت أي منهما — فهي تنتمي إلى بنية تحتية لمزود خدمة ليست استضافة ولا سكنية.

يُشير إلى نقاط خروج بروكسي معروفة غير مصنّفة كـ VPN أو Tor. يقتصر حالياً على البيانات الواردة من خط أنابيب تغذية التهديدات. التغطية أقل من اكتشاف VPN وTor.

رقم النظام المستقل (ASN) هو معرّف فريد لشبكة تدير سياسات توجيه IP الخاصة بها بشكل مستقل على الإنترنت. أمثلة: Google هي AS15169، وAmazon هي AS16509. يُعلَن كل نطاق IP من قِبل رقم ASN واحد بالضبط. ابحث عن أي رقم ASN مباشرة على أداة البحث عن ASN.

فئة المؤسسة التي تشغّل رقم ASN. القيم: hosting (استضافة سحابية أو خوادم)، isp (مزود خدمة إنترنت)، business (شبكة مؤسسية)، education (جامعة أو بحث علمي)، government (حكومي)، mobile (شركة اتصالات)، residential (سكني).

نطاق IP مسجَّل باسم شركة اتصالات محمولة. غالباً ما يُعاد تخصيص عناوين IP المحمولة بين المستخدمين، وكثيراً ما تظهر في مواقع جغرافية مختلفة عن المقر الرئيسي لشركة الاتصالات.

نعم — يُرجع GET /v1/asn/:asn/ranges?limit=&offset= النطاقات الفعلية (كل منها مع رمز الدولة وعلامات hosting/mobile/residential/bot/blacklist)، مُقسَّمة على صفحات بحد أقصى 200 لكل طلب. يتضمن الاستعلام الرئيسي GET /v1/asn/:asn أيضاً ip_range_count وrank — ترتيب حجم رقم ASN داخل دولته حسب عدد النطاقات — دون الحاجة إلى نقطة نهاية النطاقات. راجع أداة البحث عن ASN.

يُرجع GET /v1/asn/:asn/whois سجل تسجيل الـ RIR (الاسم، الحالة، الدولة، تواريخ التسجيل/آخر تعديل، جهات الاتصال) عبر RDAP. يُرجع GET /v1/asn/:asn/relationships النظراء (peers) المعروفين ومزوّدي الأعلى (upstream) وعملاء الأسفل (downstream) من مجموعة بيانات علاقات الأنظمة المستقلة الخاصة بـ CAIDA؛ بينما يجد GET /v1/asn/:asn/related أرقام ASN أخرى يُرجَّح أن تُديرها نفس المؤسسة. تظهر الثلاثة معاً في صفحة البحث عن ASN.

نعم — جميع نطاقات IP (GET /v1/ip-ranges) هو دليل قابل للتصفح لجميع كتل /8 الممكنة البالغ عددها 256، يتيح التفصيل وصولاً إلى /16 ثم إلى النطاقات المخصصة فعلياً ورقم ASN الذي ينتمي إليه كل منها.

تسمح الخطة المجانية بـ 1,000 طلب يومياً لكل عنوان IP، دون الحاجة لتسجيل أو مفتاح. تحصل مفاتيح Pro على 100,000 طلب يومياً؛ وخطة Enterprise غير محدودة. يؤدي تجاوز الحد إلى إرجاع رمز HTTP 429. راجع الأسعار للتفاصيل.

أرسل طلب POST يحتوي على مصفوفة JSON من سلاسل عناوين IP إلى /v1/ip/bulk — حتى 100 عنوان لكل طلب، لخطتي Pro/Enterprise فقط (راجع الأسعار). الاستجابة هي كائن مفهرس بعنوان IP. تجعل قراءات ذاكرة التخزين المؤقت المتوازية هذا أسرع من الاستدعاءات المتسلسلة. يُحسب كل عنوان IP ضمن ميزانيتك اليومية، تماماً مثل البحث الفردي.

أضف ?fields=field1,field2 إلى أي طلب لعنوان IP واحد. مثال: /v1/ip/1.1.1.1?fields=ip,country_code,is_vpn,is_tor. يتم تضمين حقل ip دائماً.

JSON (الافتراضي)، وCSV، ونص عادي، وXML، وYAML. أضف ?format=csv أو ?format=text أو ?format=xml أو ?format=yaml إلى أي طلب لعنوان IP واحد. يُرجع CSV والنص أزواج مفتاح/قيمة مسطّحة؛ بينما يحافظ XML وYAML على الكائنات المتداخلة مثل flags.

لا توجد حزمة تطوير رسمية بعد. الواجهة البرمجية هي نقطة نهاية HTTP قياسية بصيغة JSON — يعمل معها أي عميل HTTP. راجع الوثائق للاطلاع على أمثلة بـ curl وJavaScript وPython وPHP وGo.

نعم — https://ipto.to/mcp هو خادم Model Context Protocol (MCP) يعرض الاستعلامات نفسها كأدوات قابلة للاستدعاء عبر JSON-RPC — IP (مفرد وبالجملة)، وASN مع نطاقاته/whois/علاقاته، وwhois لعنوان IP، وRPKI، والشركة، ومشغّل الاتصالات، والنطاقات المستضافة، والبحث الموحّد، والأماكن القريبة، والدولة، وDNS العكسي، وUser-Agent، والهاتف، والبريد الإلكتروني، ودرجة الاحتيال، واللغة، والعملة، والطقس، والعلامات التجارية، وبراءات الاختراع — بحيث يستطيع أي عميل يدعم MCP استدعاءها مباشرة بدلاً من إرسال طلبات HTTP خام. ويستخدم X-API-Key نفسه وقواعد تحديد المعدل ذاتها المعتمدة في واجهة REST.

تُحدَّث مجموعة بيانات ASN/نطاقات IP يومياً في الساعة 04:00 بتوقيت UTC. يدمج تحديد الموقع على مستوى المدينة مصدرين مستقلين وفق جدوليهما الخاصين — IP2Location شهرياً، وMaxMind أسبوعياً — لذا قد تتحسن الدقة بين تحديثات ASN. تتم مزامنة تغذيات التهديدات (VPN وTor والإساءة) كل 6 ساعات. مدة صلاحية ذاكرة التخزين المؤقت الطرفية 5 دقائق.

نجمع المعلومات من عدة مزودي بيانات رئيسيين في هذا المجال، تُحدَّث يومياً. يستخدم اكتشاف VPN ذكاء نطاقات مستمدة من BGP. تأتي بيانات عقد Tor من السجل الرسمي لمشروع Tor وقوائم المُرحّلات الموثّقة. تستخدم الشبكات المسيئة ذكاء قوائم سوداء متعدد المصادر ومتطابق فيما بينها.

يتمتع اكتشاف VPN وTor بمعدل استرجاع عالٍ لدى كبار المزودين وجميع عقد الخروج المؤكدة. أما خدمات VPN الأصغر أو الأحدث التي تستأجر مساحة IP من أرقام ASN استضافة عامة، فقد لا يتم التعرف عليها باسم المزوّد. يستخدم تقييم الإساءة تطابقاً بين عدة تغذيات — تتطلب الشبكة 3 مصادر مستقلة أو أكثر لتظهر بمستوى متوسط، و8 مصادر أو أكثر لتصل إلى مستوى حرج.

abuse_score هي درجة خطورة من 1 إلى 10 مبنية على تطابق عدة تغذيات: عدد مصادر التهديد المستقلة التي تصنّف نفس الشبكة. تُسمّي threat_type الفئة التي أطلقت التصنيف — tor_exit أو vpn أو abuser. تجمّع risk_tier الدرجة في: حرج (8–10)، مرتفع (5–7)، أو متوسط (3–4). جرّب فحصاً حياً على أداة فحص إساءة استخدام IP.

نعم. تتضمن أي استجابة تحتوي على دولة مكتشفة currency_code وexchange_rate_usd — سعر مرجعي يومي يغطي 154 عملة عالمية. تُرجع العملات خارج هذه القائمة قيمة null للسعر.

تتضمن كل استجابة تحتوي على بيانات دولة languages (اللغات الرسمية المستخدمة)، وtld (نطاقات المستوى الأعلى الخاصة برمز الدولة)، وcapital (العاصمة)، وborders (رموز ISO للدول المجاورة) — مفيدة لتوطين المحتوى أو بناء نماذج تراعي الدولة دون استدعاء ثانٍ لـ API.

يُجري GET /v1/ip/:ip/hostname بحث PTR حياً عبر DNS-over-HTTPS ويُرجع { ip, hostname }. إنه بحث فردي عند الطلب، وليس قاعدة بيانات مخزّنة لسرد النطاقات — تكون قيمة hostname هي null إذا لم يوجد سجل PTR. توجد أيضاً أداة في المتصفح على /reverse-dns-lookup.

نعم. يُرجع GET /v1/datasets/:kind ملفات CSV لـ asn وranges وgeo-city — وهي نفس مجموعات البيانات التي تستعلم منها الواجهة البرمجية داخلياً، وتُحدَّث وفق نفس الجدول. يقبل geo-city معامل ?source=primary (افتراضي) أو ?source=secondary اختيارياً، حيث تُدمج بيانات مستوى المدينة من مصدرين مستقلين بتغطيتين مختلفتين.

يفتح مفتاح Pro حداً قدره 100,000 طلب يومياً والبحث الجماعي (POST /v1/ip/bulk، حتى 100 عنوان IP لكل طلب) — البحث الجماعي غير متاح إطلاقاً في الخطة المجانية. تضيف خطة Enterprise (طلبات غير محدودة) اتفاقية مستوى خدمة مخصصة ودعماً مخصصاً. دقة المدينة/الرمز البريدي/الإحداثيات مشمولة في كل خطة، بما فيها المجانية. يصدر POST /v1/keys مفتاحاً للخطة المجانية (1,000 طلب يومياً، مع تتبع الاستخدام عبر GET /v1/keys/usage?key=X) — راجع الأسعار للترقية.

كلاهما، عندما تسمح geo_precision بذلك. يحصل عنوان IP الخاص بك دائماً (GET /v1/ip) على بيانات مستوى المدينة من شبكة الحافة التي تتصل من خلالها. تحصل عمليات البحث الصريحة عن IP (GET /v1/ip/:ip) على بيانات مستوى المدينة عندما يقع ذلك العنوان ضمن تغطية مجموعة بيانات مستوى المدينة؛ وإلا تنخفض geo_precision إلى country وتُرجع المدينة/الولاية/خط العرض/خط الطول قيمة null.

Add ?lang= to any request with one of: pt, fr, de, zh-TW, ko, zh-CN, ja-JP, es-ES, ar-SA, hi-IN (en is the default). This localizes country_name and continent into the target language. Field names and threat data stay in English regardless of locale.

نعم — يتحقق GET /v1/email/:email من الصيغة، ويبحث حياً عن سجل MX، ويكتشف النطاقات المؤقتة/للاستخدام لمرة واحدة مقابل قائمة حظر متزامنة. مجاناً، دون تسجيل. جرّب أداة فحص البريد الإلكتروني.

نعم — يحلّل GET /v1/phone/:number أي رقم بصيغة E.164 أو الصيغة المحلية للتحقق من الصلاحية والدولة والمنطقة ونوع الخط (محمول أو أرضي أو VoIP) مقابل مجموعة بيانات شركات اتصالات MCC/MNC متزامنة. جرّب أداة فحص رقم الهاتف.

يجمع GET /v1/fraud-score بين إشارات تهديد IP وإمكانية تسليم البريد الإلكتروني وصلاحية الهاتف واكتشاف بوت User-Agent في درجة خطورة موحّدة واحدة من 0 إلى 100 — وهو الشيء الوحيد الذي لا تقدمه أي من واجهات ذكاء بيانات IP المستقلة الكبرى. جميع المدخلات الأربعة اختيارية؛ فالإشارة التي لا تمررها تكون ببساطة غائبة، لا أنها تُقيَّم كنظيفة. جرّب أداة فحص درجة الاحتيال.

نعم — يحدد GET /v1/language لغة أي نص من بين 76 لغة عبر تحليل محلي لتكرار الثلاثيات الحرفية. لا يُرسل أي نص إلى مزود خارجي أو نموذج ذكاء اصطناعي، ولا يُسجَّل أي شيء. جرّب كاشف اللغة.

نعم — يعرض كل من GET /v1/currency/convert وGET /v1/currency/rates نفس تغذية أسعار الصرف اليومية التي تشغّل بالفعل exchange_rate_usd في كل بحث عن IP/دولة، وتغطي 154 عملة، بالإضافة إلى GET /v1/currency/history للأسعار التاريخية لمدة 90 يوماً. جرّب محوّل العملات.

نعم — يُرجع GET /v1/weather الظروف الحالية لأي اسم مكان أو رمز بريدي أو زوج إحداثيات؛ أضف &detail=1 للحصول على نظرة عامة بالساعة وتوقعات لمدة 3 أيام. تستخدمه كل من أداة الطقس الخاصة بعنوان IP في الصفحة الرئيسية وأداة البحث عن حالة الطقس.

نعم — يمرّر GET /v1/trademark/:serial الطلب إلى واجهة USPTO البرمجية TSDR للحصول على حالة القضية الحية باستخدام رقم تسلسلي من 8 أرقام. نص حالة القضية عمل حكومي أمريكي وملكية عامة، لذا تحمل كل استجابة حقل source/attribution؛ وبيانات شعار/صورة العلامة التجارية مستبعدة عمداً من النطاق. البحث برقم التسجيل غير مدعوم — فمسار الرقم التسلسلي فقط هو الموثّق حالياً من USPTO. جرّب أداة البحث عن العلامات التجارية.

نعم — يمرّر GET /v1/patent/:number الطلب إلى واجهة USPTO البرمجية الحية الخاصة بملف براءات الاختراع للحصول على حالة المنح باستخدام رقم براءة اختراع نفعية من 7-8 أرقام. تبدأ التغطية من الطلبات المقدمة في عام 2001، والبيانات تقاضوية/ببليوغرافية (تاريخ التقديم، الحالة، المخترعون، المحامي المسجَّل) — وليست رسماً بيانياً للاستشهادات أو عائلة براءات اختراع أو حقل حالة قانونية كما تعرضه Lens.org أو Espacenet أو Google Patents. براءات التصميم والنباتات وإعادة الإصدار غير مدعومة بعد. جرّب أداة البحث عن براءات الاختراع.

طلب واحد فقط — GET /v1/search/:query. يكتشف ما إذا كنت قد كتبت عنوان IP أو رقم ASN أو رمز دولة أو بريداً إلكترونياً أو رقم هاتف، ثم يوزّع الطلب من جانب الخادم على كل فحص ذي صلة (بحث IP، RPKI، الشركة، whois، شركة الاتصالات، النطاقات المستضافة، الأماكن) بالتوازي. يستهلك البحث الواحد طلباً واحداً فقط من ميزانية حد الطلبات اليومية، وليس طلباً لكل ميزة.

نعم — يحل كل من GET /v1/ip/:ip/rpki (والصيغة الصريحة GET /v1/rpki?asn=&prefix=) التحقق من منشأ المسار مباشرة عبر RIPEstat، الذي يجمّع بيانات ROA من جميع سجلات الإنترنت الإقليمية الخمسة. تكون الحالة دائماً إما valid أو invalid أو unknown — ولا تُستنتج أبداً من أي إشارة أخرى. جرّب أداة التحقق من RPKI.

يجمع GET /v1/ip/:ip/company بين بيانات المسجِّل من RDAP واسم مؤسسة ASN الخاصة بعنوان IP في درجة ثقة تصنيفية واحدة (مرتفع/متوسط/منخفض/لا يوجد) — حكم واحد عن "من يملك هذا". بينما يُرجع GET /v1/ip/:ip/whois سجل RDAP الأساسي نفسه بدلاً من ذلك: نطاق الشبكة، ونوع التخصيص، وتواريخ التسجيل، وكل جهة اتصال للتسجيل/الإدارة/الإبلاغ عن الإساءة المسجَّلة، وهو أقرب إلى مخرجات WHOIS الكلاسيكية. جرّب IP إلى الشركة أو Whois لعنوان IP.

بأفضل جهد ممكن، ولعناوين IP المصنّفة بالفعل كشبكات محمولة فقط. يجري GET /v1/ip/:ip/carrier مطابقة تقريبية لاسم مؤسسة ASN مقابل دليل مشغّلي MCC/MNC مقتصر على دولة عنوان IP. لا يوجد عمداً حقل واحد carrier: "X" — فاسم مجرد سيُفهم على أنه ادعاء حي خاص بمشترك بعينه لا يمكن للبيانات دعمه بصدق. جرّب أداة IP إلى شركة الاتصالات المحمولة.

يجد GET /v1/ip/:ip/hosted-domains النطاقات عبر اسم المضيف الخاص بعنوان IP عن طريق DNS العكسي بالإضافة إلى سجلات شفافية الشهادات (crt.sh) — وهذا ليس بحثاً عاماً عن IP العكسي. يوضّح حقل limitations الخاص بالاستجابة بالضبط ما لا يمكنها رؤيته هيكلياً: عناوين IP بدون سجل PTR، والنطاقات غير ذات الصلة على الاستضافة المشتركة، والنطاقات التي لم تُسجَّل في CT مطلقاً. جرّب النطاقات المستضافة.

يُجري GET /v1/places/:ip ترميزاً جغرافياً عكسياً لموقع عنوان IP الحالي على مستوى المدينة، ثم يُرجع نقاط الاهتمام القريبة (المطاعم، الحدائق، المدارس، وسائل النقل)، والمعالم البارزة، وبيانات الجريمة المحلية حيثما يتوفر مصدر (المملكة المتحدة والولايات المتحدة فقط)، وتقديراً اختيارياً لوقت التنقل بالسيارة عند الطلب عندما تقدّم وجهة. جرّب الأماكن.

يُعد connection_type في GET /v1/ip/:ip تصنيفاً واحداً بأفضل جهد ممكن — mobile أو datacenter أو unknown — مستمداً من نفس تصنيف ASN المستخدم في كائن flags. يحل هذا محل اكتشاف الاتصال القائم على عدد الأجهزة/NAT، وهو أمر لا يستطيع Cloudflare Worker رصده (لا وصول إلى حزم TCP/IP الخام) — لذا بدلاً من تزييف ذلك، تُرجع أرقام ASN غير المصنّفة بصدق قيمة unknown.

نعم، كطبقة متقدمة (premium) فوق الفحص المحلي المجاني دائماً. لا يزال GET /v1/phone/:number يُشغّل أولاً التحقق المحلي المجاني (التنسيق، المنطقة، نوع الخط — دون تغيير، راجع السؤال السابق)، وإذا سمحت الميزانية، يضيف مباشرة carrier وoriginal_carrier وis_ported، وتصنيف phone_type، وموقعاً محلياً (phone_region) ومفتاح الاتصال (country_prefix) من مزوّد البحث عن مشغلي الشبكات في الوقت الفعلي لدينا. يُدرَج اسم الدولة الكامل country_name بغضّ النظر عن المستوى، وهو مُترجَم عبر ?lang=/Accept-Language تماماً مثل حقل country_name في أي نقطة نهاية أخرى — تحقّق من lang/lang_source في الاستجابة لمعرفة اللغة التي طُبّقت فعلياً. يُشير حقل source في الاستجابة إلى أي مستوى أجاب: "premium" أو "local".

100 عملية بحث متقدمة لكل عنوان IP شهرياً في الخطة المجانية، و1,000/شهر لكل مفتاح API في خطة Pro، و5,000/شهر في خطة Enterprise — راجع الأسعار. هذا بالإضافة إلى ميزانية البحث المحلي المجاني الحالية للهاتف (100/يوم في الخطة المجانية)، والتي ليس لها حد شهري خاص بها.

لا شيء يتعطل. يعود GET /v1/phone/:number بسلاسة إلى المحرك المحلي المجاني لبقية الشهر — ستظل تحصل على استجابة 200 كاملة تتضمن بيانات التنسيق والمنطقة ونوع الخط، فقط دون حقول carrier/is_ported المباشرة (والتي تُرجع حينها null وsource: "local"). لا أخطاء، ولا حاجة للتسجيل لمواصلة استخدام الخطة المجانية.

هما تصنيفان مستقلان من محركين مختلفين، تم إبقاؤهما منفصلين عمداً. يأتي line_type من الفحص المحلي المجاني دائماً (التعداد الخاص بهذا الفحص، مثل MOBILE وFIXED_LINE وPREMIUM_RATE). يظهر phone_type فقط عندما يكون source هو "premium"، ويستخدم فئات مزوّد البحث عن مشغلي الشبكات الخاصة به: mobile وfixed_line وvoip وtoll_free وpremium_rate وshared_cost وpersonal_number وpager وuan وvoicemail أو unknown. تستحق premium_rate انتباهاً خاصاً إن كنت تستخدم هذا لإشارات الاحتيال — فالأرقام ذات المعدل المرتفع (premium-rate)، والتي تُفوتَر بسعر أعلى للدقيقة من الخط العادي، هي وسيلة شائعة لاحتيال تقاسم الإيرادات الدولي (IRSF)، وتُظهر نقطة النهاية هذه هذا التصنيف مباشرةً بدلاً من الاكتفاء برصد VoIP فقط.

فقط عندما يتم تشغيل بحث متقدم فعلياً (أي أن ميزانيتك الشهرية من السؤال السابق لم تُستنفد) — لا يغادر الفحص المحلي المجاني أبداً خوادم Cloudflare Workers الخاصة بـ ipto.to نفسها. عندما يتم تشغيل بحث متقدم، يُرسل الرقم إلى مزوّد البحث عن مشغلي الشبكات لدينا فقط للرد على ذلك الطلب الواحد؛ لا نُخزّن مفتاح API الخاص بالمزوّد في أي مكان يمكن الوصول إليه علنياً، ووفقاً لسياسة التسجيل القياسية لـ ipto.to (راجع حول)، لا نُسجّل نحن أيضاً سجل الاستعلامات.

كل يوم عند 00:00 بالتوقيت العالمي المنسّق (UTC). الطلب الذي يتجاوز الحد يعيد HTTP 429 مع ترويسة Retry-After وحقل retry_after_seconds يوضّح بالضبط المدة المتبقية حتى إعادة الضبط.

استدعِ POST /v1/keys للحصول فوراً على مفتاح الباقة المجانية، أو سجّل الدخول — فتسجيل الدخول ينشئ حساباً في الباقة المجانية تلقائياً ويعرض مفتاحك واستهلاكك في لوحة التحكم. أما Pro وEnterprise فترقيتهما من صفحة الأسعار.

في الترويسة X-API-Key (مفضّل لأن سلاسل الاستعلام قد تظهر في السجلات) أو بصيغة ?api_key= في عنوان URL. تُحتسب الطلبات التي تحمل مفتاحاً على حصة هذا المفتاح لا على حصة عنوان IP الخاص بك. ويمكنك مراجعة استهلاك مفتاح عبر GET /v1/keys/usage?key=X.

في الغالب. فالبحث من شريط البحث أو استدعاء أداة MCP يُحتسب طلباً واحداً حتى لو تفرّع إلى عدة فحوص على الخادم. أما الاستدعاءات بالجملة فتُحتسب لكل عنصر — كل IP في POST /v1/ip/bulk وكل رقم في استعلام هاتفي بالجملة يُحتسب منفصلاً. وللأماكن القريبة والاستعلامات الهاتفية المميّزة حصص مستقلة خاصة بها فوق الحصة العامة.

لا. لا يسجّل ipto عناوين IP التي تبحث عنها، ولا يحتفظ بسجل الاستعلامات، ولا ينشئ ملفات تعريف؛ تُحفظ فقط أعداد الطلبات المجمّعة لأغراض تخطيط السعة. وسجل البحث والاستعلامات المميّزة بنجمة في الصفحة الرئيسية يبقيان في متصفحك وحده. التفاصيل في صفحة الخصوصية.

نعم. الواجهة تدعم CORS، ومُصدَّرة تحت /v1/، وتعيد JSON مستقراً. الباقة المجانية مخصّصة للأفراد والاستخدام الخفيف (1,000 طلب/يوم)؛ أما لحركة الإنتاج فاستخدم مفتاح Pro (100,000/يوم) أو Enterprise (غير محدود مع اتفاقية SLA مخصّصة). راجع الأسعار وصفحة الحالة لمعرفة الحالة المباشرة.