POST AI agent ready /v1/nationality/estimate

واجهة برمجة تطبيقات توقع الجنسية - تقدير بلد المنشأ من الاسم

تقدير البلدان الأصلية الأكثر احتمالاً لاسم معين باستخدام النماذج الإحصائية المدربة على البيانات الديموغرافية العالمية. إرجاع مجموعة من البلدان مرتبة حسب الاحتمالية برموز ISO 3166-1 alpha-2. مفيد للتوطين والتحليل الديموغرافي والتدويل.

Endpoint

Code examples

curl -X POST https://api.botoi.com/v1/nationality/estimate \
  -H "Content-Type: application/json" \
  -d '{"name":"Tanaka"}'

When to use this API

التحديد التلقائي للغة واللغة

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

أبحاث السوق وتحليل الجمهور

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

الفحص المسبق لـ KYC والتحقق من الهوية

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

Frequently asked questions

هل يمكنني استخدام الأسماء الأولى أو أسماء العائلة أو الأسماء الكاملة؟

تعمل نقطة النهاية مع أي إدخال اسم. غالبًا ما تنتج الأسماء الأخيرة (الألقاب) إشارات جنسية أكثر تميزًا من الأسماء الأولى. يمكنك تمرير الاسم الأول أو اسم العائلة أو الاسم الكامل، على الرغم من أن مدخلات الرمز الفردي (اسم واحد في كل مرة) تميل إلى أن تكون أكثر دقة.

ماذا تعني درجة الاحتمال؟

لدى كل دولة في الرد احتمال يتراوح بين 0 و1 يمثل احتمالية أن يكون الشخص الذي يحمل هذا الاسم من تلك الدولة. احتمال 0.85 لـ JP يعني أن 85% من الأشخاص الذين يحملون هذا الاسم في مجموعة البيانات هم من اليابان.

كم عدد الدول التي تم إرجاعها؟

تتضمن الاستجابة ما يصل إلى 5 دول مرتبة حسب الاحتمالية. يتم تضمين فقط البلدان ذات الاحتمالية غير الضئيلة (أعلى من 0.01 تقريبًا). الأسماء المرتبطة بقوة ببلد واحد قد تعرض نتائج أقل.

لماذا يظهر "تاناكا" البرازيل كمباراة ثانوية؟

البرازيل لديها أكبر الشتات الياباني خارج اليابان. تظهر أسماء مثل "تاناكا" في السجلات البرازيلية بسبب الهجرة اليابانية في أوائل القرن العشرين. يعكس النموذج توزيعات الأسماء الحقيقية عبر البلدان.

هل تم تطبيع الاسم قبل المعالجة؟

نعم. الأسماء صغيرة ومقتطعة من المسافات البيضاء. يتم الحفاظ على علامات التشكيل وتساهم في التنبؤ، حيث أن الأحرف المميزة تحمل إشارات الجنسية (على سبيل المثال، "مولر" مقابل "مولر").

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.